top

Specifies how far an object top edge is from the top of the window or screen.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

set the top of object to numberOfPixels

# Examples

set the top of card button 1 to 100

set the top of stack "message window" to (the bottom of this stack + 2)

# Description

Use the top property to change the vertical placement of a control or window.

The top of a stack is in absolute coordinates. The top of a card is always zero; setting the top of a card does not cause a script error, but it has no effect. The top of a group or control is in relative coordinates.

Changing the top of an object shifts it to the new position without resizing it. To change an object height, set its height or rectangle property.

The height property of an object is equal to its bottom minus its top.

>*Cross-platform note:* When setting the top of a window on a Mac OS> or OS X, be sure to allow 20 pixels at the top of > the screen for the Mac OS menu bar.

# Tags

ui,

# See

- **keyword:** control, integer, rectangle, card - **property:** script, pixels, yOffset, bottom - **command:** group - **object:** stack - **glossary:** object, property, OS X, error, absolute coordinates, menu bar, Mac OS, relative coordinates, negative