ImageGear for C and C++ on Windows v19.3 - Updated
IG_GUI_window_associate
API Reference Guide > Core Component API Reference > Core Component Functions Reference > GUI Functions > GUI Window Functions > IG_GUI_window_associate

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:

Name Type Description
hIGear HIGEAR The HIGEAR handle of an image.
dwGrpID DWORD The display group identifier indicating where to obtain the display options for drawing an image in the GUI window.
hWndImage HWND The HWND handle of the image window.
bAssociate BOOL 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 for C and C++.

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.