Related Functions
Example All Editions
Related Functions
Example
The IN_HandleExternalWindow function tells Imagenation to handle all of the events for the specified external Reference, Detail, or document window. It creates a child window on top of the specified window in which Imagenation carries out all specified actions. The window handle that was initially registered with IN_RegisterExternalWindow will not receive any messages except WM_PARENTNOTIFY, a Windows message.
Syntax
int IN_HandleExternalWindow( extwinID, initialMode )
|
Parameters |
Values |
Meaning |
|
IN_WINOBJ extwinID |
identifier of the external document, Reference, or Detail window, assigned by IN_RegisterExternalWindow. See Remarks. | |
|
SHORT initialMode |
0 none IN_EXTMODE_ALL (65536) all abilities enabled IN_EXTMODE_ZOOM (1) zooming with the mouse 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_LMB_ZOOM (8) l IN_EXTMODE_RMB_CONTEXT (16) (can be concatenated or ORed) | |
Remarks
When issuing commands to external document windows, you must use a specific docwinID, even if you are referring to the active document.
To allow right mouse button zooming, use the zooming option, but not the left mouse button zoom option. In this case the right mouse button context menu will not be enabled, even if you specify it.
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 option as well.
When issuing the IN_HandleExternalWindow call for an external Detail or Reference window, set the initialMode parameter to zero. Their modes are defined automatically. For external Reference windows, IN_EXTMODE_ALL is used as the initialMode. For external Detail windows, all states except zooming are used as the initialMode.
Release information
Added to Imagenation for Windows in Release 4.30.
Modified in Release 5.0 to support more display options.
Not supported in Imagenation for UNIX.
See also
Opening documents into external windows