PAINTDLGBRUSHINFO

Summary

The PAINTDLGBRUSHINFO structure contains information about the paintbrush properties dialog.

Syntax

typedef struct _PAINTDLGBRUSHINFO 
{ 
   L_INT nSize; 
   L_INT32 dwFlags; 
   L_TCHAR *pszTitle; 
   PAINTTOUCHCONTENTS nContentsType; 
   COLORREF crColor; 
   L_TCHAR ** ppszTouchImage; 
   L_UINT uTouchImageCount; 
   L_INT nActiveTouchImageItem; 
   COLORREF crTransparentColor; 
   L_INT nDiameter; 
   L_INT nHardnessValue; 
   L_INT nSpacing; 
   L_INT nDensity; 
   L_INT nOpacity; 
   L_INT nFadeOutRate; 
   L_TCHAR ** ppszPaperTexture; 
   L_UINT uPaperTextureCount; 
   L_INT nActivePaperTextureItem; 
    
} PAINTDLGBRUSHINFO, *pPAINTDLGBRUSHINFO; 

Members

nSize

Size of this structure.

dwFlags

User interface flags for dialog. Determines the layout and action of the dialog. Possible values are:

pszTitle

Character string containing the dialog box caption text.

nContentsType

An enumeration type that represents the contents of the paintbrush . For a list of possible values, refer to PAINTTOUCHCONTENTS.

crColor

COLORREF value that specifies the paintbrush color when the nContentsType is PAINT_TOUCH_CONTENTS_COLOR.

ppszTouchImage

Array of strings containing the names of the images used to fill the touch image combo box.

uTouchImageCount

Number of strings used to fill the touch image combo box.

nActiveTouchImageItem

Index to the current image selected in the touch image combo box. This is a zero-based index.

crTransparentColor

This value represents the transparent color of the paintbrush image.

nDiameter

Value indicating the size of the brush in pixels. Valid values are between 1 and 200.

nHardnessValue

Value indicating the hardness of the brush. Valid values are between 1 and 100.

nSpacing

Value indicating how often the paintbrush tip touches the surface during a paint stroke. When the spacing is 30 this means that the brush tip will touch the painting surface once every 30 pixels. Valid values are between 1 and 1000.

nDensity

Value indicating the amount of paint the brush applies with each stroke. Increasing the density of the brush is comparable to increasing the number of bristles in the brush. With more bristles, more paint is applied in a stroke. Similarly, decreasing the density decreases the number of bristles in the brush. With fewer bristles, less paint is applied in a stroke. Valid values are 1 to 100 and represent a percentage. A value of 100% results in the surface being completely covered with paint. A value of 1% results in very little paint being applied to the surface.

nOpacity

Value indicating the transparency of the brush touch when combined with the painting canvas. Valid values are between 0 and 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).

nFadeOutRate

Value indicating the rate at which the brush contents will fade (become more transparent). Valid values are between 0 and 10000. 0 means no fadeout will occur. Other values (1-10000) will increase transparency every nSpacing pixels until total transparency is reached.

ppszPaperTexture

Array of strings containing the names of the images used to fill the paper texture combo box.

uPaperTextureCount

Number of strings in the paper texture array.

nActivePaperTextureItem

Index of the current image selected in the paper texture combo box. This is a zero-based index.

Comments

The image below shows the paintbrush properties dialog:

When the uTouchImageCount field value is 0 or when the ppszTouchImage field value is NULL the toolkit will return the following values:

ppszTouchImage           = NULL    
uTouchImageCount       = 0    
nActiveTouchImageItem = -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 nActiveTouchImageItem. The nActiveTouchImageItem value will be the value it was before the last call to the Dialog box.

Usage

• LRasterDialog::DoModalBrush