Qt:Документация 4.3.2/qpainter-qt3

Материал из Wiki.crossplatform.ru

Перейти к: навигация, поиск
40px Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

Image:qt-logo.png

Главная · Все классы · Основные классы · Классы по группам · Модули · Функции

Image:trolltech-logo.png

Содержание

[править] Qt 3 Support Members for QPainter

The following class members are part of the Qt 3 support layer. They are provided to help you port old code to Qt 4. We advise against using them in new code.



[править] Открытые функции

  • const QColor & backgroundColor () const
  • bool begin ( QPaintDevice * device, const QWidget * init )
  • QRect boundingRect ( const QRect & rectangle, int flags, const QString & text, int length )
  • QRect boundingRect ( int x, int y, int width, int height, int flags, const QString & text, int length )
  • void drawConvexPolygon ( const QPolygonF & polygon, int index, int count = -1 )
  • void drawConvexPolygon ( const QPolygon & polygon, int index, int count = -1 )
  • void drawCubicBezier ( const QPolygon & controlPoints, int index = 0 )
  • void drawLineSegments ( const QPolygon & polygon, int index = 0, int count = -1 )
  • void drawPoints ( const QPolygon & polygon, int index, int count = -1 )
  • void drawPolygon ( const QPolygonF & polygon, bool winding, int index = 0, int count = -1 )
  • void drawPolygon ( const QPolygon & polygon, bool winding, int index = 0, int count = -1 )
  • void drawPolyline ( const QPolygon & polygon, int index, int count = -1 )
  • void drawText ( int x, int y, const QString & text, int pos, int length )
  • void drawText ( const QPoint & point, const QString & text, int pos, int length )
  • void drawText ( int x, int y, const QString & text, int length )
  • void drawText ( const QPoint & point, const QString & text, int length )
  • void drawText ( const QRect & rectangle, int flags, const QString & text, int length, QRect * br = 0 )
  • void drawText ( int x, int y, int width, int height, int flags, const QString & text, int length, QRect * br = 0 )
  • bool hasViewXForm () const
  • bool hasWorldXForm () const
  • void resetXForm ()
  • void setBackgroundColor ( const QColor & color )
  • void setViewXForm ( bool enabled )
  • void setWorldXForm ( bool enabled )
  • qreal translationX () const
  • qreal translationY () const
  • QPoint xForm ( const QPoint & point ) const
  • QRect xForm ( const QRect & rectangle ) const
  • QPolygon xForm ( const QPolygon & polygon ) const
  • QPolygon xForm ( const QPolygon & polygon, int index, int count ) const
  • QPoint xFormDev ( const QPoint & point ) const
  • QRect xFormDev ( const QRect & rectangle ) const
  • QPolygon xFormDev ( const QPolygon & polygon ) const
  • QPolygon xFormDev ( const QPolygon & polygon, int index, int count ) const

[править] Статические открытые члены

  • void redirect ( QPaintDevice * pdev, QPaintDevice * replacement )
  • QPaintDevice * redirect ( QPaintDevice * pdev )

[править] Описание функций-членов

[править]
const QColor & QPainter::backgroundColor () const

Use background() and QBrush::color() instead.

For example, if you have code like

 QColor myColor = backgroundColor();

you can rewrite it as

 QColor myColor = background().color();

Note that the background can be a complex brush such as a texture or a gradient.

See also setBackgroundColor().

[править]
bool QPainter::begin ( QPaintDevice * device, const QWidget * init )

This is an overloaded member function, provided for convenience.

Use begin() instead.

If the paint device is a QWidget, QPainter is initialized after the widget's settings automatically. Otherwise, you must call the initFrom() function to initialize the painters pen, background and font to the same as any given widget.

For example, if you have code like

 QPainter painter(this);
 painter.begin(device, init);

you can rewrite it as

 QPainter painter(this);
 painter.begin(device);
 painter.initFrom(init);

[править]
QRect QPainter::boundingRect ( const QRect & rectangle, int flags, const QString & text, int length )

This is an overloaded member function, provided for convenience.

Returns the bounding rectangle for the given length of the text constrained by the provided rectangle.

Use boundingRect() combined with QString::left() instead.

For example, if you have code like

 QRect rectangle = boundingRect(rect, flags, text, length);

you can rewrite it as

 QRect rectangle = boundingRect(rect, flags, text.left(length));

[править]
QRect QPainter::boundingRect ( int x, int y, int width, int height, int flags, const QString & text, int length )

This is an overloaded member function, provided for convenience.

Returns the bounding rectangle for the given length of the text constrained by the rectangle that begins at point (x, y) with the given width and height.

Use boundingRect() combined with QString::left() instead.

For example, if you have code like

 QRect rectangle = boundingRect(x, y, width, height, flags, text, length);

you can rewrite it as

 QRect rectangle = boundingRect(x, y, width, height, flags, text.left(length));

[править]
void QPainter::drawConvexPolygon ( const QPolygonF & polygon, int index, int count = -1 )

This is an overloaded member function, provided for convenience.

Use drawConvexPolygon() combined with QPolygonF::constData() instead.

For example, if you have code like

 QPainter painter(this);
 painter.drawConvexPolygon(polygon, index, count);

you can rewrite it as

 int pointCount = (count == -1) ?  polygon.size() - index : count;
 
 QPainter painter(this);
 painter.drawConvexPolygon(polygon.constData() + index, pointCount);

[править]
void QPainter::drawConvexPolygon ( const QPolygon & polygon, int index, int count = -1 )

This is an overloaded member function, provided for convenience.

Use drawConvexPolygon() combined with QPolygon::constData() instead.

For example, if you have code like

 QPainter painter(this);
 painter.drawConvexPolygon(polygon, index, count);

you can rewrite it as

 int pointCount = (count == -1) ?  polygon.size() - index : count;
 
 QPainter painter(this);
 painter.drawConvexPolygon(polygon.constData() + index, pointCount);

[править]
void QPainter::drawCubicBezier ( const QPolygon & controlPoints, int index = 0 )

Draws a cubic Bezier curve defined by the controlPoints, starting at controlPoints'[index] (index defaults to 0). Points after controlPoints'[index + 3] are ignored. Nothing happens if there aren't enough control points.

Use strokePath() instead.

For example, if you have code like

 QPainter painter(this);
 painter.drawCubicBezier(controlPoints, index)

you can rewrite it as

 QPainterPath path;
 path.moveTo(controlPoints.at(index));
 path.cubicTo(controlPoints.at(index+1),
                     controlPoints.at(index+2),
                     controlPoints.at(index+3));
 
 QPainter painter(this);
 painter.strokePath(path, painter.pen());

[править]
void QPainter::drawLineSegments ( const QPolygon & polygon, int index = 0, int count = -1 )

Draws count separate lines from points defined by the polygon, starting at polygon'[index] (index defaults to 0). If count is -1 (the default) all points until the end of the array are used.

Use drawLines() combined with QPolygon::constData() instead.

For example, if you have code like

 QPainter painter(this);
 painter.drawLineSegments(polygon, index, count);

you can rewrite it as

 int lineCount = (count == -1) ?  (polygon.size() - index) / 2  : count;
 
 QPainter painter(this);
 painter.drawLines(polygon.constData() + index * 2, lineCount);

[править]
void QPainter::drawPoints ( const QPolygon & polygon, int index, int count = -1 )

This is an overloaded member function, provided for convenience.

Draws count points in the vector polygon starting on index using the current pen.

Use drawPoints() combined with QPolygon::constData() instead.

For example, if you have code like

 QPainter painter(this);
 painter.drawPoints(polygon, index, count);

you can rewrite it as

 int pointCount = (count == -1) ?  polygon.size() - index : count;
 
 QPainter painter(this);
 painter.drawPoints(polygon.constData() + index, pointCount);

[править]
void QPainter::drawPolygon ( const QPolygonF & polygon, bool winding, int index = 0, int count = -1 )

This is an overloaded member function, provided for convenience.

Use drawPolygon() combined with QPolygonF::constData() instead.

For example, if you have code like

 QPainter painter(this);
 painter.drawPolygon(polygon, winding, index, count);

you can rewrite it as

 int pointCount = (count == -1) ?  polygon.size() - index : count;
 int fillRule = winding ? Qt::WindingFill : Qt::OddEvenFill;
 
 QPainter painter(this);
 painter.drawPolygon( polygon.constData() + index, pointCount, fillRule);

[править]
void QPainter::drawPolygon ( const QPolygon & polygon, bool winding, int index = 0, int count = -1 )

This is an overloaded member function, provided for convenience.

Use drawPolygon() combined with QPolygon::constData() instead.

For example, if you have code like

 QPainter painter(this);
 painter.drawPolygon(polygon, winding, index, count);

you can rewrite it as

 int pointCount = (count == -1) ?  polygon.size() - index : count;
 int fillRule = winding ? Qt::WindingFill : Qt::OddEvenFill;
 
 QPainter painter(this);
 painter.drawPolygon( polygon.constData() + index, pointCount, fillRule);

[править]
void QPainter::drawPolyline ( const QPolygon & polygon, int index, int count = -1 )

This is an overloaded member function, provided for convenience.

Draws the polyline defined by the count lines of the given polygon starting at index (index defaults to 0).

Use drawPolyline() combined with QPolygon::constData() instead.

For example, if you have code like

 QPainter painter(this);
 painter.drawPolyline(polygon, index, count);

you can rewrite it as

 int pointCount = (count == -1) ?  polygon.size() - index : count;
 
 QPainter painter(this);
 painter.drawPolyline(polygon.constData() + index, pointCount);

[править]
void QPainter::drawText ( int x, int y, const QString & text, int pos, int length )

This is an overloaded member function, provided for convenience.

Use drawText() combined with QString::mid() instead.

For example, if you have code like

 QPainter painter(this);
 painter.drawText(x, y, text, pos, length);

you can rewrite it as

 QPainter painter(this);
 painter.drawText(x, y, text.mid(pos, length));

[править]
void QPainter::drawText ( const QPoint & point, const QString & text, int pos, int length )

This is an overloaded member function, provided for convenience.

Use drawText() combined with QString::mid() instead.

For example, if you have code like

 QPainter painter(this);
 painter.drawText(point, text, pos, length);

you can rewrite it as

 QPainter painter(this);
 painter.drawText(point, text.mid(pos, length));

[править]
void QPainter::drawText ( int x, int y, const QString & text, int length )

This is an overloaded member function, provided for convenience.

Use drawText() combined with QString::left() instead.

For example, if you have code like

 QPainter painter(this);
 painter.drawText(x, y, text, length);

you can rewrite it as

 QPainter painter(this);
 painter.drawText(x, y, text.left(length));

[править]
void QPainter::drawText ( const QPoint & point, const QString & text, int length )

This is an overloaded member function, provided for convenience.

Use drawText() combined with QString::left() instead.

For example, if you have code like

 QPainter painter(this);
 painter.drawText(point, text, length);

you can rewrite it as

 QPainter painter(this);
 painter.drawText(point, text.left(length));

[править]
void QPainter::drawText ( const QRect & rectangle, int flags, const QString & text, int length, QRect * br = 0 )

This is an overloaded member function, provided for convenience.

Use drawText() combined with QString::left() instead.

For example, if you have code like

 QPainter painter(this);
 painter.drawText(rectangle, flags, text, length, br );

you can rewrite it as

 QPainter painter(this);
 painter.drawText(rectangle, flags, text.left(length), br );

[править]
void QPainter::drawText ( int x, int y, int width, int height, int flags, const QString & text, int length, QRect * br = 0 )

This is an overloaded member function, provided for convenience.

Use drawText() combined with QString::left() instead.

For example, if you have code like

 QPainter painter(this);
 painter.drawText(x, y, width, height, flags, text, length, br );

you can rewrite it as

 QPainter painter(this);
 painter.drawText(x, y, width, height, flags, text.left(length), br );

[править]
bool QPainter::hasViewXForm () const

Use viewTransformEnabled() instead.

[править]
bool QPainter::hasWorldXForm () const

Use worldMatrixEnabled() instead.

[править]
void QPainter::redirect ( QPaintDevice * pdev, QPaintDevice * replacement ) [static]

Use setRedirected() instead.

[править]
QPaintDevice * QPainter::redirect ( QPaintDevice * pdev ) [static]

This is an overloaded member function, provided for convenience.

Use redirected() instead.

[править]
void QPainter::resetXForm ()

Use resetMatrix() instead.

[править]
void QPainter::setBackgroundColor ( const QColor & color )

Use setBackground() instead.

See also backgroundColor().

[править]
void QPainter::setViewXForm ( bool enabled )

Use setViewTransformEnabled() instead.

See also hasViewXForm().

[править]
void QPainter::setWorldXForm ( bool enabled )

Use setWorldMatrixEnabled() instead.

See also hasWorldXForm().

[править]
qreal QPainter::translationX () const

Use the worldMatrix() combined with QMatrix::dx() instead.

For example, if you have code like

 QPainter painter(this);
 qreal x = painter.translationX();

you can rewrite it as

 QPainter painter(this);
 qreal x = painter.worldMatrix().dx();

[править]
qreal QPainter::translationY () const

Use the worldMatrix() combined with QMatrix::dy() instead.

For example, if you have code like

 QPainter painter(this);
 qreal y = painter.translationY();

you can rewrite it as

 QPainter painter(this);
 qreal y = painter.worldMatrix().dy();

[править]
QPoint QPainter::xForm ( const QPoint & point ) const

Use combinedTransform() instead.

[править]
QRect QPainter::xForm ( const QRect & rectangle ) const

This is an overloaded member function, provided for convenience.

Use combinedTransform() instead of this function and call mapRect() on the result to obtain a QRect.

[править]
QPolygon QPainter::xForm ( const QPolygon & polygon ) const

This is an overloaded member function, provided for convenience.

Use combinedTransform() instead.

[править]
QPolygon QPainter::xForm ( const QPolygon & polygon, int index, int count ) const

This is an overloaded member function, provided for convenience.

Use combinedTransform() combined with QPolygon::mid() instead.

For example, if you have code like

 QPainter painter(this);
 QPolygon transformed = painter.xForm(polygon, index, count)

you can rewrite it as

 QPainter painter(this);
 QPolygon transformed = polygon.mid(index, count) * painter.combinedMatrix();

[править]
QPoint QPainter::xFormDev ( const QPoint & point ) const

Use combinedTransform() combined with QMatrix::inverted() instead.

For example, if you have code like

 QPainter painter(this);
 QPoint transformed = painter.xFormDev(point);

you can rewrite it as

 QPainter painter(this);
 QPoint transformed = point * painter.combinedMatrix().inverted();

[править]
QRect QPainter::xFormDev ( const QRect & rectangle ) const

This is an overloaded member function, provided for convenience.

Use combineMatrix() combined with QMatrix::inverted() instead.

For example, if you have code like

 QPainter painter(this);
 QRect transformed = painter.xFormDev(rectangle);

you can rewrite it as

 QPainter painter(this);
 QRect transformed = rectangle * painter.combinedMatrix().inverted();

[править]
QPolygon QPainter::xFormDev ( const QPolygon & polygon ) const

This is an overloaded member function, provided for convenience.

Use combinedMatrix() combined with QMatrix::inverted() instead.

For example, if you have code like

 QPainter painter(this);
 QPolygon transformed = painter.xFormDev(rectangle);

you can rewrite it as

 QPainter painter(this);
 QPolygon transformed = polygon * painter.combinedMatrix().inverted();

[править]
QPolygon QPainter::xFormDev ( const QPolygon & polygon, int index, int count ) const

This is an overloaded member function, provided for convenience.

Use combinedMatrix() combined with QPolygon::mid() and QMatrix::inverted() instead.

For example, if you have code like

 QPainter painter(this);
 QPolygon transformed = painter.xFormDev(polygon, index, count);

you can rewrite it as

 QPainter painter(this);
 QPolygon transformed = polygon.mid(index, count) * painter.combinedMatrix().inverted();

Copyright © 2007 Trolltech Trademarks
Qt 4.3.2