Legacy Document

Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 5 - Collection Manager / Collection Manager Reference

Functions

This section describes the Collection Manager functions you can use to

• create and dispose of collection objects
• clone and copy collection objects and determine their owner counts
• get and set the default attributes for a collection object
• add and replace items in a collection
• remove items from a collection
• count items in a collection
• retrieve the variable-length data from a collection item
• get information about an item in a collection (for example, the index of the item, the size of the item's data, or the item's attribute flags)
• set the attribute flags of a collection item
• get information about the collection tags associated with the items of a collection
• flatten and unflatten collections
• use Macintosh Memory Manager handles to specify variable-length data

WARNING

Many of the functions in this section require a reference to a collection object (that is, a reference of type Collection) as a parameter. When calling any of these functions, you must always provide a valid collection object reference. If you do not, the behavior of the function is undefined.

---

Subtopics

Creating and Disposing of Collection Objects

Cloning and Copying Collection Objects

Getting and Setting the Exception Procedure for a Collection

Getting and Setting the Default Attributes for a Collection

Adding and Replacing Items in a Collection

Removing Items From a Collection

Counting Items in a Collection

Retrieving the Variable-Length Data From an Item

Getting Information About a Collection Item

Editing Item Attributes

Getting Information About Collection Tags

Flattening and Unflattening a Collection

Working With Macintosh Memory Manager Handles

Reading Collections From Resource Files