typedef struct _PAINTFILL
{
L_INT nSize;
L_UINT32 dwMask;
PAINTFILLSTYLE nStyle;
COLORREF crSolidFillColor;
pBITMAPHANDLE pBackgroundTileBitmap;
PAINTFILLGRADIENTSTYLE nGradientStyle;
COLORREF crGradientStartColor;
COLORREF crGradientEndColor;
L_UINT uGradientSteps;
COLORREF crUpperTolerance;
COLORREF crLowerTolerance;
L_INT nOpacity;
pBITMAPHANDLE pTexture;
} PAINTFILL, *pPAINTFILL;
The PAINTFILL structure holds information used to fill an area.
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. | |
The default values for this structure are:
nSize = sizeof (PAINTFILL)
nStyle = PAINT\_FILL\_STYLE\_SOLID
crSolidFillColor = RGB (255, 255, 255)
pBackgroundTileBitmap = NULL
nGradientStyle = PAINT\_FILL\_GRADIENT\_STYLE\_RECTANGLE\_TO\_C
nGradientStartColor = RGB (0, 0, 0)
nGradientEndColor = RGB (255, 255, 255)
uGradientSteps = 255
crUpperTolerance = RGB (0, 0, 0)
crLowerTolerance = RGB (0, 0, 0)
nOpacity = 0
pTexture = NULL
pPAINTFILL is a pointer to a PAINTFILL structure.