Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 10 - Group Objects / Group Objects Reference

Group Objects Routines / Managing Groups

Q3Group_AddObjectBefore

You can use the Q3Group_AddObjectBefore function to add an object to a group, positioning it before a certain object already in the group.

TQ3GroupPosition Q3Group_AddObjectBefore (
TQ3GroupObject group, 
TQ3GroupPosition position, 
TQ3Object object);

group

A group.

position

A group position.

object

An object.

DESCRIPTION

The Q3Group_AddObjectBefore function inserts the object specified by the object parameter into the group specified by the group parameter, before the group position specified by the position parameter. Q3Group_AddObjectBefore returns, as its function result, the new position of the object in the group. If an error occurs during the insertion of the object into the group, Q3Group_AddObjectBefore returns NULL.

ERRORS

kQ3ErrorInvalidObject
kQ3ErrorInvalidPositionForGroup
kQ3ErrorOutOfMemory

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help