Using external Reference and Detail windows

 

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, and pass its handle to RegisterExternalWindow to get an extWinID that corresponds to that handle.

2. Link the external floating window to an already registered external document window with LinkToDocumentWindow.

3. If you want to tell Imagenation to take control of the display in the external Reference or Detail window, call HandleExternalWindow.

4. In the MessageProc for your window class, on a WM_SIZE message, call ResetExternalWindowSize to tell Imagenation to resize its external windows based on your window size.

To close the linked floating window:

1. Call LinkToDocumentWindow(extWinID, 0) to unlink the window from the external document window.

2. Call UnregisterExternalWindow(extwinID) to free up Imagenation resources attached to that window.

See also