noncontiguousHilites

Specifies whether the user can select non-adjacent lines of a list field.

# Metadata

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

# Syntax

set the noncontiguousHilites of field to {true | false}

# Examples

set the noncontiguousHilites of field "Parties" to true

# Description

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

If a list field's noncontiguousHilites property is false, the user can select multiple lines only if they're next to each other.

If the noncontiguousHilites is true, the user can select multiple lines, wherever they occur in the field. The user makes a multiple choice from a list field by Command-clicking the desired lines (on Mac OS) or Control-clicking (on Unix and Windows).

If the field's listBehavior is not set to true, this property has no effect.

>*Important:* Setting the toggleHilites to true automatically sets > the field noncontiguousHilites 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 > noncontiguousHilites to false, be sure to set the toggleHilites > first, then set the noncontiguousHilites to false.

# Tags

ui,

# See

- **keyword:** field, lines - **property:** hilitedLine, listBehavior, toggleHilites, threeDHilite, multipleHilites - **command:** select - **object:** field - **glossary:** property, Unix, list field, Windows, behavior, Mac OS