Home
The HyperCard Center
HyperTalk Reference
Home » HyperTalk Reference » autoSelect

Note: This is a work in progress and many formatting issues have been fixed. Read more about the project on the home page.

autoSelect

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.

Related Topics

Placeholders

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] -- name
card 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: `me`
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.

trueOrFalse

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

For example:

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

HyperTalk Reference

Version 0.8b4 (July 4, 2025)

Made with Macintosh

Switch to Retro View