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 Professional.
Sample:
None
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:
- hIGear does not reference a valid ImageGear handle.
- szGroupName does not point to a valid address.
- No group matches szGroupName.