CUSTOMIZEPALETTEDLGPARAMS

Summary

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

Syntax

typedef struct _CUSTOMIZEPALETTEDLGPARAMS 
{ 
   L_UINT uStructSize; 
   HPALETTE hpalUser; 
   HPALETTE hpalGenerated; 
   L_BOOL bApplyPaletteWhenExit; 
   L_UINT32 uDlgFlags; 
   LTCOMMDLGHELPCB pfnHelpCallback; 
   L_VOID *pHelpCallBackUserData; 
} CUSTOMIZEPALETTEDLGPARAMS,* LPCUSTOMIZEPALETTEDLGPARAMS; 

Members

uStructSize

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

hpalUser

A handle to a palette that can be used to initialize the custom palette entry in the palette options list. You can pass NULL in this parameter to remove the custom palette entry from the palette options list.

hpalGenerated

Handle to a palette. If either DLG_CUSTOMIZEPALETTE_GENERATE_PALETTE or DLG_CUSTOMIZEPALETTE_SHOW_APPLYPALETTEWHENEXIT is set in the uDlgFlags member, this variable will receive a palette handle that contains the palette displayed in the right pane when the dialog is closed. Notice that it is your responsibility to free the palette handle using the windows DeleteObject function.

bApplyPaletteWhenExit

Flag that indicates whether the "Apply When Exit" check box is checked. If this member is set before calling L_DlgCustomizePalette, this value will be used to initialize the check box. Possible values are:

uDlgFlags

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

pfnHelpCallback

Pointer to an optional help callback function. If you do not wish to provide help to this dialog, use NULL as the value of this parameter. To provide help to this dialog, use the function pointer as the value of this parameter. The callback function must adhere to the prototype described in LTCOMMDLGHELPCB.

pHelpCallBackUserData

Void pointer that you can use to pass one or more additional parameters that the callback function needs. To use this feature, assign a value to a variable or create a structure that contains as many fields as you need. Then, in this parameter, pass the address of the variable or structure, casting it to L_VOID *. The callback function, which receives the address in its own pHelpCallBackUserData parameter, can cast it to a pointer of the appropriate data type to access your variable or structure. If the additional parameters are not needed, you can pass NULL in this parameter.

Usage

• L_DlgCustomizePalette