Livecode Wiki

Specifies the area within which an object is drawn.


set the rectangle of object to left,top,right,bottom
get the [effective] rect of object

Synonyms: rectangle


set the rect of button "Tangle" to 20,20,45,200
set the rectangle of group 1 to the rectangle of this card

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

The rectangle of an object consists of four integers separated by commas. (for example "0,0,20,80")

The four items of an object's rectangle describe the object's 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.

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.

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.

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.

See Also: export snapshot Command, crop Command, revChangeWindowSize Command, moveStack Message, margins Property, backSize Property, orientation Property, bottom Property, topRight Property, windowManagerPlace Property, liveResizing Property, clipsToRect Property, centerRect Property