Qt Reference Documentation

- Qt 4.8
- ALL VERSIONS

- A
- A
- A
- Print

# 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.

- List of all members, including inherited members

## 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

- 9 public functions inherited from Q3CanvasPolygonalItem
- 34 public functions inherited from Q3CanvasItem

## Reimplemented Protected Functions

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

- 6 protected functions inherited from Q3CanvasPolygonalItem
- 1 protected function inherited from Q3CanvasItem

## 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.