Instance Method

registerClass:forItemWithIdentifier:

Registers a class to use when creating new items in the collection view.

Declaration

- (void)registerClass:(Class)itemClass forItemWithIdentifier:(NSUserInterfaceItemIdentifier)identifier;

Parameters

itemClass

A class to use for creating items. The class must be descended from NSCollectionViewItem. Specify nil to unregister a previously registered class or nib file.

identifier

The string that identifies the type of item. You use this string later when requesting new items and it must be unique among the other registered item and view classes of this collection view. This parameter must not be an empty string or nil.

Discussion

Use this method to register the classes that represent items in your collection view. When you request an item using the makeItemWithIdentifier:forIndexPath: method, the collection view recycles an existing item with the same identifier or creates a new one by instantiating your class and calling the init method of the resulting object.

Because items are recycled to improve performance, it is recommended that your custom classes conform to the NSCollectionViewElement protocol. You can use the methods of that protocol to prepare your classes for reuse.

Typically, you register your items when initializing your collection view interface. Although you can register new items at any time, you must not call the makeItemWithIdentifier:forIndexPath: method until after you register the corresponding item.

See Also

Creating Collection View Items

- makeItemWithIdentifier:forIndexPath:

Creates or returns a reusable item object of the specified type.

- registerNib:forItemWithIdentifier:

Registers a nib file to use when creating items in the collection view.

- makeSupplementaryViewOfKind:withIdentifier:forIndexPath:

Creates or returns a reusable supplementary view of the specified type.

- registerClass:forSupplementaryViewOfKind:withIdentifier:

Registers a class to use when creating new supplementary views in the collection view.

- registerNib:forSupplementaryViewOfKind:withIdentifier:

Registers a nib file to use when creating supplementary views in the collection view.