EMRSTRETCHBLT

[This is preliminary documentation and subject to change.]

The EMRSTRETCHBLT structure contains members for the StretchBlt enhanced metafile record. Note that graphics device interface (GDI) converts the device-dependent bitmap into a device-independent bitmap (DIB) before storing it in the metafile record.

typedef struct tagEMRSTRETCHBLT
{
    EMR      emr; 
    RECTL    rclBounds; 
    LONG     xDest; 
    LONG     yDest; 
    LONG     cxDest; 
    LONG     cyDest; 
    DWORD    dwRop; 
    LONG     xSrc; 
    LONG     ySrc; 
    XFORM    xformSrc; 
    COLORREF crBkColorSrc; 
    DWORD    iUsageSrc; 
    DWORD    offBmiSrc; 
    DWORD    cbBmiSrc; 
    DWORD    offBitsSrc; 
    DWORD    cbBitsSrc; 
    LONG     cxSrc; 
    LONG     cySrc; 
} EMRSTRETCHBLT, *PEMRSTRETCHBLT; 
 

Members

emr

Base structure for all record types.

rclBounds

Bounding rectangle, in device units.

xDest

Logical x-coordinate of the upper-left corner of the destination rectangle.

yDest

Logical y-coordinate of the upper-left corner of the destination rectangle.

cxDest

Logical width of destination rectangle

cyDest

Logical height of destination rectangle

dwRop

Raster-operation code. These codes define how the color data of the source rectangle is to be combined with the color data of the destination rectangle to achieve the final color.

xSrc

Logical x-coordinate of the upper-left corner of the source rectangle.

ySrc

Logical y-coordinate of the upper-left corner of the source rectangle.

xformSrc

World-space to page-space transformation of the source device context.

crBkColorSrc

Background color (the RGB value) of the source device context.

iUsageSrc

Value of the bmiColors member of the BITMAPINFO structure. The iUsageSrc member can be either the DIB_PAL_COLORS, DIB_PAL_INDICES, or DIB_RGB_COLORS value.

offBmiSrc

Offset to source BITMAPINFO structure.

cbBmiSrc

Size of source BITMAPINFO structure.

offBitsSrc

Offset to source bitmap bits.

cbBitsSrc

Size of source bitmap bits.

cxSrc

Width of source rectangle.

cySrc

Height of source rectangle.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in wingdi.h.

See Also

Metafiles Overview, Enhanced Metafile Structures, BITMAPINFO, RGB, StretchBlt