rectangle

Typeproperty
DictionaryLCS
LibraryLiveCode Script
Syntax
set the rectangle of <object> to <left>, <top>, <right>, <bottom>
get the [effective] rectangle of <object>
Synonymsrect
Associationsstack, card, field, button, graphic, scrollbar, player, image
Summary

Specifies the area within which an object is drawn.

Introduced1.0
Changes

The use of the effective keyword with the rectangle property was introduced in version 1.1. In previous versions, the rectangle of the defaultButton included the heavy outline.

OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Example
set the rectangle of button "Tangle" to 20,20,45,200
set the rectangle of group 1 to the rectangle of this card
Values
NameTypeDescription
Value

The rectangle of an object consists of four integers separated by commas.

RelatedKeyword: card, item, graphic
Property: bottom, topRight, pixels, points, defaultButton, width, showFocusBorder, height, backSize, orientation, margins, windowManagerPlace
Message: moveStack
Command: revChangeWindowSize, export snapshot, crop
Object: graphic
Glossary: object, property, keyword, focus, vertex, stack window, integer
Description

Use the rectangle property to find out how far an object extends, to move it, or to resize it.

The four items of an object's rectangle describe the object's left, top, right, and bottom edges:

Note: The sides of an object's rectangle specify the lines between pixels, not the pixels themselves. For example, if an object's rectangle is "0,0,2,2", the object includes four pixels, starting at the top left corner of the card. In the case of a line or curve graphic, the graphic's rectangle encloses all the pixels in the graphic's points property without touching any of them.

If the object is a stack, its rectangle is relative to the left and top of the screen, rather than the left and top of the stack window.

The first two items of a card's rectangle are always zero. The third item is the height of the card, and the fourth is the width of the card.

Note: The rectangle of a graphic is drawn around all its points without touching them. (Usually, this makes no difference, but in some circumstances where you need to place a graphic's vertex precisely with respect to another object's rectangle, you may need to take this into account.)

If you specify the effective keyword, the rectangle includes the outline added by the showFocusBorder property. It also includes the heavy outline added to the defaultButton. If the showFocusBorder of the object is false, or the object is not currently focused, the effective rectangle is the same as the rectangle.

Note:As of version 6.0 the effective rect property of stacks returns the rect of the given stack with its decorations and frame taken into account. The effective rect of a stack can also be set. Here, the rect of the frame of the stack will be set appropriately before setting the rect of the stack. The effective rect of a stack only returns valid values if the stack is open (visible or invisible) so that a window frame applicable to the OS has been created for it.

Tagsui