RegisterExternalWindow

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

The RegisterExternalWindow transaction registers a window handle from an external application for use by Imagenation. You can use it to render either a document, Reference, or Detail external window. The return value is used in other external window transactions.

After you register an external window as a document window, you can open a document in it, and perform actions on the document (such as Merge and Save). However, before opening another document in it, you must unregister the external window, and then register it again. If you open and process multiple documents in an external window without registering and unregistering the window each time, you will quickly run out of resources.

Type XTYP_REQUEST or XTYP_EXECUTE

Syntax [RegisterExternalWindow(hWnd, type)]

Parameter

Data type

Values

Meaning

hWnd

DWORD

window handle from external application

type

WORD

type of external window to register:

 

 

0

document window

 

 

1

Reference window

 

 

2

Detail window

Reply

Data type

Meaning

extwinID

DWORD

external window identifier. See Remarks.

Remarks

A reply is only returned if this call is set up as an XTYP_REQUEST. Normally you will want to get the extwinID returned to use it in other external window transactions.

Release information

Added in Release 4.30.

See also

Opening documents in external windows

Using external Reference and Detail windows

Duplicating external document windows