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