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

Chapter 1 - Introduction to QuickDraw 3D / QuickDraw 3D Reference

QuickDraw 3D Routines / Managing Sets

Q3Set_Get

You can use the Q3Set_Get function to get the data associated with an element in a set.

TQ3Status Q3Set_Get (
TQ3SetObject set, 
TQ3ElementType type, 
void *data);

set

A set object.

type

An element type.

data

On entry, a pointer to a structure large enough to hold the data associated with elements of the specified type. On exit, a pointer to the data of the element having the specified type.

DESCRIPTION

The Q3Set_Get function returns, in the data parameter, the data currently associated with the element whose type is specified by the type parameter in the set specified by the set parameter. If no element of that type is in the set, Q3Set_Get returns kQ3Failure.

If you pass the value NULL in the data parameter, no data is copied back to your application. (Passing NULL might be useful simply to determine whether a set contains a specific type of element.)

If the specified element type is a custom element type, Q3Set_Get uses the custom type's kQ3MethodTypeElementCopyGet custom method. See the chapter "QuickDraw 3D Objects" for complete information on custom element types.