TQ3ElementCopyAddMethod (IM: QD3D)

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

Chapter 3 - QuickDraw 3D Objects / QuickDraw 3D Objects Reference

TQ3ElementCopyAddMethod
You can define a method to copy the data of your custom element type when an element of that type is added element to a set.
typedef TQ3Status (*TQ3ElementCopyAddMethod) (
const void *fromAPIElement, 
void *toInternalElement);
fromAPIElement
A pointer to the element data associated with an element having your custom element type.
toInternalElement
On entry, a pointer to an uninitialized block of memory large enough to contain the element data associated with an element having your custom element type.

DESCRIPTION
Your TQ3ElementCopyAddMethod function should copy the element data pointed to by the fromAPIElement parameter into the location pointed to by the toInternalElement parameter. This method is called whenever the Q3Set_Add or Q3AttributeSet_Add function is used to add an element of your custom type to a set. The fromAPIElement parameter contains the same data pointer that was passed to Q3Set_Add or Q3AttributeSet_Add.

RESULT CODES
Your TQ3ElementCopyAddMethod function should return kQ3Success if it is successful and kQ3Failure otherwise.