IG_GUI_window

This function is called to create a GUI window.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_GUI_window_create ( HIGEAR hIGear, DWORD dwGrpID, HWND hWndParent, const LPSTR lpszTitle, INT nX, INT nY, INT nWidth, INT nHeight, HWND FAR* lphWndImage );

Arguments:

Name	Type	Description
hIGear	HIGEAR	HIGEAR handle of an image.
dwGrpId	DWORD	Display group identifier, which is used to display an image in the GUI window.
hWndParent	HWND	Handle of the Parent window.
lpszTitle	const LPSTR	Title of an Image Window.
nX	INT	X position of the Image window's upper left corner.
nY	INT	Y position of the Image window's upper left corner.
nWidth	INT	Width of the Image window.
nHeight	INT	Height of the Image window.
lphWndImage	HWND FAR*	Far pointer to the HWND object to hold the Image window handle.

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:

GUI Windows, Display

Example:

	Copy Code
LPFNIG_GUIWINDESTROY MyGUIwinCleanup; /* Called when GUI window closed / HWND hWnd; / Handle of existing parent window / HWND hWndImage; / Will hold handle of GUI window / BOOL bDelete; / TRUE= delete HIGEAR image when close window / AT_ERRCOUNT nErrcount; / Returned count of errors / / Create a GUI image window: / nErrcount = IG_GUI_window_create ( hIGear, IG_GRP_DEFAULT, hWnd, "My GUI Image Window", 100, 50, 400, 200, &hWndImage ); If ( nErrcount == 0) { / Register a function to be called if user closes this GUI window: / bDelete = FALSE; / (Don't delete HIGEAR if window is closed)/ IG_GUI_window_CB_register ( hWndImage, MyGUIwinCleanup, (LPVOID) &bDelete ); ... } / Callback function, called when window is destroyed: / VOID ACCUAPI MyGUIwinCleanup ( LPVOID lpPrivate, HIGEAR hIGear, HWND hWndClosing ) { / Delete the image if bDelete not FALSE: / if ( ((LPBOOL) lpPrivate) ) { if ( IG_image_is_valid (hIGear) ) { IG_image_delete ( hIGear ); } } return; }

Copy Code

LPFNIG_GUIWINDESTROY  MyGUIwinCleanup; /* Called when GUI window closed */
HWND    hWnd;          /* Handle of existing parent window     */
HWND     hWndImage;    /* Will hold handle of GUI window        */
BOOL     bDelete;     /* TRUE= delete HIGEAR image when close window  */
AT_ERRCOUNT nErrcount;    /* Returned count of errors      */
/* Create a GUI image window: */
nErrcount = IG_GUI_window_create ( hIGear, IG_GRP_DEFAULT, hWnd, "My GUI Image Window",
100, 50, 400, 200, &hWndImage );
If ( nErrcount == 0)
        {
/* Register a function to be called if user closes this GUI window:  */
        bDelete = FALSE;    /* (Don't delete HIGEAR if window is closed)*/
        IG_GUI_window_CB_register ( hWndImage, MyGUIwinCleanup, (LPVOID) &bDelete );
         ...
        }
/* Callback function, called when window is destroyed: */
VOID ACCUAPI  MyGUIwinCleanup
( LPVOID lpPrivate, HIGEAR hIGear, HWND hWndClosing )
{
/* Delete the image if bDelete not FALSE: */
if ( *((LPBOOL) lpPrivate) )
        {
        if ( IG_image_is_valid (hIGear) )
 { IG_image_delete ( hIGear ); }
        }
return;
}

Remarks:

See the description of the IG_GUI_window_associate() function.

Currently it is possible to change font title for Page windows that is created by IG_GUI_page_window_create(). To set the font use IG_GUI_page_attribute_set() and to get the font use IG_GUI_page_attribute_get() with IG_GUI_PAGE_FONT_TITLE option. As in the case of thumbnail window, the user is responsible for creating and deleting font.