HandleExternalWindow

All Editions image\bltlrgss.gif Related Transactions  image\bltlrgss.gif Example

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

Using external Reference and Detail windows

Duplicating external document windows