SetExtDocumentWindowMode

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

The SetExtDocumentWindowMode transaction sets which actions Imagenation is allowed to take in the specified external document window. Before using this transaction, you must register the window with RegisterExternalWindow, and then initialize it with HandleExternalWindow.

The HandleExternalWindow transaction first sets these options. You can change the original settings using this transaction.

Type XTYP_EXECUTE

Syntax [SetExtDocumentWindowMode(extdocwinID, mode)]

Parameter	Data type	Values	Meaning
extdocwinID	DWORD	identifier of the external document window (not 0)
mode	WORD	65535	all abilities enabled
		1	mouse zooming allowed. See Remarks.
		2	vector drawing allowed
		4	scroll bar scrolling allowed
		8	left mouse button zooming allowed. See Remarks.
		16 (can be ORed)	right mouse button context menu allowed. See Remarks.

Remarks

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 (1), but not the left mouse button zooming option (8). In this case the right mouse button context menu (16) cannot be enabled, even if it is specified.

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

Release information

Added in Release 4.10.

Modified in Release 5.0:Added two possible mode values.