multipleHilites

Specifies whether more than one line can be selected in a list field.

# Metadata

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

# Syntax

set the multipleHilites of field to {true | false}

# Examples

set the multipleHilites of field "myField" to true

# Description

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

If the multipleHilites of a field is set to true, the user can select more than one line by dragging within the field, or Shift-clicking to select all the lines between the selected line and the clicked line. If the multipleHilites is false, clicking a line deselects any other lines in the field.

If the field's listBehavior property is false, the multipleHilites property has no effect.

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

# Tags

ui,

# See

- **keyword:** field, line - **property:** hilitedLine, listBehavior, toggleHilites, noncontiguousHilites, selected - **command:** select - **object:** field - **glossary:** property, behavior, list field