location

set [the] loc of button to point

set [the] loc of field to point

set [the] loc of window to point

set [the] loc of externalWindow to point

The location (or loc) property returns or sets the center point of a button or field and the top-left corner of a window. Setting the location of button, field, or window moves it to the new location.

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

For a window displaying a stack, HyperCard determines the location of the card window relative to the top-left corner of the screen with the menu bar.

HyperCard adjusts the horizontal offset of the card window to the closest multiple of 16 to the number specified.

Examples

the location of card button 1

the loc of bkgnd field id 34

set the loc of bkgnd button "Next" to the clickLoc

the loc of card window

-- built-in windows:

the loc of message box

the loc of tool window

-- external windows:

set the loc of window "Script of stack My HD:Home" to 100,100

Related Topics

Placeholders

button

An 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] -- name

bkgnd button posInteger [of card]

ordinal bkgnd button [of card]

card button id 3894

card button "Return"

card button 1

first card button

bkgnd button 2 of card 2

last bkgnd button

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.

An 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”.

point

An expression that evaluates to a specific screen location, in the form of two integers separated by a comma.

Item 1 of a point is the horizontal offset (in pixels). Item 2 of a point is the vertical offset (in pixels). For example:

91,303

"91,303"

"30" & "," & "100"

the clickLoc

An expression that evaluates to a specific screen location, in the form of a list with two integer elements. For example:

{ 91, 303 }

clickLoc

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:

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).

externalWindow

A window displayed by an external command or an external function; a window that’s not one of HyperCard’s built-in windows:

window "navigator"

window "Script of stack My HD:Home"

window "JT's Cool Palette"