IG_GUI_window_attribute

IG_GUI_window_attribute_set

In This Topic

This function sets the attribute settings of the GUI window.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPIIG_GUI_window_attribute_set( HWND hWnd, AT_MODE nAttributeID, DWORD dwData, LPVOID lpData );

Arguments:

Name	Type	Description
hWnd	HWND	Handle of the window in which the image is displayed.
nAttributeID	AT_MODE	A variable of type AT_MODE, such as IG_GUI_WINDOW_PAINT.
dwData	DWORD	The DWORD value. This used if nAttributeID=IG_GUI_WINDOW_IMAGE_ADD. In this case dwData contains the display group identifier, which should be used for a new image drawing.
lpData	LPVOID	A VOID pointer to a variable of the type required by the nAttributeID parameter. This sets the value for the attribute defined by nAttributeID.

Return Value:

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

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

GUI Windows

Example:

	Copy Code
HWND hWndImage; AT_ERRCOUNT nErrcount; AT_MODE nAttribute; BOOL bPaintFlag; bPaintFlag = FALSE; /* Disable painting / / Set the current attribute settings of the GUI window / nErrcount = IG_GUI_window_attribute_set(hWndImage, IG_GUI_WINDOW_PAINT, 0, bPaintFlag); / no ampersand */ nErrcount = IG_GUI_window_attribute_set(hIGear, IG_GUI_WINDOW_IMAGE_ADD, IG_GRP_DEFAULT, (LPVOID)hIGearSubImage); nErrcount = IG_GUI_window_attribute_set(hIGear, IG_GUI_WINDOW_IMAGE_REMOVE, 0, (LPVOID)hIGearSubImage); nErrcount = IG_GUI_window_attribute_set(hIGear, IG_GUI_WINDOW_HANDLE_RESIZE, 0, FALSE);

Copy Code

HWND hWndImage;
AT_ERRCOUNT nErrcount;
AT_MODE nAttribute;
BOOL bPaintFlag;
bPaintFlag = FALSE;          /* Disable painting */
/* Set the current attribute settings of the GUI window  */
nErrcount = IG_GUI_window_attribute_set(hWndImage, IG_GUI_WINDOW_PAINT, 0, bPaintFlag); 
     /* no ampersand */
nErrcount = IG_GUI_window_attribute_set(hIGear, 
IG_GUI_WINDOW_IMAGE_ADD, IG_GRP_DEFAULT, (LPVOID)hIGearSubImage);
nErrcount = IG_GUI_window_attribute_set(hIGear, IG_GUI_WINDOW_IMAGE_REMOVE, 0,
(LPVOID)hIGearSubImage);
nErrcount = IG_GUI_window_attribute_set(hIGear, IG_GUI_WINDOW_HANDLE_RESIZE, 0, FALSE);

Remarks:

The settings available for nAttributeID include:

IG_GUI_WINDOW_PAINT	If lpData is set to TRUE, the GUI window is painted.
IG_GUI_WINDOW_IMAGE_ADD	Adds a HIGEAR image to a GUI window. See the GUIWin example. Currently, there is one main image and other sub-images can be added to this. If an image is added and there already exists one or more images in the same place, the images will be animated.
IG_GUI_WINDOW_IMAGE_REMOVE	Removes a sub-image previously added with IG_GUI_WINDOW_IMAGE_ADD.
IG_WINDOW_HANDLE_RESIZE	The default value is TRUE. When it is set to FALSE, it prevents the GUI window from responding to WM_RESIZE messages.

Get Product Support