Export (0) Print
Expand All
EMR
Expand Minimize

EMRGRADIENTFILL structure

The EMRGRADIENTFILL structure contains members for the GradientFill enhanced metafile record.

Syntax


typedef struct tagEMRGRADIENTFILL {
  EMR       emr;
  RECTL     rclBounds;
  DWORD     nVer;
  DWORD     nTri;
  ULONG     ulMode;
  TRIVERTEX Ver[1];
} EMRGRADIENTFILL, *PEMRGRADIENTFILL;

Members

emr

The base structure for all record types.

rclBounds

The bounding rectangle, in device units.

nVer

The number of vertices.

nTri

The number of rectangles or triangles to be passed to GradientFill.

ulMode

The gradient fill mode. This member can be one of the following values.

ValueMeaning
GRADIENT_FILL_RECT_H

In this mode, two endpoints describe a rectangle. The rectangle is defined to have a constant color (specified by the TRIVERTEX structure) for the left and right edges. GDI interpolates the color from the left to right edge and fills the interior.

GRADIENT_FILL_RECT_V

In this mode, two endpoints describe a rectangle. The rectangle is defined to have a constant color (specified by the TRIVERTEX structure) for the top and bottom edges. GDI interpolates the color from the top to bottom edge and fills the interior.

GRADIENT_FILL_TRIANGLE

In this mode, an array of TRIVERTEX structures is passed to GDI along with a list of array indexes that describe separate triangles. GDI performs linear interpolation between triangle vertices and fills the interior. Drawing is done directly in 24- and 32-bpp modes. Dithering is performed in 16-, 8-, 4-, and 1-bpp mode.

 

Ver

An array of TRIVERTEX structures that each define a vertex.

Remarks

This is a variable-length structure. The Ver member designates the beginning of the variable-length area. First comes an array of nVer TRIVERTEX structures to pass the vertices. Next comes an array of either nTri GRADIENT_TRIANGLE structures or nTri GRADIENT_RECT structures, depending on the value of ulMode (triangles or rectangles).

This structure is to be used during metafile playback.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h (include Windows.h)

See also

Metafiles Overview
Metafile Structures
Metafiles
BITMAPINFO
EMR
GradientFill
GRADIENT_TRIANGLE
GRADIENT_RECT

 

 

Community Additions

ADD
Show:
© 2014 Microsoft