The HandleExternalWindow transaction 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 handles the specified functions.
The window handle that was initially registered using RegisterExternalWindow will not receive any messages except WM_PARENTNOTIFY, a Windows message. See Opening documents in external windows.
Type XTYP_EXECUTE
Syntax [HandleExternalWindow(docwinID, initialMode)]
[HandleExternalWindow(refWinID)]
[HandleExternalWindow(dtlWinID)]
|
Parameter |
Data type |
Values |
Meaning |
|
docwinID |
DWORD |
identifier of the external document window. See Remarks. | |
|
refWinID |
DWORD |
identifier of the external Reference window | |
|
dtlWinID |
DWORD |
identifier of the external Detail window | |
|
initialMode |
WORD |
specify functionality handled by Imagenation. See Remarks. | |
|
|
|
0 |
none |
|
|
|
1 |
zooming. See Remarks. |
|
|
|
2 |
vector drawing |
|
|
|
4 |
scroll bars |
|
|
|
8 |
left mouse button zooming. See Remarks. |
|
|
|
16 |
right mouse button context menu. See Remarks. |
|
|
|
(can be 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 (1), but not the left mouse button zoom option (8). In this case the right mouse button context menu (16) will not be enabled, even if it is specified.
To allow left mouse zooming, use both the zooming and the left mouse button zoom options. You can then use the right mouse button context menu as well.
For external Reference windows, the initial mode 7 is used. For external Detail windows, the initial mode 6 is used.
Release information
Added in Release 4.30.
Modified in Release 5.0:Added two possible mode values.
See also