HyperTalk Reference
Home » HyperTalk Reference » Commands

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


unmark all cards
unmark card
unmark cards where trueOrFalse
unmark cards by finding      ¬
   [chars|word|whole|string] ¬
   [international]           ¬
text [in field ] [of marked cards]

The unmark command sets the marked property of the specified cards to false. Use it to deselect sets of cards that you have marked.
Unmark cards where visits each card in the stack and evaluates the expression. If its value is true, HyperCard unmarks the card. Unmark cards by finding unmarks cards using the same mechanism as the find command. It unmarks cards very quickly.


unmark card
unmark this card
unmark first card
unmark first marked card
unmark marked card 12
unmark all cards

unmark cards where field "title" contains "select"
unmark cards where (word 2 of field "Pages" = 1)
unmark cards where isCommand() -- function returns true or false
unmark cards by finding "Mary Lou"
unmark cards by finding "Mary Lou" in field 1
-- unmark only some of the marked cards:
unmark cards by finding "Mary Lou" in field 1 of marked cards

-- This handler only unmarks the marked cards:

on unMarkCards
   repeat with i = 1 to the number of cards
     set cursor to busy
     if (the marked of card i) then unmark card i
   end repeat
end unMarkCards


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
card id posInteger [of bkgnd ]card text [of bkgnd ] -- namecard posInteger [of bkgnd ] -- numberordinal card [of bkgnd ]position card [of bkgnd ]

ordinal marked cardposition marked cardmarked 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:
When a card receives a message:
[the] target
See also: button and field

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"

An expression that evaluates to a text string.

A text expression can be a literal string surrounded by quotation marks or the value of a container.

For example:

"The sum is:" && 3
card field 1
line 1 of bg fld "Address"
the Message box
the selection
myVar -- a variable
See also: background, bkgnd, button, card, field, menu, menuItem, and stack

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.

Related Topics

« unlock | HyperTalk Reference | visual »

Version 0.7b1 (March 24, 2022)

Made with Macintosh

Switch to Modern View