toggleHilites

Specifies whether clicking a selected line in a list field deselects that line.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

set the toggleHilites of field to {true | false}

# Examples

set the toggleHilites of field "Movies" to true

# Description

Use the toggleHilites property to control the behavior of list fields.

If a field's toggleHilites property is set to true, clicking a selected line deselects the line. If the toggleHilites is false, clicking a selected line does nothing.

If the field's listBehavior property is false, the setting of the toggleHilites property has no effect.

>*Important:* Setting the toggleHilites to true automatically sets > the field noncontiguousHilites and multipleHilites > properties to true. (However, setting the toggleHilites to false > does not set these properties back to false.) To set the > toggleHilites to true and the noncontiguousHilites or > multipleHilites to false, be sure to set the toggleHilites first, > then set the other properties to false.

# Tags

ui,

# See

- **keyword:** field - **property:** multipleHilites, toggleHilites, properties, listBehavior, selected, noncontiguousHilites, threeDHilite, hilitedLine - **object:** field - **glossary:** property, behavior, list field