Qt Reference Documentation

Q3CanvasRectangle Class Reference

The Q3CanvasRectangle class provides a rectangle on a Q3Canvas. More...

 #include <Q3CanvasRectangle>

This class is part of the Qt 3 support library. It is provided to keep old source code working. We strongly advise against using it in new code. See Porting to Qt 4 for more information.

Inherits: Q3CanvasPolygonalItem.

Public Functions

Q3CanvasRectangle ( Q3Canvas * canvas )
Q3CanvasRectangle ( const QRect & r, Q3Canvas * canvas )
Q3CanvasRectangle ( int x, int y, int width, int height, Q3Canvas * canvas )
~Q3CanvasRectangle ()
int height () const
QRect rect () const
void setSize ( int width, int height )
QSize size () const
int width () const

Reimplemented Public Functions

virtual Q3PointArray areaPoints () const
virtual bool collidesWith ( const Q3CanvasItem * i ) const
virtual int rtti () const

Reimplemented Protected Functions

virtual Q3PointArray chunks () const
virtual void drawShape ( QPainter & p )

Detailed Description

The Q3CanvasRectangle class provides a rectangle on a Q3Canvas.

This item paints a single rectangle which may have any pen() and brush(), but may not be tilted/rotated. For rotated rectangles, use Q3CanvasPolygon.

The rectangle's size and initial position can be set in the constructor. The size can be set or changed later using setSize(). Use height() and width() to retrieve the rectangle's dimensions.

The rectangle can be drawn on a painter with drawShape().

Like any other canvas item rectangles can be moved with Q3CanvasItem::move() and Q3CanvasItem::moveBy(), or by setting coordinates with Q3CanvasItem::setX(), Q3CanvasItem::setY() and Q3CanvasItem::setZ().

See also QtCanvas and Porting to Graphics View.

Member Function Documentation

Q3CanvasRectangle::Q3CanvasRectangle ( Q3Canvas * canvas )

Constructs a rectangle at position (0,0) with both width and height set to 32 pixels on canvas.

Q3CanvasRectangle::Q3CanvasRectangle ( const QRect & r, Q3Canvas * canvas )

Constructs a rectangle positioned and sized by r on canvas.

Q3CanvasRectangle::Q3CanvasRectangle ( int x, int y, int width, int height, Q3Canvas * canvas )

Constructs a rectangle at position (x, y) and size width by height, on canvas.

Q3CanvasRectangle::~Q3CanvasRectangle ()

Destroys the rectangle.

Q3PointArray Q3CanvasRectangle::areaPoints () const [virtual]

Reimplemented from Q3CanvasPolygonalItem::areaPoints().

Q3PointArray Q3CanvasRectangle::chunks () const [virtual protected]

Simply calls Q3CanvasItem::chunks().

bool Q3CanvasRectangle::collidesWith ( const Q3CanvasItem * i ) const [virtual]

Reimplemented from Q3CanvasItem::collidesWith().

void Q3CanvasRectangle::drawShape ( QPainter & p ) [virtual protected]

Reimplemented from Q3CanvasPolygonalItem::drawShape().

Draws the rectangle on painter p.

int Q3CanvasRectangle::height () const

Returns the height of the rectangle.

QRect Q3CanvasRectangle::rect () const

Returns the integer-converted x(), y() position and size() of the rectangle as a QRect.

int Q3CanvasRectangle::rtti () const [virtual]

Reimplemented from Q3CanvasItem::rtti().

Returns 5 (Q3CanvasItem::Rtti_Rectangle).

See also Q3CanvasItem::rtti().

void Q3CanvasRectangle::setSize ( int width, int height )

Sets the width and height of the rectangle.

See also size().

QSize Q3CanvasRectangle::size () const

Returns the width() and height() of the rectangle.

See also rect() and setSize().

int Q3CanvasRectangle::width () const

Returns the width of the rectangle.