ImageGear for C and C++ on Windows v19.3 - Updated
IG_ISIS_drv_area_dialog
API Reference Guide > ISIS Component API Reference > ISIS Component Functions Reference > Driver Communication and Setup Functions > IG_ISIS_drv_area_dialog

Display set scanning area dialog box.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_ISIS_drv_area_dialog(
        HISISDRV hDriver,
        HWND hWnd,
        HINSTANCE hInst,
        DWORD dwFlags
);

Arguments:

Name Type Description
hDriver HISISDRV The handle of the driver for which this dialog box is being displayed.
hWnd HWND A handle to the parent window.
hInst HINSTANCE A handle to the application instance.
dwFlags DWORD

The currently available bits for dwFlags are as follows: IG_ISIS_DRV_SET_DIALOG_AREAPREVIEW When this bit is set, the Area dialog box displayed will include a preview box where the user can set the scan area through mouse actions. The preview box may display an image if a callback function has been set with IG_ISIS_area_dialog_CB_register, otherwise it will be gray.

Return Value:

Error count.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

The IG_ISIS_drv_area_dialog function displays a predefined dialog box that allows the user to set scanning area. This is the same dialog that appears when the user clicks the Area button in the Scanner Settings dialog box.

Use this function to display the Area dialog box, allowing the user to set the area to scan. Changing the settings in the Area dialog box modifies the values of IG_ISIS_TAG_IMAGEWIDTH, IG_ISIS_TAG_IMAGELENGTH, IG_ISIS_TAG_XPOSITION, and IG_ISIS_TAG_YPOSITION when the user click the OK button.

Note that the Units setting of this dialog is saved in SETSCAN.INI.

Changing the settings in the Area dialog box does not automatically send the new tag values to the driver. If you are using a Kodak IL500 or IL9xx scanner (special cases), you must issue a IG_ISIS_drv_send_params to send the new scanning area to the scanner. If you are using any other ISIS scanner, simply initiating a scan sends the new scanning area automatically.

See Also:

IG_ISIS_drv_set_dialog

IG_ISIS_area_dialog_CB_register