rectangle

Specifies the area within which an object is drawn.

# Metadata

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

# Syntax

set the rectangle of object to left, top, right, bottom

# Examples

set the rectangle of button "Tangle" to 20,20,45,200

set the rectangle of group 1 to the rectangle of this card

# 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 left, top, right, and bottom edges:

* The left is the number of pixels between the left edge of the stack window and the leftmost pixel of the object. * The top is the number of pixels between the top edge of the stack window and the topmost pixel of the object. * The right is the horizontal distance in pixels between the left edge of the stack window and the rightmost pixel of the object. * The bottom is the vertical distance in pixels between the top edge of the stack window and the bottommost pixel of the object.

>*Note:* The sides of an object rectangle specify the > lines > between pixels, not the pixels themselves. For example, if an > object 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 rectangle encloses all the pixels in > the graphic 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 vertex precisely with respect to > another > object 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 focus, 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.

# Tags

ui,

# See

- **keyword:** 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