Home
The HyperCard Center
HyperTalk Reference
Home » HyperTalk Reference » dontSearch

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

dontSearch

set [the] dontSearch of field ¬
to trueOrFalse
set [the] dontSearch of card ¬
to trueOrFalse
set [the] dontSearch of bkgnd ¬
to trueOrFalse

The dontSearch property returns or sets whether HyperCard’s find command will look for matches in a field, card, or background. It corresponds to the Don’t Search check box in the Field Info, Card Info, and Background Info dialog boxes.

Examples

set the dontSearch of bkgnd field 1 to true
set the dontSearch of this card to false
set the dontSearch of bkgnd "Index" to true

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"

card

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

recent card
back
forth
card id posInteger [of bkgnd
card text [of bkgnd] -- name
card posInteger [of bkgnd] -- number
ordinal card [of bkgnd]
position card [of bkgnd]
ordinal marked card
position marked card
marked card posInteger

For example:

card id 3894
card "Index"
card 1 of background 1
prev card
previous card of this background
next card
this card
first card
last card
middle card
any card
first marked card
last marked card
next marked card
previous marked card
marked card 1
marked card (the number of marked cards)

When used inside a card script in HyperTalk: me

When a card receives a message: [the] target

See also: button and field

bkgnd

A HyperTalk expression that identifies a background by name, number, or id, using one of the following forms:

bkgnd id posInteger
bkgnd text -- name
bkgnd posInteger -- number
ordinal bkgnd
position bkgnd

For example:

bkgnd id 3894
bkgnd "Index"
bkgnd 1
prev bkgnd
previous bkgnd
next bkgnd
this bkgnd
first bkgnd
last bkgnd
middle bkgnd
any bkgnd

From within a background script, the term me refers to that background.

When a background receives a the message [the] target, that message is referring to the background.

See also: card

HyperTalk Reference

Version 0.8b4 (July 4, 2025)

Made with Macintosh

Switch to Retro View