Instance Method

dequeueReusableHeaderFooterViewWithIdentifier:

Returns a reusable header or footer view located by its identifier.

Declaration

- (__kindof UITableViewHeaderFooterView *)dequeueReusableHeaderFooterViewWithIdentifier:(NSString *)identifier;

Parameters

identifier

A string identifying the header or footer view to be reused. This parameter must not be nil.

Return Value

A UITableViewHeaderFooterView object with the associated identifier or nil if no such object exists in the reusable view queue.

Discussion

For performance reasons, a table view’s delegate should generally reuse UITableViewHeaderFooterView objects when it is asked to provide them. A table view maintains a queue or list of UITableViewHeaderFooterView objects that the table view's delegate has marked for reuse. It marks a view for reuse by assigning it a reuse identifier when it creates it (that is, in the initWithReuseIdentifier: method of UITableViewHeaderFooterView).

You can use this method to access specific template header and footer views that you previously created. You can access a view’€™s reuse identifier through its reuseIdentifier property.

See Also

Recycling Section Headers and Footers

- registerNib:forHeaderFooterViewReuseIdentifier:

Registers a nib object containing a header or footer with the table view under a specified identifier.

- registerClass:forHeaderFooterViewReuseIdentifier:

Registers a class for use in creating new table header or footer views.