Description
Draws
the image stored in a CachedBitmap object.
Syntax
GpStatus WINGDIPAPI GdipDrawCachedBitmap(
GpGraphics *graphics,
GpCachedBitmap *cachedBitmap,
INT x,
INT y
);
PowerBASIC Syntax
DECLARE FUNCTION GdipDrawCachedBitmap ( _
BYVAL graphics AS DWORD, _
BYVAL cachedBitmap AS DWORD, _
BYVAL x AS LONG, _
BYVAL y AS LONG _
) AS LONG
Parameters
graphics
[in] Pointer
to a Graphics object.
cachedBitmap
[in] Pointer
to a CachedBitmap object that contains the image to be drawn.
x
[in] Long
integer value that specifies the x-coordinate of the upper-left corner of the
image.
y
[in] Long
integer value that specifies the y-coordinate of the upper-left corner of the
image.
Remarks
A CachedBitmap
object stores an image in a format that is optimized for a particular display
screen. You cannot draw a cached bitmap to a printer or to a metafile.
Cached
bitmaps will not work with any transformations other than translation.
When you
construct a CachedBitmap object, you must pass the address of a Graphics
object to the GdipCreateCachedBitmap function. If the screen associated
with that Graphics object has its bit depth changed after the cached
bitmap is constructed, then the GdipDrawCachedBitmap function will fail,
and you should reconstruct the cached bitmap. Alternatively, you can hook the
display change notification message and reconstruct the cached bitmap at that
time.
|