Note: External windows are not supported in Imagenation for UNIX.
Reference and Detail windows are normally tied to document windows displayed within the Imagenation window. You can, however, render documents in windows that belong to your client application instead, while hiding Imagenation completely. These are called external document windows. You can also create external Reference and Detail windows, and link these to external document windows.
To use external Reference and Detail windows:
1. Create the floating window. Pass its handle to IN_RegisterExternalWindow to get an extwinID that corresponds to that handle.
2. Link the external floating window to an already registered external document window with IN_LinkToDocumentWindow.
3. Tell Imagenation to take control of the display in the external Reference or Detail window, by calling IN_HandleExternalWindow.
4. In the MessageProc for your window class, on a WM_SIZE message, call IN_ResetExternalWindowSize to tell Imagenation to resize its external windows based on your window size.
To close the linked document window:
1. Call IN_LinkToDocumentWindow( extwinID, "").
2. Call IN_UnregisterExternalWindow to free up Imagenation resources attached to that window.
Note: External windows are not supported in Imagenation for UNIX.
See also