IN_SetExtDocumentWindowMode

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

The IN_SetExtDocumentWindowMode function sets which actions you can take in an external document window. These options are first defined by the IN_HandleExternalWindow function. Before using IN_SetExtDocumentWindowMode, you must register the window with IN_RegisterExternalWindow, and then initialize it with IN_HandleExternalWindow.

Syntax

int IN_SetExtDocumentWindowMode( docwinID, initialMode )

Parameters

Values

Meaning

IN_DOCWIN docwinID

identifier of external document window (assigned by IN_RegisterExternalWindow)

int initialMode

IN_EXTMODE_ALL (65536) all abilities enabled

IN_EXTMODE_ZOOM (1) mouse zooming is allowed. See Remarks.

IN_EXTMODE_VECTOR (2) vector drawing is allowed

IN_EXTMODE_SCROLL (4) scrolling with the scroll bars is allowed

IN_EXTMODE_LBM_ZOOM (8) left mouse button zooming allowed. See Remarks.

IN_EXTMODE_RMB_CONTEXT (16)
right mouse button context menu is allowed. See Remarks.

(can be concatenated or ORed)

Remarks

When you issue commands to external document windows, you must use a specific docwinID, even if you are referring to the active window.

Shortcut keys such as F2 cannot be used in external windows--it is a technical limitation.

To allow right mouse button zooming, use the mouse zooming option, but the not left mouse button zooming option. In this case the right mouse button context menu will not be enabled, if it is specified.

To allow left mouse button zooming, use both the zooming and the left mouse button zoom options. You can then use the right mouse button context menu as well.

Release information

Added to Imagenation for Windows in Release 4.10.

Modified in Release 5.0 to support more display options.

Not supported in Imagenation for UNIX.

See also

Opening documents into external windows

Placing vector objects

Scrolling

Zooming