Note: This is a work in progress and will be formatting errors. Read more about the project on the home page.
Referring to objects
You can refer to HyperCard objects and other elements from a script in any of several ways.
Click Tips for a list of synonyms that you can use for referring to objects.
An object’s name is the value found in its Info dialog box. For example:
background button "Home"
It’s a good idea to use quotation marks around an object’s name so that HyperCard recognizes it literally and doesn’t look for a variable by that name.
Note: HyperCard interprets card "1812" as a card named 1812; it interprets card 1812 as card number 1812.
An object’s number represents its position among like objects within the object that contains it.
Buttons and fields are ordered within a card or background. Cards and backgrounds are ordered within a stack.
go to card 2
Changing the order of a button, field, card, or background changes its number.
An object or menu's ID is a unique number assigned by HyperCard. Object ID numbers never change. The Info dialog box for each object displays its ID. (Stacks don't have ID's.)
go to card id 5734
A program's ID is its application signature:
put the id of HyperCard -- -> WILD
Part refers to a specific button or field in its ordinal position among all the buttons and fields in that domain:
select part 2
if word 2 of name of part 1 is "button"...
get the name of part 1
set the partNumber of last part to 1
put the number of parts into totalCardParts
put the id of bg part 3 into field idList
If you don't specify a domain, the default domain is card.
You can refer to an object using any of the following ordinals:
first through tenth
middle, last, any
go to first card of last background
You can refer to some objects using any of the following positions:
next, prev, previous, this
go to first card of this background
go next card
Me is one way to refer to an object dynamically. It refers to the object that contains the currently executing handler. With buttons and fields, me refers to the object itself or to its contents, depending on the context. For example:
--In the script of a button:
set the hilite of me to true -- the button
get me -- the contents
--In the script of a field:
select text of me -- selects the field text
select me -- selects the field itself
put empty into me -- replaces the contents
The target is another way to refer to an object dynamically. It refers to the object that first received the message currently being handled.
With buttons and fields, use the target to refer to the field itself and target to refer to its contents.
set the hilite of the target to true
select the target --the btn or fld itself
put target --the contents of the btn or fld
put the target --the name of the btn or fld
Version 0.7b1 (March 24, 2022)
Switch to Modern View