ImageGear for C and C++ on Windows v19.6 - Updated
ART_group_delete
API Reference Guide > ART Component API Reference > ART Component Functions Reference > Group Functions > ART_group_delete

This function deletes any marks that belong to the mark group.

Declaration:

 
Copy Code
AT_ERRCOUNT ART_group_delete(
        HIGEAR hIGear, 
        const LPSTR szGroupName
);

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle to the image.
szGroupName const LPSTR A far pointer to a NULL-terminated string that contains the name of the group that contains the marks for deletion.

Return Value:

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

Supported Raster Image Formats:

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

Sample:

None

Example:

 
Copy Code
HIGEAR hIGear; /* HIGEAR handle of image */
char FAR *szGroupName; /* name of group to delete */
szGroupName = "Sticky Notes Group";
nErrcount = ART_group_delete(hIGear, szGroupName);

Remarks:

An error is set if any of the following conditions are met: