HyperTalk Reference
Home » HyperTalk Reference » Properties

Note: This is a work in progress and will be formatting errors. Read more about the project on the home page.


set [the] autoSelect of field ¬
     to trueOrFalse

The autoSelect property sets or returns whether lines in a locked field highlight automatically in response to a mouseDown event and to dragging or shift-clicking. (Such fields are called list fields .)

The autoSelect property corresponds to the Auto Select check box in a Field Info dialog box.

Automatic highlighting occurs if autoSelect, lockText, and dontWrap are all set to true.

AutoSelect is set to false when dontWrap is set to false; dontWrap is set to true when autoSelect is set to true.

For autoSelect to affect more than one line in a locked field, that field's multipleLines property must also be set to true.

To learn which lines are selected, get the selectedLine of field. To learn the contents of those lines, get the selectedText of field. To preselect, use select line x [to y] of field.


An expression that identifies a field by name, number, or id using one of the following forms (in AppleScript, use “background” in place of “bkgnd”):

card field id posInteger [of card ]card field text [of card ] -- namecard field posInteger [of card ]ordinal card field [of card ]

[bkgnd] field id posInteger [of card ][bkgnd] field text [of card ] -- name[bkgnd] field posInteger [of card ]ordinal [bkgnd] field [of card ]

For example:

card field id 3894
card field "My Notes"
card field 1
first card field
background field 3 of card 1
When used inside a field script in HyperTalk:
When a field receives a message:[the] target

A field can also be referred to as a part when you’re talking about its position among all buttons and fields within the same card or background.

Any expression that evaluates to the HyperTalk and AppleScript constants true or false.

For example:

the hilite of bg btn "Yes"
fld "Zip" contains "95014"
the short name of this stack is "Fred"

Related Topics

« autoHilite | HyperTalk Reference | autoTab »

Version 0.7b1 (March 24, 2022)

Made with Macintosh

Switch to Modern View