Contents

setHighlighted(_:animated:)

Sets the highlighted state of the cell, optionally animating the transition between states.

Declaration

func setHighlighted(_ highlighted: Bool, animated: Bool)

Parameters

  • highlighted:

    True to set the cell as highlighted, False to set it as unhighlighted. The default is False.

  • animated:

    True to animate the transition between highlighted states, False to make the transition immediate.

Discussion

Highlights or unhighlights the cell, animating the transition between regular and highlighted state if animated is YES. Highlighting affects the appearance of the cell’s labels, image, and background.

Note that for highlighting to work properly, you must fetch the cell’s label (or labels) using the textLabel (and detailTextLabel properties and set the label’s highlightedTextColor property; for images, get the cell’s image using the imageView property and set the UIImageView object’s highlightedImage property.

A custom table cell may override this method to make any transitory appearance changes.

See Also

Managing cell selection and highlighting