SHAPEDLGPARAMS

Summary

The SHAPEDLGPARAMS structure provides information used to initialize the dialog box created by the LDialogEffect::DoModalGetShape function. After the user closes the dialog box, this structure is updated with information about the user's selections.

Syntax

typedef struct _SHAPEDLGPARAMS 
{ 
   L_UINT uStructSize; 
   pBITMAPHANDLE pBitmap; 
   pBITMAPHANDLE pBackgroundBitmap; 
   L_UINT uShape; 
   COLORREF crBack; 
   L_UINT uBackStyle; 
   COLORREF crFill; 
   L_UINT uFillStyle; 
   COLORREF crBorder; 
   L_UINT uBorderStyle; 
   L_UINT uBorderWidth; 
   COLORREF crInnerHilite; 
   COLORREF crInnerShadow; 
   L_UINT uInnerStyle; 
   L_UINT uInnerWidth; 
   COLORREF crOuterHilite; 
   COLORREF crOuterShadow; 
   L_UINT uOuterStyle; 
   L_UINT uOuterWidth; 
   L_INT nShadowX; 
   L_INT nShadowY; 
   COLORREF crShadow; 
   L_UINT32 uDlgFlags; 
   LTCOMMDLGHELPCB pfnHelpCallback; 
   L_VOID  *pHelpCallBackUserData; 
} SHAPEDLGPARAMS,  * LPSHAPEDLGPARAMS; 

Members

uStructSize

Size of this structure, in bytes. Use the sizeof operator to calculate this value.

pBitmap

Pointer to the bitmap handle that references the 1-bit bitmap used for preview or processing.

pBackgroundBitmap

Pointer to the bitmap to be used for the background of the shape. This bitmap will be updated if the user chooses a new image using the Browse Image button. If you pass NULL, the "Tiled Image" and "Translucent Tiled Image" options will not appear in the BackStyle combo-box. The caller is responsible for freeing this bitmap when it is no longer needed.

uShape

The shape to use.

crBack

The background color. You can specify a COLORREF value, such as the return value of the Windows RGB macro, or you can use the PALETTEINDEX macro to specify a palette color.

uBackStyle

The background style.

crFill

The foreground color. You can specify a COLORREF value, such as the return value of the Windows RGB macro, or you can use the PALETTEINDEX macro to specify a palette color.

uFillStyle

The foreground style.

crBorder

The border color. You can specify a COLORREF value, such as the return value of the Windows RGB macro, or you can use the PALETTEINDEX macro to specify a palette color.

uBorderStyle

The border style.

uBorderWidth

The border width.

crInnerHilite

The inner band hilite color. You can specify a COLORREF value, such as the return value of the Windows RGB macro, or you can use the PALETTEINDEX macro to specify a palette color.

crInnerShadow

The inner band shadow color. You can specify a COLORREF value, such as the return value of the Windows RGB macro, or you can use the PALETTEINDEX macro to specify a palette color.

uInnerStyle

Inner band style. The inner band is available only for squares and rectangles. Possible values are:

uInnerWidth

The inner band width.

crOuterHilite

The outer band hilite color. You can specify a COLORREF value, such as the return value of the Windows RGB macro, or you can use the PALETTEINDEX macro to specify a palette color.

crOuterShadow

The outer band shadow color.

uOuterStyle

Outer band style. Possible values are:

uOuterWidth

The outer band width.

nShadowX

The horizontal position of the shadow.

nShadowY

The vertical position of the shadow.

crShadow

The shadow color. You can specify a COLORREF value, such as the return value of the Windows RGB macro, or you can use the PALETTEINDEX macro to specify a palette color.

uDlgFlags

User interface flags for this dialog, which determine the layout and action of the dialog. Possible values are:

pfnHelpCallback

Ignored.

pHelpCallBackUserData

Ignored.

Usage

• LDialogEffect::GetShapeParams
• LDialogEffect::SetShapeParams
• LPaintEffect::GetShapeParameters
• LPaintEffect::LPaintEffect
• LPaintEffect::SetShapeParameters