Legacy Document

Inside Macintosh: QuickDraw GX Environment and Utilities /

Chapter 5 - Collection Manager / Collection Manager Reference

Functions / Removing Items From a Collection

EmptyCollection

You use the EmptyCollection function to remove every item in a collection.

void EmptyCollection (Collection target);

target

A reference to the collection object you want to empty.

DESCRIPTION

This function removes every item in the collection referenced by the target parameter. This function provides the fastest mechanism for emptying a collection.

SEE ALSO

For information about collection items, see "Collection Items" beginning on page 5-8.

To remove all of the items in a collection whose attributes match a specified pattern, use the PurgeCollection function, described on page 5-67.

To remove all of the items in a collection with a specified collection tag, use the PurgeCollectionTag function, described in the previous section.