THE HYPERCARD CENTER

HyperTalk Reference

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

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

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.

dontSearch

Examples

Related Topics

Placeholders

field

trueOrFalse

card

bkgnd