Legacy Document

Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 5 - Collection Manager / Collection Manager Reference

Functions / Getting and Setting the Default Attributes for a Collection

SetCollectionDefaultAttributes

You use the SetCollectionDefaultAttributes function to alter the default attributes of a collection object.

void SetCollectionDefaultAttributes(Collection target,
                                    long whichAttributes,
                                    long newAttributes);

target

A reference to the collection object whose default attributes you want to alter.

whichAttributes

A mask indicating which bit flags in the target collection's default attributes you want to alter.

newAttributes

A long word containing the new values for the bit flags.

DESCRIPTION

The SetCollectionDefaultAttributes function copies the values of bit flags from the newAttributes parameter into the default attributes of the target collection.

This function uses the whichAttributes parameter to determine which bits to copy. For every bit in the whichAttributes parameter, this function takes one of two actions:

• If the bit is set, this function copies the value of the corresponding bit from the newAttributes parameter into the corresponding bit of the default attributes of the target collection.
• If the bit is not set, the corresponding bit of the target collection's default attributes remains unchanged.

SEE ALSO

For information about default attributes for collection objects, see "Collection Attributes" beginning on page 5-9.

For information about attribute-related data types and enumerations, see page 5-49 through page 5-53.

For examples of this function, see "Changing the Default Attributes of a Collection" beginning on page 5-15.

To examine the attributes of a collection object, use the GetCollectionDefaultAttributes function, which is described in the previous section.

To change the attributes of a specific item in a collection, use the functions described in "Editing Item Attributes" beginning on page 5-82.