10 Getting Group Positions

10 Q3Group_GetNextPositionOfType

You can use the Q3Group_GetNextPositionOfType function to get the position of the next object of a particular type in a group.

TQ3Status Q3Group_GetNextPositionOfType (
TQ3GroupObject group, 
TQ3ObjectType isType, 
TQ3GroupPosition *position);
group A group.
isType An object type.
position On entry, a pointer to a valid group position. On exit, a pointer to the position in the specified group of the next object that follows the object in that position and that has the specified type.

DESCRIPTION


The Q3Group_GetNextPositionOfType function returns, in the position parameter, the position in the group specified by the group parameter of the next object that follows the object having the position specified on entry in the position parameter and that has the type specified by the isType parameter. If the object specified on entry is the last object of that type in the group, Q3Group_GetNextPositionOfType returns the value NULL in the position parameter. Note that the type of the object in the position specified by the position parameter on entry to Q3Group_GetNextPositionOfType does not have to be the same as the type specified by the isType parameter.

ERRORS


kQ3ErrorInvalidObject
kQ3ErrorInvalidPositionForGroup
kQ3ErrorNULLParameter

DESCRIPTION
ERRORS

3D Graphics Programming with QuickDraw 3D - 17 OCT 1995

© Apple Computer, Inc.

Let us know what you think of these prototype pages.

Generated with Harlequin WebMaker