Skip to main content

top

Type

property

Summary

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

Syntax

set the top of <object> to <numberOfPixels>

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 Mac OS or OS X system, be sure to allow 20 pixels at the top of the screen for the Mac OS menu bar.

Examples

set the top of card button 1 to 100
set the top of stack "message window" to (the bottom of this stack + 2)

command: group

glossary: object, property, OS X, error, absolute coordinates, menu bar, Mac OS, relative coordinates, negative

keyword: control, integer, rectangle, card

object: stack

property: script, pixels, yOffset, bottom

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile

Thank you for your feedback!

Was this page helpful?