Draws the specified screen cache to the specified window device context. Pass an empty rectangle to copy the full bitmap to the DC origin.

[Visual Basic 6.0]
Sub DrawCache(
    ByVal hDC As OLE_HANDLE, _
    ByVal index As Integer, _
    deviceRect As tagRECT, _
    cacheRect As tagRECT _
)

[Visual Basic .NET]
Public Sub DrawCache ( _
    ByVal hDC As Integer, _
    ByVal index As Short, _
    ByRef deviceRect As tagRECT, _
    ByRef cacheRect As tagRECT _
)

[C#]
public void DrawCache (
    int hDC,
    short index,
    ref tagRECT deviceRect,
    ref tagRECT cacheRect
);

[Java]
public void drawCache (
    int hDC,
    short index,
    tagRECT deviceRect,
    tagRECT cacheRect
)
throws
    IOException,
    AutomationException

[C++]
HRESULT DrawCache(
  OLE_HANDLE hDC,
  short index,
  tagRECT* deviceRect,
  tagRECT* cacheRect
);

Product Availability

Remarks

Redrawing data from scratch is time consuming compared to drawing data that has been cached in an off-screen bitmap.  If a particular cache return FALSE for IsCacheDirty, use DrawCache to instantly redraw the bitmap. 

Use the CacheMemDC property to get the desired cache's hDC.

See Also

Send feedback on this page