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

top

the top of card
set [the] top of button to Integer
set [the] top of field to Integer
set [the] top of window to Integer
set [the] top of menuBar

The top property returns or sets an integer equal to item 2 of an element’s rectangle. If you set the top of an object, it moves vertically; the object's size remains the same. You can’t set the top of cards: use the rect, height, and width properties to resize the cards in a stack.

You can't set the top of the menu bar.

HyperCard determines the top of buttons, fields, and HyperCard’s built-in windows relative to the top-left corner of the current card.

HyperCard determines the top of the card window relative to the top-left corner of the screen with the menu bar.

Examples

the top of card button 1
the top of bkgnd field id 34
the top of this card
the top of message box
the top of tool window
the top of card window

set the top of bkgnd button "Next" to the top of bg btn "Prev"

Placeholders

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 ] -- 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:

me

When a card receives a message:

[the] target

See also: button and field

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

[card] button id posInteger [of card ][card] button text [of card ] -- name[card] button posInteger [of card ]ordinal [card] button [of card ]





bkgnd

button id posInteger [of card ]bkgnd button text [of card ] -- namebkgnd button posInteger [of card ]ordinal bkgnd button [of card ]For example:

card button id 3894
card button "Return"
card button 1
first card button
bkgnd button 2 of card 2
last bkgnd button

When used inside a button script:

me

When a button receives a message:

[the] target

A button 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.

AppleScript DefinitionAn expression that identifies a button by name, number, or id, using the same forms as HyperTalk except that “background” must be used in place of “bkgnd”.

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 ] -- 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:

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.

window
One of HyperCard’s built-in windows, the window containing the current stack (called the card window), or any other window containing a stack, as follows:

card window
tool window
window "tools"
pattern window
window "Patterns"
scroll window
window "scroll"
[the] message [window]
[the] message [box]
[the] msg [window]
[the] msg [box]
window "message"
message watcher
window "message watcher"
variable watcher
window "variable watcher"
window "Home"
window "Readymade Buttons"
-- if longWindowTitles is true:
window "My HD:Home"
window 6
window ID 21403082

Note: If a window containing a stack is inactive, you can set only its location and visible properties. Important: External windows can’t be substituted for the window placeholder (see the externalWindow placeHolder).

top

Examples

Placeholders

Related Topics