Q3CanvasPolygonalItem Class Reference

Member Function Documentation

Q3CanvasPolygonalItem::Q3CanvasPolygonalItem ( Q3Canvas * canvas )

Constructs a Q3CanvasPolygonalItem on the canvas canvas.

Q3CanvasPolygonalItem::~Q3CanvasPolygonalItem () [virtual]

Note that all subclasses must call hide() in their destructor since hide() needs to be able to access areaPoints().

Q3PointArray Q3CanvasPolygonalItem::areaPoints () const [pure virtual]

This function must be reimplemented by subclasses. It must return the points bounding (i.e. outside and not touching) the shape or drawing errors will occur.

Q3PointArray Q3CanvasPolygonalItem::areaPointsAdvanced () const [virtual]

Returns the points the polygonal item will have after Q3CanvasItem::advance(1) is called, i.e. what the points are when advanced by the current xVelocity() and yVelocity().

QRect Q3CanvasPolygonalItem::boundingRect () const [virtual]

Reimplemented from Q3CanvasItem::boundingRect().

Returns the bounding rectangle of the polygonal item, based on areaPoints().

QBrush Q3CanvasPolygonalItem::brush () const

Returns the QBrush used to fill the item, if filled.

See also setBrush().

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

Reimplemented from Q3CanvasItem::collidesWith().

void Q3CanvasPolygonalItem::draw ( QPainter & p ) [virtual protected]

Reimplemented from Q3CanvasItem::draw().

Reimplemented from Q3CanvasItem, this draws the polygonal item by setting the pen and brush for the item on the painter p and calling drawShape().

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

Subclasses must reimplement this function to draw their shape. The pen and brush of p are already set to pen() and brush() prior to calling this function.

See also draw().

void Q3CanvasPolygonalItem::invalidate () [protected]

Invalidates all information about the area covered by the canvas item. The item will be updated automatically on the next call that changes the item's status, for example, move() or update(). Call this function if you are going to change the shape of the item (as returned by areaPoints()) while the item is visible.

bool Q3CanvasPolygonalItem::isValid () const [protected]

Returns true if the polygonal item's area information has not been invalidated; otherwise returns false.

See also invalidate().

QPen Q3CanvasPolygonalItem::pen () const

Returns the QPen used to draw the outline of the item, if any.

See also setPen().

int Q3CanvasPolygonalItem::rtti () const [virtual]

Reimplemented from Q3CanvasItem::rtti().

Returns 2 (Q3CanvasItem::Rtti_PolygonalItem).

See also Q3CanvasItem::rtti().

void Q3CanvasPolygonalItem::setBrush ( QBrush b ) [virtual]

Sets the QBrush used when drawing the polygonal item to the brush b.

See also setPen(), brush(), and drawShape().

void Q3CanvasPolygonalItem::setPen ( QPen p ) [virtual]

Sets the QPen used when drawing the item to the pen p. Note that many Q3CanvasPolygonalItems do not use the pen value.

See also setBrush(), pen(), and drawShape().

void Q3CanvasPolygonalItem::setWinding ( bool enable ) [protected]

If enable is true, the polygonal item will use the winding algorithm to determine the "inside" of the polygon; otherwise the odd-even algorithm will be used.

The default is to use the odd-even algorithm.

See also winding().

bool Q3CanvasPolygonalItem::winding () const [protected]

Returns true if the polygonal item uses the winding algorithm to determine the "inside" of the polygon. Returns false if it uses the odd-even algorithm.

The default is to use the odd-even algorithm.

See also setWinding().