Member

Description

nSize

Size of this structure.

dwMask

Flags that indicate which structure members contain valid information. Possible values are:

Value

Meaning

PFF_ALL

All the fields contain valid data.

PFF_STYLE

The nStyle field contains valid data.

PFF_SOLIDFILLCOLOR

The crSolidFillColor field contains valid data.

PFF_BACKGROUNDTILEBITMAP

The pBackgroundTileBitmap field contains valid data.

PFF_GRADIENTSTYLE

The nGradientStyle field contains valid data.

PFF_GRADIENTSTARTCOLOR

The crGradientStartColor field contains valid data.

PFF_GRADIENTENDCOLOR

The crGradientEndColor field contains valid data.

PFF_GRADIENTSTEPS

The uGradientSteps field contains valid data.

PFF_UPPERTOLERANCE

The crUpperTolerance field contains valid data.

PFF_LOWERTOLERANCE

The crLowerTolerance field contains valid data.

PFF_OPACITY

The nOpacity field contains valid data.

PFF_TEXTURE

The pTexture field contains valid data.

The values can be combined using the bit-wise OR operator ( | )

nStyle

An enumerated type that indicates the fill style. For a list of possible values, refer to PAINTFILLSTYLE.

crSolidFillColor

COLORREF value that specifies the color to use when nStyle is PAINT_FILL_STYLE_SOLID.

pBackgroundTileBitmap

Pointer to the bitmap handle referencing the bitmap to be used for filling, when nStyle is PAINT_FILL_STYLE_TILEDIMAGE. The BITMAPHANDLE pointer, should still be valid after setting this field.

nGradientStyle

An enumerated type that indicates the background gradient fill style. For a list of possible values, refer to PAINTFILLGRADIENTSTYLE.

crGradientStartColor

The COLORREF value that specifies the color to use as the starting color for the gradient fill.

crGradientEndColor

The COLORREF value that specifies the color to use as the ending color for the gradient fill.

uGradientSteps

Number of gradient fill steps. Valid values are 2 to 255.

crUpperTolerance

COLORREF value that contains the amount of upper variance allowed from the selected color. Valid values are between 0 and 255.

crLowerTolerance

COLORREF value that contains the amount of lower variance allowed from the selected color. Valid values are between 0 and 255.

nOpacity

Value indicating the transparency of the fill when combined with the painting canvas. Valid values are 0 to 255. A color or an image with an opacity of 255 is transparent. A color or an image with an opacity of 0 is completely opaque (solid).

pTexture

Pointer to the bitmap handle referencing the bitmap that will simulate paper texture. This gives the appearance of painting on paper having that texture. The BITMAPHANDLE pointer, should still be valid after setting this field.