PAINTDLGFILLINFO
typedef struct _PAINTDLGFILLINFO
{
L_INT nSize;
L_INT32 dwFlags;
L_TCHAR * pszTitle;
PAINTFILLSTYLE nStyle;
COLORREF crSolidFillColor;
L_TCHAR ** ppszBackgroundTileBitmap;
L_UINT uBackgroundTileBitmapCount;
L_INT nActiveBackgroundTileBitmapItem;
PAINTFILLGRADIENTSTYLE nGradientStyle;
COLORREF crGradientStartColor;
COLORREF crGradientEndColor;
L_UINT uGradientSteps;
COLORREF crUpperTolerance;
COLORREF crLowerTolerance;
L_INT nOpacity;
L_TCHAR ** ppszPaperTexture;
L_UINT uPaperTextureCount;
L_INT nActivePaperTextureItem;
} PAINTDLGFILLINFO, *pPAINTDLGFILLINFO ;
The PAINTDLGFILLINFO structure contains information about the fill properties dialog.
Member |
Description |
|
nSize |
Size of this structure. |
|
dwFlags |
User interface flags for the dialog. Determines the layout and action of the dialog. Possible values are: |
|
|
Setting |
Description |
|
PAINT_DLG_FILL_SHOWALL |
[0x00000001] Show All controls. |
|
PAINT_DLG_FILL_SHOWSTYLE |
[0x00000002] Show Style control. |
|
PAINT_DLG_FILL_SHOWSOLIDFILLCOLOR |
[0x00000004] Show Solid fill color control. |
|
PAINT_DLG_FILL_SHOWBKGRNDTILE |
[0x00000008] Show Background tile control. |
|
PAINT_DLG_FILL_SHOWGRADIENTSTYLE |
[0x00000010] Show Gradient style control. |
|
PAINT_DLG_FILL_SHOWGRADIENTDIRECTION |
[0x00000020] Show Gradient direction control. |
|
PAINT_DLG_FILL_SHOWGRADIENTPREVIEW |
[0x00000040] Show Gradient preview control. |
|
PAINT_DLG_FILL_SHOWGRADIENTSTARTCOLOR |
[0x00000080] Show Gradient start color control. |
|
PAINT_DLG_FILL_SHOWGRADIENTENDCOLOR |
[0x00000100] Show Gradient end color control. |
|
PAINT_DLG_FILL_SHOWGRADIENTSTEPS |
[0x00000200] Show Gradient steps control. |
|
PAINT_DLG_FILL_SHOWLOWERTOLERANCE |
[0x00000400] Show Lower tolerance control. |
|
PAINT_DLG_FILL_SHOWUPPERTOLERANCE |
[0x00000800] Show Upper tolerance control. |
|
PAINT_DLG_FILL_SHOWOPACITY |
[0x00001000] Show Opacity control. |
|
PAINT_DLG_FILL_SHOWTEXTURE |
[0x00002000] Show Paper texture control. |
|
PAINT_DLG_FILL_SHOWDEFAULT |
[0x00004000] Show Default control. |
|
PAINT_DLG_FILL_INITUSEDEFAULT |
[0x00008000] Use the initial default values for the dialog control. |
pszTitle |
Character string containing the Dialog box caption text. |
|
nStyle |
An enumerated type indicating the fill style. For a list of possible values, refer to PAINTFILLSTYLE. |
|
crSolidFillColor |
COLORREF value containing the fill color to use when nStyle is PAINT_FILL_STYLE_SOLID. |
|
ppszBackgroundTileBitmap |
Array of strings containing the names of the images used to fill the background tile bitmap combo box. |
|
uBackgroundTileBitmapCount |
Number of strings in ppszBackgroundTileBitmap. |
|
nActiveBackgroundTileBitmapItem |
Index of the image currently selected in the background tile combo box. This is a zero-based index. |
|
nGradientStyle |
An enumerated type that represents the background gradient fill style. For a list of possible values, refer to PAINTFILLGRADIENTSTYLE. |
|
crGradientStartColor |
COLORREF value that specifies the color that will start the background gradient fill. |
|
crGradientEndColor |
COLORREF value that specifies the color that will end the background gradient fill. |
|
uGradientSteps |
Number of gradient fill steps. Valid values are between 2 and 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). |
|
ppszPaperTexture |
Array of strings containing the names of the images used to fill the paper texture combo box. |
|
uPaperTextureCount |
Number of strings in ppszPaperTexture. |
|
nActivePaperTextureItem |
Index of the currently selected image in the paper texture combo box. This is a zero-based index. |
Comments
An image of the Fill dialog can be seen below.
When the uBackgroundTileBitmapCount field value is set to 0 or when the ppszBackgroundTileBitmap field value is set to NULL, the structure members shown below will automatically be set to the following values:
ppszBackgroundTileBitmap = NULL
uBackgroundTileBitmapCount = 0
nActiveBackgroundTileBitmapItem = -1
The nActivePaperTextureItem field value will be –1 when the user selects "none" from the paper texture combo box.
When the value of the nActivePaperTextureItem is set to –1, the current selection in the paper texture combo box will be "none".
When the user presses the default button, the dialog box will reset to the default values, for all fields, except nActiveBackgroundTileBitmapItem. The nActivebackgroundTileBitmapItem will be the value it was before the last call to the Dialog box.