Instance Method

selectRowAtIndexPath:animated:scrollPosition:

Selects a row in the table view identified by index path, optionally scrolling the row to a location in the table view.

Declaration

- (void)selectRowAtIndexPath:(NSIndexPath *)indexPath animated:(BOOL)animated scrollPosition:(UITableViewScrollPosition)scrollPosition;

Parameters

indexPath

An index path identifying a row in the table view.

animated

YES if you want to animate the selection and any change in position; NO if the change should be immediate.

scrollPosition

A constant that identifies a relative position in the table view (top, middle, bottom) for the row when scrolling concludes. See UITableViewScrollPosition for descriptions of valid constants.

Discussion

Calling this method does not cause the delegate to receive a tableView:willSelectRowAtIndexPath: or tableView:didSelectRowAtIndexPath: message, nor does it send UITableViewSelectionDidChangeNotification notifications to observers.

Special Considerations

Passing UITableViewScrollPositionNone results in no scrolling, rather than the minimum scrolling described for that constant. To scroll to the newly selected row with minimum scrolling, select the row using this method with UITableViewScrollPositionNone, then call scrollToRowAtIndexPath:atScrollPosition:animated: with UITableViewScrollPositionNone.

NSIndexPath *rowToSelect;  // assume this exists and is set properly
UITableView *myTableView;  // assume this exists
 
[myTableView selectRowAtIndexPath:rowToSelect animated:YES scrollPosition:UITableViewScrollPositionNone];
[myTableView scrollToRowAtIndexPath:rowToSelect atScrollPosition:UITableViewScrollPositionNone animated:YES];

See Also

Selecting Rows

indexPathForSelectedRow

An index path identifying the row and section of the selected row.

indexPathsForSelectedRows

The index paths representing the selected rows.

- deselectRowAtIndexPath:animated:

Deselects a given row identified by index path, with an option to animate the deselection.

allowsSelection

A Boolean value that determines whether users can select a row.

allowsMultipleSelection

A Boolean value that determines whether users can select more than one row outside of editing mode.

allowsSelectionDuringEditing

A Boolean value that determines whether users can select cells while the table view is in editing mode.

allowsMultipleSelectionDuringEditing

A Boolean value that controls whether users can select more than one cell simultaneously in editing mode.

UITableViewSelectionDidChangeNotification

Posted when the selected row in the posting table view changes.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software