ImageGear Professional DLL v17.1 for Windows Accusoft
IG_GUI_window_associate
Send Feedback  
ImageGear Professional DLL v17.1 for Windows > API Reference Guide > Core Component API Reference > Core Component Functions Reference > GUI Functions > GUI Window Functions > IG_GUI_window_associate

Glossary Item Box

You may call this function to convert an image window owned by your application into a GUI window (bAssociate = TRUE), or to render a GUI window that is no longer a GUI window (bAssociate = FALSE).

Declaration:

  Copy Code
AT_ERRCOUNT ACCUAPI IG_GUI_window_associate ( 
        HIGEAR hIGear, 
        DWORD dwGrpID, 
        HWND hWndImage, 
        BOOL bAssociate 
);

Arguments:

hIGear The HIGEAR handle of an image.
dwGrpID The display group identifier indicating where to obtain the display options for drawing an image in the GUI window.
hWndImage The HWND handle of the image window.
bAssociate TRUE = associate; FALSE = disassociate.

Return Value:

Returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

All pixel formats supported by ImageGear Professional.

Sample:

Display, GUI Windows

Example:

  Copy Code
HIGEAR hIGear;     /* HIGEAR handle of image  */
HWND hWnd;      /* Window it is being displayed in  */
/* Turn existing window into a GUI window: */
IG_GUI_window_associate ( hIGear, hWnd, TRUE );

Remarks:

In general, the parent window of a magnify or pan window should be made a GUI window so that ImageGear will automatically handle the magnifying or panning function.

In any case, if a window had not been made a GUI window by calling IG_GUI_window_associate() or IG_GUI_window_create(), then your application will have to handle the Windows message such as WM_PAINT, and the WM_... scroll messages generated in response to user mouse clicks.

See also function IG_GUI_window_create(), which creates a GUI window, rather than associating an already existing window.
©2012. Accusoft Corporation. All Rights Reserved.