Using Imaging Common Dialogs

The Imaging Common Dialog libraries provide a set of common dialog boxes that combine Windows Common Dialog functionality with imaging functionality contained in LEADTOOLS. For a list of required DLL's, refer to Files To Be Included With Your Application. Imaging Common Dialogs are provided for numerous image processing, effects and filtering functions.

Reusable dialogs for the most common LEADTOOLS imaging functions and effects are now provided.

- A Thumbnail Preview option for the image processing dialogs allows the end user to preview the proposed change to the image, before actually affecting the original image.

- An optional Help callback function lets you provide custom help information for each dialog.

- A user interface control for the dialogs is provided through flags in the structure passed to each dialog function.

- An option to have the Imaging Common Dialog process the image automatically is provided.

These dialogs provide input parameters needed for the several LEADTOOLS imaging functions. The table below gives the function that displays the dialog on the left and the image processing function associated with it on the right, if one exists. For more information on the Image Processing functions, refer to the LEADTOOLS Main Class Library help file in the LEADTOOLS/HELP directory.

In addition to the dialog functions provided for image processing, LEADTOOLS also provides Imaging Common Dialog functions for general use and dialog maintenance. These are given below.

Each of the XXXDoModalXXX functions listed above displays a dialog through which the user can enter parameters for various image processing or other functions. These dialogs may be initialized prior to calling the XXXDoModalXXX function by calling a corresponding GetXXXParams function. Likewise, once the user has made his or her selections in the dialog, those new values can be retrieved using a corresponding SetXXXParams function. The table below lists the corresponding GetXXXParams and SetXXXParams function for each DoModalXXX function listed above:

LDialogColor:

LDialogDocument:

LDialogFile:

LDialogEffect:

LDialogImage:

LDialogImageEffect:

LDialogWeb:

Implementing help for LEADTOOLS dialogs is achieved by setting a pointer to a help callback function in the structure passed to all functions in LDialogXXX classes. The callback function will be called to provide the appropriate help for the corresponding dialog if the user clicks on the Help Button. For more information concerning implementing the help callback function, refer to LDialogBase::DialogHelpCallBack Callback Function.