This function resets all the options of the specified group to its default values.

Declaration:

AT_ERRCOUNT ACCUAPI IG_dspl_grp_reset(
        [IN] HIGEAR hIGear, 
        [IN] DWORD dwGrpID
);

Arguments:

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, Print

Example:

    HIGEAR hIGear; /* HIGEAR handle of image */ DWORD nGrpID; /* display group identifier */ ...
    IG_dspl_grp_reset( hIGear, nGrpID ); ...
 

Remarks:

Please note the application code is responsible for freeing memory allocated for options such as TranspMaskandBkBrush. This function does not free it.

This function also removes the flag that marks this group as "used." It may be set again by any display function that specifies using this group identifier.