MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

Q3CanvasPolygon Class Reference

The Q3CanvasPolygon class provides a polygon on a Q3Canvas. More...

 #include <Q3CanvasPolygon>

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.

Inherited by: Q3CanvasSpline.

Public Functions

Q3CanvasPolygon ( Q3Canvas * canvas )
~Q3CanvasPolygon ()
Q3PointArray points () const
void setPoints ( Q3PointArray pa )

Reimplemented Public Functions

virtual Q3PointArray areaPoints () const
virtual void moveBy ( double dx, double dy )
virtual int rtti () const

Reimplemented Protected Functions

virtual void drawShape ( QPainter & p )

Detailed Description

The Q3CanvasPolygon class provides a polygon on a Q3Canvas.

Paints a polygon with a QBrush. The polygon's points can be set in the constructor or set or changed later using setPoints(). Use points() to retrieve the points, or areaPoints() to retrieve the points relative to the canvas's origin.

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

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

Note: Q3CanvasPolygon does not use the pen.

See also QtCanvas and Porting to Graphics View.

Member Function Documentation

Q3CanvasPolygon::Q3CanvasPolygon ( Q3Canvas * canvas )

Constructs a point-less polygon on the canvas canvas. You should call setPoints() before using it further.

Q3CanvasPolygon::~Q3CanvasPolygon ()

Destroys the polygon.

Q3PointArray Q3CanvasPolygon::areaPoints () const [virtual]

Reimplemented from Q3CanvasPolygonalItem::areaPoints().

Returns the vertices of the polygon translated by the polygon's current x(), y() position, i.e. relative to the canvas's origin.

See also setPoints() and points().

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

Reimplemented from Q3CanvasPolygonalItem::drawShape().

Draws the polygon using the painter p.

Note that Q3CanvasPolygon does not support an outline (the pen is always NoPen).

void Q3CanvasPolygon::moveBy ( double dx, double dy ) [virtual]

Reimplemented from Q3CanvasItem::moveBy().

Q3PointArray Q3CanvasPolygon::points () const

Returns the vertices of the polygon, not translated by the position.

See also setPoints() and areaPoints().

int Q3CanvasPolygon::rtti () const [virtual]

Reimplemented from Q3CanvasItem::rtti().

Returns 4 (Q3CanvasItem::Rtti_Polygon).

See also Q3CanvasItem::rtti().

void Q3CanvasPolygon::setPoints ( Q3PointArray pa )

Sets the points of the polygon to be pa. These points will have their x and y coordinates automatically translated by x(), y() as the polygon is moved.

See also points().