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

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:

hIGear does not reference a valid ImageGear handle.
szGroupName does not point to a valid address.
No group matches szGroupName.