IN_ShowDialog

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

The IN_ShowDialog function shows the specified dialog box in a document window. The integration cannot respond to changes the end user makes in the dialog box.

Syntax

int IN_ShowDialog( docwinID, dialogID )

Parameters

Values

Meaning

IN_DOCWIN docwinID

0 | docwinID

active | specific. See Remarks.

SHORT dialogID

dialog box to show. To see a Windows version of the dialog box, click its name:

IN_DIALOG_VIEWPREF (1) View Options See Remarks.

IN_DIALOG_EDITPREF (2) Edit Options

IN_DIALOG_TOOLPREF (3) Tool Options, Global category

IN_DIALOG_TEXTPREF (4) Tool Options, Text category

IN_DIALOG_DIMPREF (5) Tool Options, Dimension category

IN_DIALOG_SYSTOPT (6) System Preferences

IN_DIALOG_FILEOPT (7) File Preferences

IN_DIALOG_VIEWOPT (8) View Preferences

IN_DIALOG_EDITOPT (9) Edit Preferences

IN_DIALOG_TOOLOPT (10) Tool Preferences, Global category

IN_DIALOG_TEXTOPT (11) Tool Preferences, Text category

IN_DIALOG_DIMOPT (12) Tool Preferences, Dimension category

IN_DIALOG_HOTOPT (13) Tool Preferences, Hotspot category

IN_DIALOG_PRINT_SET (14) Print, Print category

IN_DIALOG_HOTPREF (15) Tool Options, Hotspot category

IN_DIALOG_FORMATOPTS (16)
Format Preferences

Remarks

If a 3D document is active, the 3D Options dialog box is displayed.

Generally, Options dialog boxes affect the active document or layer, while Preferences set defaults for future documents or layers. The docwinID, though it must be included, is ignored for Preferences dialog boxes that affect the entire system. Therefore, you can show one of the Preferences dialog boxes even when no document windows are open.

You can only display dialog boxes that are available in your edition of Imagenation.

Release information

Added to Imagenation for Windows in Release 4.10.

As of Release 5.1, also available in Imagenation for UNIX.