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

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);

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.