HOLEPUNCHREMOVEDLGPARAMS

typedef struct _HOLEPUNCHREMOVEDLGPARAMS
{
   L_UINT uStructSize;
   pBITMAPHANDLE pBitmap;
   L_BOOL bZoomToFit;
   HOLEPUNCH HolePunchRemove;
   COLORREF crWhiteArea;
   COLORREF crBlackArea;
   L_UINT32 uDlgFlags;
   LTCOMMDLGHELPCB pfnHelpCallback;
   L_VOID  *pHelpCallBackUserData;
} HOLEPUNCHREMOVEDLGPARAMS,  * LPHOLEPUNCHREMOVEDLGPARAMS ;

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

Member

Description

uStructSize

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

pBitmap

Ignored.

bZoomToFit

Flag that indicates the initial zoom level for previewing the image. Possible values are:

 

Value

Meaning

 

TRUE

Set the initial zoom level to "Zoom to fit".

 

FALSE

Set the initial zoom level to "Normal (1:1)".

 

HolePunchRemove

HOLEPUNCH structure that LEADTOOLS uses to remove hole punches. You should set the pBitmapRegion member of the HOLEPUNCH structure to a valid address and fill the uBitmapStructSize member with the proper value.

Note: It's the user's responsibility to free the region in pBitmapRegion, if there is one, using L_FreeBitmapRgn.

crWhiteArea

Color used to fill the removed white areas. This is used only for dialog previewing purposes. 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.

crBlackArea

Color used to fill the removed black areas. This is used only for dialog previewing purposes. 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:

 

Value

Meaning

 

DLG_HOLEPUNCHREMOVE_SHOW_CONTEXTHELP

[0x00000002] dialog should contain a context sensitive help icon.

pfnHelpCallback

Ignored.

pHelpCallBackUserData

Ignored.