IN_GetScanDlgControlState

$image\bltlrgsq_shg.gif$ Editions $image\bltlrgsq_shg.gif$ Related Functions $image\bltlrgsq_shg.gif$ Example

The IN_GetScanDlgControlState function returns the status of the specified setting (or "control") in the active Scan dialog box. You can display a Scan dialog box through the user interface, or by using the Visibility option of IN_SetScanParameter.

$image\chiclet_shg.gif$ Sample Scan dialog box

Syntax

int IN_GetScanDlgControlState( parameterID, maxSize, pStatus )

Input Parameters	Meaning
SHORT parameterID	identifier of the scan parameter to query. See Scan dialog box settings.
SHORT maxSize	the maximum character length of the pStatus array
Output Parameters	Values	Meaning
CHARPTR pStatus	pointer to: "ACTIVE" the setting's value can be changed "INACTIVE" the setting is dimmed, so its value cannot be changed "VISIBLE" the setting is displayed "INVISIBLE" the setting is not displayed (can be concatenated)

Remarks

The pStatus values are case-sensitive.

Release information

Added to Imagenation for Windows in Release 4.20.

Published in Release 5.10.

Not supported in Imagenation for UNIX.

See also

Customizing the Scan dialog box