ImageGear for C and C++ on Windows v19.1 - Updated
IG_gui_dspl_background_dlg
API Reference Guide > GUI Component API Reference > GUI Component Functions Reference > Display Functions > IG_gui_dspl_background_dlg

This function shows the dialog that allows you to change the background color or image.

Declaration:

 
Copy Code
BOOL ACCUAPI IG_gui_dspl_background_dlg (
        HWND hWnd, 
        LPAT_IGGUI_DSPL_BACKGROUND lpDsplBackgroundData
);

Arguments:

Name Type Description
hWnd HWND A handle of the parent window.
lpDsplBackgroundData LPAT_IGGUI_DSPL_BACKGROUND A pointer to the AT_IGGUI_DSPL_BACKGROUND structure.

Return Value:

If the user specifies parameters and clicks the OK button, the return value is non-zero. If the user cancels or closes the dialog box or an error occurs, the return value is zero:

Supported Raster Image Formats:

All pixel formats supported by ImageGear for C and C++.

Sample:

Display

Example:

 
Copy Code
#include "IG_gui_common.h"
AT_IGGUI_DSPL_BACKGROUND DsplBackground;
memset (&DsplBackground,0,sizeof(DsplBackground));
DsplBackground.cbSize = sizeof (DsplBackground);
DsplBackground.hWnd = hWnd;
DsplBackground.hIGear = hIGear;
DsplBackground.dwGrpID = nGrpID;
IG_gui_dspl_background_dlg (hWnd, &DsplBackground);
InvalidateRect (hWnd,NULL,FALSE);
UpdateWindow (hWnd);