top

Typeproperty
DictionaryLCS
LibraryLiveCode Script
Syntax
set the top of <object> to <numberOfPixels>
Associationsstack, card, field, button, graphic, scrollbar, player, image, group
Summary

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

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Example
set the top of card button 1 to 100
set the top of stack "message window" to (the bottom of this stack + 2)
Values
NameTypeDescription
Value

The top of an object is an integer. A negative integer indicates that the position is above the top of the screen or card (and therefore cannot be seen). A stack's top is the distance in pixels from the top edge of the screen to the top edge of the window's content area.

A card's or control's top is the distance in pixels from the top edge of the card to the top edge of the card or control.

RelatedKeyword: 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
Description

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

The top of a stack is in absolute (screen) coordinates(glossary). 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 (window) coordinates(glossary).

Changing the top of an object shifts it to the new position without resizing it. To change an object's 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 MacOS or OS X system, be sure to allow 20 pixels at the top of the screen for the Mac OS menu bar.

Tagsui