Q3Group_GetNextObjectPosition
You can use the Q3Group_GetNextObjectPosition function to get the position of the next instance of an object in a group.
TQ3Status Q3Group_GetNextObjectPosition (
TQ3GroupObject group,
TQ3Object object,
TQ3GroupPosition *position);
group
- A group.
object
- An object.
position
- On entry, a pointer to a valid group position. On exit, a pointer to the position in the specified group of the next instance of the specified object.
DESCRIPTION
The Q3Group_GetNextObjectPosition function returns, in the position parameter, the position of the next instance in the group specified by the group parameter of the object specified by the object parameter. If the position specified on entry is the last instance of that object in the group, Q3Group_GetNextObjectPosition returns the value NULL in the position parameter.
ERRORS
kQ3ErrorInvalidObject
kQ3ErrorInvalidPositionForGroup
kQ3ErrorNULLParameter