WinDrawBitmap - Parameters

hpsDst (HPS) - input

Handle of presentation space in which the bit map is drawn.

hbm (HBITMAP) - input

Bit-map handle.

pwrcSrc (PRECTL) - input

Subrectangle of bit map to be drawn.

Note: The value of each field in this structure must be in the range -32 768 through The data type WRECT can also be used, if supported by the language.

NULL

The whole of the bit map is drawn
Other
The whole of the bit map is not drawn.

pptlDst (PPOINTL) - input

Bit-map destination.

The bottom left corner of the bit-map destination is specified in device coordinates.

If DBM_STRETCH is set in fl, this parameter is used as a pointer to a RECTL data structure that contains the coordinates of the rectangle into which the source bit map is to be drawn. In this situation, pptlDst should be treated as a PRECTL datatype.

clrFore (LONG) - input

Foreground color.

This is used if hbm refers to a monochrome bit map. In this instance, bit-map bits that are set to 1 are drawn using clrFore. Ignored if DBM_IMAGEATTRS is specified.

clrBack (LONG) - input

Background color.

This is used if hbm refers to a monochrome bit map. In this instance, bit-map bits that are set to zero are drawn using clrBack. Ignored if DBM_IMAGEATTRS is specified.

fl (ULONG) - input

Flags that determine how the bit map is drawn.

DBM_NORMAL

Draw the bit map normally using ROP_SRCCOPY, as defined in GpiBitBlt.
DBM_INVERT
Draw the bit map inverted using ROP_NOTSRCCOPY, as defined in GpiBitBlt.
DBM_STRETCH
pptlDst is used to point to a RECTL data structure representing a rectangle in the destination presentation space, into which the bit map will be stretched or compressed. If compression is required, some rows and columns of the bit map are eliminated.
DBM_HALFTONE
Use the OR operator to combine the bit map with an alternating pattern of ones or zeros before drawing it. It can be used with either DBM_NORMAL or DBM_INVERT.
DBM_IMAGEATTRS
If this is specified, color conversion of monochrome bit maps is done by using the image attributes.

rc (BOOL) - returns

Success indicator.

TRUE

Successful completion
FALSE
Error occurred.

---

[Back: WinDrawBitmap Return Value - rc]
[Next: WinDrawBitmap - Remarks]