Show/Hide Toolbars

RiverSoftAVG Products Help

Defines a class to contain and perform calculations on a TRect. The advantage of using TRSCustomRect (and its descendant classes: RSGraphics.TRSObjectRect and RSGraphics.TObjectSize) is that the class can be used as a published property, where the user will be able to set the boundaries of the rectangle at design time.

The TRSCustomRect represents the dimensions of a rectangle. The coordinates are specified as four separate integers representing the left, top, right, and bottom sides.

Typically, values represent pixel locations, where the origin of the pixel coordinate system is in the top left corner of the screen (screen coordinates) or the top left corner of a control's client area (client coordinates). When a TRSCustomRect value represents a rectangle on the screen, by convention the top and left edges are considered inside the rectangle and the bottom and right edges are considered outside the rectangle. This convention allows the width of the rectangle to be Right - Left and the height to be Bottom - Top.

noteNote

The BoundsRect property represents the underlying TRect rectangle. You should use the provided properties; Left, Right, Top, Bottom, Width, and Height; to set the rectangle's fields. If you use the BoundsRect field's directly, the OnChange event will not be called.

Namespace: RSGraphics

TPersistent
  RSGraphics.TRSCustomRect
    RSGraphics.TObjectSize
    RSGraphics.TRSObjectRect
 

Delphi

type 
  TRSCustomRect = class(TPersistent) 
  end;  
 

 

Name

Description

public property

Bottom

Specifies the Bottom side of the rectangle.

Typically, rectangle values represent pixel locations, where the origin of the pixel coordinate system is in the top left corner of the screen (screen coordinates) or the top left corner of a control's client area (client coordinates). When a TRSCustomRect value represents a rectangle on the screen, by convention the top and left edges are considered inside the rectangle and the bottom and right edges are considered outside the rectangle. This convention allows the width of the rectangle to be Right - Left and the height to be Bottom - Top.

noteNote

Setting this property fires an     OnChange event. To avoid firing events, set the fields of the BoundsRect property directly.

public property

BoundsRect

Specifies the underlying TRect rectangle for the class.

You should use the provided properties;     Left, Right,     Top, Bottom,     Width, and Height; to set the rectangle's fields. If you use the BoundsRect field's directly, the OnChange event will not be called. However, setting the entire property (e.g., BoundsRect := Rect(0,0,10,10)) will fire the OnChange event,
 

public property

Height

Specifies the Height (Bottom-Top) of the rectangle.

Typically, rectangle values represent pixel locations, where the origin of the pixel coordinate system is in the top left corner of the screen (screen coordinates) or the top left corner of a control's client area (client coordinates). When a TRSCustomRect value represents a rectangle on the screen, by convention the top and left edges are considered inside the rectangle and the bottom and right edges are considered outside the rectangle. This convention allows the width of the rectangle to be Right - Left and the height to be Bottom - Top.

noteNote

Setting this property fires an     OnChange event. To avoid firing events, set the fields of the BoundsRect property directly.

public property

Left

Specifies the Left side of the rectangle.

Typically, rectangle values represent pixel locations, where the origin of the pixel coordinate system is in the top left corner of the screen (screen coordinates) or the top left corner of a control's client area (client coordinates). When a TRSCustomRect value represents a rectangle on the screen, by convention the top and left edges are considered inside the rectangle and the bottom and right edges are considered outside the rectangle. This convention allows the width of the rectangle to be Right - Left and the height to be Bottom - Top.

noteNote

Setting this property fires an     OnChange event. To avoid firing events, set the fields of the BoundsRect property directly.

public property

OnChange

Occurs when the rectangle's dimensions are changed through the class' properties or the transformation methods (   MoveTo, Scale , Translate ). If you change the BoundsRect's fields directly, an OnChange event will not occur. Write an OnChange event handler if you want to respond to changes in the rectangle.

noteNote

Note that the OnChange event is not published, either in this class or in RSGraphics.TRSObjectRect. This allows you to use the TRSCustomRect class to publish a rectangle and receive OnChange events at design-time (similar to publishing a TPen property).

public property

Right

Specifies the Right side of the rectangle.

Typically, rectangle values represent pixel locations, where the origin of the pixel coordinate system is in the top left corner of the screen (screen coordinates) or the top left corner of a control's client area (client coordinates). When a TRSCustomRect value represents a rectangle on the screen, by convention the top and left edges are considered inside the rectangle and the bottom and right edges are considered outside the rectangle. This convention allows the width of the rectangle to be Right - Left and the height to be Bottom - Top.

noteNote

Setting this property fires an     OnChange event. To avoid firing events, set the fields of the BoundsRect property directly.

public property

Top

Specifies the Top side of the rectangle.

Typically, rectangle values represent pixel locations, where the origin of the pixel coordinate system is in the top left corner of the screen (screen coordinates) or the top left corner of a control's client area (client coordinates). When a TRSCustomRect value represents a rectangle on the screen, by convention the top and left edges are considered inside the rectangle and the bottom and right edges are considered outside the rectangle. This convention allows the width of the rectangle to be Right - Left and the height to be Bottom - Top.

noteNote

Setting this property fires an     OnChange event. To avoid firing events, set the fields of the BoundsRect property directly.

public property

Width

Specifies the Width (Right-Left) of the rectangle.

Typically, rectangle values represent pixel locations, where the origin of the pixel coordinate system is in the top left corner of the screen (screen coordinates) or the top left corner of a control's client area (client coordinates). When a TRSCustomRect value represents a rectangle on the screen, by convention the top and left edges are considered inside the rectangle and the bottom and right edges are considered outside the rectangle. This convention allows the width of the rectangle to be Right - Left and the height to be Bottom - Top.

noteNote

Setting this property fires an     OnChange event. To avoid firing events, set the fields of the BoundsRect property directly.

Top

 

Name

Description

public method

Assign(TPersistent)

Represents method Assign(TPersistent).

protected method

Change

Represents method Change.

protected method

GetSize(Integer)

Represents method GetSize(Integer).

public method

MoveTo(Integer,Integer)

Moves the object rect Top, Left to the specified X,Y. It retains the width and height of the rectangle.

public method

Scale(Integer,Integer)

Scales the object rectangle by the specified DX, DY. The scaling is done from the rectangle's center point so Left, Right, Top, and Bottom all change.

protected method

SetBoundsRect(TRect)

Sets the BoundsRect property.

protected method

SetSize(Integer,Integer)

Represents method SetSize(Integer,Integer).

public method

Translate(Integer,Integer)

Moves the object rectangle Top, Left by the specified delta X and Y. It retains the width and height of the rectangle.

Top

Reference

•RSGraphics.TRSObjectRect

•RSGraphics.TObjectSize

•RSGraphics.TRSCustomRect.BoundsRect

•RSGraphics

RiverSoftAVG Products Help © 1996-2016 Thomas G. Grubb