Note: IN_GetDocwinIDFromHWnd and IN_GetHWndFromDocwinID will work in Imagenation for UNIX integrations using Wind/U-based client applications. However, the IN_GetNumberDocumentWindows macro has not been tested with Imagenation for UNIX.
Many API calls act on document windows. The docwinID variable is the most common in the C API. docwinID is a unique identifier, of the IN_DOCWIN data type (an unsigned long value), that is assigned to every document window. It is the first parameter for any function that acts upon a specific document window. It is returned when you request the identifier of the active window and when you open a new window.
To find a document window identifier:
· Use IN_GetDocumentWindows to get the number of open windows and a list of their identifiers.
· Use IN_GetDocwinIDFromHWnd to get a document window's identifier, given its window handle.
You can also request a document window's handle, given its document window identifier, with the IN_GetHWndFromDocwinID function.
To find out how many document windows are open:
· Use IN_GetNumberDocumentWindows.
Note: IN_GetDocwinIDFromHWnd and IN_GetHWndFromDocwinID will work in Imagenation for UNIX integrations using Wind/U-based client applications. However, the IN_GetNumberDocumentWindows macro has not been tested with Imagenation for UNIX.
See also