Methods Index

CBounds

Heritage

Description

CBounds is a utility class representing an integer rectangle. In contrast to CRect, CBounds uses integer coordinates, which are more suitable for some applications, such as table-cell addressing. CBounds uses long for its coordinate representation so that it can support large coordinate spaces.

CBounds does not require that Bottom be greater than or equal to Top, nor that Right be greater than or equal to Left. Any rectangle is considered empty if Bottom is less than or equal to Top or if Right is less than or equal to Left.

Protected Data Members

long itsTop;
long itsLeft;
long itsBottom;
long itsRight;


`long`	`itsTop;`
`long`	`itsLeft;`
`long`	`itsBottom;`
`long`	`itsRight;`

Public Methods

Constructor Methods

CBounds();
CBounds(
	long theTop, long theLeft,
	long theBottom, long theRight);

Constructors. The compiler-supplied copy constructor and assignment operator are sufficient for the class.

Utility Methods

long Top() const;
long Left() const;
long Bottom() const;
long Right() const;
void Top(long theTop);
void Left(long theLeft);
void Bottom(long theBottom);
void Right(long theRight);

These methods access and change coordinates.

long Height() const;

Sets Right to be Left + Width.

long Width() const;

Sets Bottom to be Top + Height.

CCell TopLeft() const;
CCell TopRight() const;
CCell BottomLeft() const;
CCell BottomRight() const;

These methods get corners in terms of

CAttachmentFrame

Test and Operator Methods

BOOLEAN Contains(const CCell& theBounds) const;

Must completely contain theBounds. Edges may be equal. For example, a CBounds contains itself.

BOOLEAN IsEqual(const CBounds& theBounds) const;
int operator==(const CBounds& theBounds) const;

All edges must be equal.

BOOLEAN IsEmpty() const;

Bottom <= Top or Right <= Left.

CBounds Intersection(const CBounds& theBounds) const;

Returns the minimum of Right/Bottom and maximum of Top/Left.

CBounds Union(const CBounds& theBounds) const;

Returns the maximum of Right/Bottom and minimum of Top/Left.

CBounds Union(const CCell& theCell) const;

Expands CBounds to include theCell.

const CBounds& operator+=(const CCell& theCell);

Offsets CBounds to the right by theCell.H() and down by theCell.V().

const CBounds& operator-=(const CCell& theCell);

Offsets CBounds left by theCell.H() and up by theCell.V().

[Classes] [Prev] [Next] [Methods]

support@xvt.com