Note: External windows are not supported in Imagenation for UNIX.
As with most Windows applications, document windows in Imagenation are normally contained within the Imagenation window.
But you can render documents in windows that belong to your client application instead, while hiding Imagenation completely. External windows allow you to do this. External windows are viewed in your application's display space but are still controlled by Imagenation.
To open a document in an external window:
1. Hide Imagenation. For details, click Hiding Imagenation.
2. Create your own window. Pass its handle to IN_RegisterExternalWindow to get a docwinID that corresponds to that handle.
3. Call IN_OpenExternalDocumentWindow to open the document into your window.
4. Call IN_HandleExternalWindow to tell Imagenation to take control of the display in the document window.
5. In the MessageProc for your window class, on a WM_SIZE message, call IN_ResetExternalWindowSize to tell Imagenation to resize its application window based on your window size.
To close an external window:
· Call IN_UnregisterExternalWindow to free Imagenation resources attached to that window.
Note that while you can display color rasters in external document windows, the color palette used may not accurately reflect the data in the file.
Note: External windows are not supported in Imagenation for UNIX.
See also
Opening documents: alternatives