ImageGear for C and C++ on Linux v19.10 - Updated
ART_group_select
API Reference Guide > ART Component API Reference > ART Component Functions Reference > Group Functions > ART_group_select

This function selects or deselects all marks that belong to the specified mark group.

Declaration:

 
Copy Code
AT_ERRCOUNT ART_group_select(
        HIGEAR hIGear, 
        const LPART_GROUP_NAME szGroupName, 
        BOOL fSelect
);

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle to the image.
lpGroupName const LPART_GROUP_NAME A far pointer to a NULL-terminated string that identifies the name of the mark group for selection.
fSelect BOOL A flag of type BOOL that tells ART whether to select or deselect the marks in the specified group. If set to TRUE, the marks in the group are selected.

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++.

Example:

 
Copy Code
HIGEAR hIGear; /* HIGEAR handle of image */
char FAR *szGroupName; /* Type of Group to */
/* select all marks from */
szGroupName = "Former Employee Group";
nErrcount = ART_group_select(hIGear, szGroupName, TRUE);

Remarks:

When fSelect is set to TRUE, all marks in the group are selected. When fSelect is set to FALSE, all marks in the group are deselected.

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