PAINTDLGTEXTINFO

typedef struct _PAINTDLGTEXTINFO
{
   L_INT nSize;
   L_INT32 dwFlags;
   L_TCHAR * pszTitle;
   L_TCHAR * pszText;
   LOGFONT logFont; 
   PAINTTEXTBORDERBRUSHSTYLE nBorderBrushStyle; 
   L_INT nBorderWidth; 
   COLORREF crBorderColor;
   PAINTTEXTBACKSTYLE nBackgroundStyle;
   COLORREF crBackgroundColor; 
   L_TCHAR ** ppszBackgroundTileBitmap;
   L_UINT uBackgroundTileBitmapCount;
   L_INT nActiveBackgroundTileBitmapItem;
   PAINTALIGNMENT nAlignment; 
   L_INT nOpacity; 
   L_TCHAR ** ppszPaperTexture;
   L_UINT uPaperTextureCount;
   L_INT nActivePaperTextureItem;
   PAINTTRANSFORM TransformInfo;

} PAINTDLGTEXTINFO, L_FAR *pPAINTDLGTEXTINFO;

The PAINTDLGTEXTINFO structure contains information about the Text 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_TEXT_SHOWALL

[0x00000001] show all controls

 

PAINT_DLG_TEXT_SHOWTEXT

[0x00000002] show Text control

 

PAINT_DLG_TEXT_SHOWBKGRNDSTYLE

[0x00000004] show Background style control

 

PAINT_DLG_TEXT_SHOWBKGRNDOPAQUECOLOR

[0x00000008] show Background Opaque color control

 

PAINT_DLG_TEXT_SHOWBKGRNDTILE

[0x00000010] show Background tile control

 

PAINT_DLG_TEXT_SHOWBORDERSTYLE

[0x00000020] show Border style control

 

PAINT_DLG_TEXT_SHOWBORDERWIDTH

[0x00000040] show border width control

 

PAINT_DLG_TEXT_SHOWBORDERCOLOR

[0x00000080] show Border color control

 

PAINT_DLG_TEXT_SHOWHORZALIGNMENT

[0x00000100] show Horizontal Alignment control

 

PAINT_DLG_TEXT_SHOWVERTALIGNMENT

[0x00000200] show Vertical Alignment control

 

PAINT_DLG_TEXT_SHOWROTATE

[0x00000400] show Rotate control

 

PAINT_DLG_TEXT_SHOWSCALE

[0x00000800] show Scale control

 

PAINT_DLG_TEXT_SHOWTRUETYPEFONT

[0x00001000] show True type font control

 

PAINT_DLG_TEXT_SHOWOPACITY

[0x00002000] show Opacity control

 

PAINT_DLG_TEXT_SHOWTEXTURE

[0x00004000] show Paper texture control

 

PAINT_DLG_TEXT_SHOWDEFAULT

[0x00008000] show Default control

 

PAINT_DLG_TEXT_INITUSEDEFAULT

[0x00010000] use the initial default values for the dialog control

pszTitle

Character string containing the Dialog box caption text.

pszText

Character string containing the text string to be drawn. The toolkit will copy this string to its internal data.

logFont

Handle to the font used to paint the text. This font should be a true type font. The toolkit will not copy this handle. Therefore, this font handle should still valid after setting this field.

nBorderBrushStyle

An enumerated type that indicates the text border (outline) style. For a list of possible values, refer to PAINTTEXTBORDERBRUSHSTYLE.

nBorderWidth

Value indicating the width of the text border, in pixels. Valid values are 1 to 100.

crBorderColor

COLORREF value that contains the text border (outline) color.

nBackgroundStyle

An enumerated type that indicates the text background style. For a list of possible values, refer to PAINTTEXTBACKSTYLE.

crBackgroundColor

COLORREF value that contains the text background color.

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 currently selected image in the background tile combo box.

nAlignment

An enumerated type that indicates text alignment. For a list of possible values, refer to PAINTALIGNMENT.

nOpacity

Value that indicates the transparency of the text 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.

TransformInfo

Structure that contains information used to transform the text output.

 

The nRotate structure field of TransformInfo will effect the text output result only when the nAlignment field is: (PAINT_ALIGNMENT_HCENTER | PAINT_ALIGNMENT_VCENTER )

 

Otherwise, the toolkit will consider nRotate to be 0.

Comments

An image of the Text dialog can be seen below.

 

image\a6.gif

 

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 field will be the value it was before the last call to the Dialog box.