IN_UnregisterExternalWindow

All Editions $image\bltlrgsq_shg.gif$ Related Functions $image\bltlrgsq_shg.gif$ Example

The IN_UnregisterExternalWindow function unregisters an external window that has been used by Imagenation for rendering either a document, Reference, or Detail external window.

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 IN_Merge and IN_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.

Syntax

int IN_UnregisterExternalWindow( extwinID )

Parameters	Values
IN_WINOBJ extwinID	external window handle, assigned by IN_RegisterExternalWindow. See Remarks.

Remarks

You must use a specific extwinID, not just 0, to indicate the active external window.

Release information

Added to Imagenation for Windows in Release 4.30.

Not supported in Imagenation for UNIX.

See also

Opening documents into external windows