class MyWidget: public QWidget
{
public:
    MyWidget(QWidget *parent = 0) : QWidget(parent), m_staticText("This is static text")

protected:
    void paintEvent(QPaintEvent *)
    {
        QPainter painter(this);
        painter.drawStaticText(0, 0, m_staticText);
    }

private:
    QStaticText m_staticText;
};

Member Function Documentation

QStaticText::QStaticText()

Constructs an empty QStaticText

QStaticText::QStaticText(const QString &text)

Constructs a QStaticText object with the given text.

QStaticText::QStaticText(const QStaticText &other)

Constructs a QStaticText object which is a copy of other.

QStaticText::~QStaticText()

Destroys the QStaticText.

PerformanceHint QStaticText::performanceHint() const

Returns which performance hint is set for the QStaticText.

See also setPerformanceHint().

void QStaticText::prepare(const QTransform &matrix = QTransform(), const QFont &font = QFont())

Prepares the QStaticText object for being painted with the given matrix and the given font to avoid overhead when the actual drawStaticText() call is made.

When drawStaticText() is called, the layout of the QStaticText will be recalculated if any part of the QStaticText object has changed since the last time it was drawn. It will also be recalculated if the painter's font is not the same as when the QStaticText was last drawn, or, on any other paint engine than the OpenGL2 engine, if the painter's matrix has been altered since the static text was last drawn.

To avoid the overhead of creating the layout the first time you draw the QStaticText after making changes, you can use the prepare() function and pass in the matrix and font you expect to use when drawing the text.

See also QPainter::setFont() and QPainter::setMatrix().

void QStaticText::setPerformanceHint(PerformanceHint performanceHint)

Sets the performance hint of the QStaticText according to the performanceHint provided. The performanceHint is used to customize how much caching is done internally to improve performance.

The default is QStaticText::ModerateCaching.

Note: This function will cause the layout of the text to require recalculation.

See also performanceHint().

void QStaticText::setText(const QString &text)

Sets the text of the QStaticText to text.

Note: This function will cause the layout of the text to require recalculation.

See also text().

void QStaticText::setTextFormat(Qt::TextFormat textFormat)

Sets the text format of the QStaticText to textFormat. If textFormat is set to Qt::AutoText (the default), the format of the text will try to be determined using the function Qt::mightBeRichText(). If the text format is Qt::PlainText, then the text will be displayed as is, whereas it will be interpreted as HTML if the format is Qt::RichText. HTML tags that alter the font of the text, its color, or its layout are supported by QStaticText.

Note: This function will cause the layout of the text to require recalculation.

See also textFormat(), setText(), and text().

void QStaticText::setTextOption(const QTextOption &textOption)

Sets the text option structure that controls the layout process to the given textOption.

See also textOption().

void QStaticText::setTextWidth(qreal textWidth)

Sets the preferred width for this QStaticText. If the text is wider than the specified width, it will be broken into multiple lines and grow vertically. If the text cannot be split into multiple lines, it will be larger than the specified textWidth.

Setting the preferred text width to a negative number will cause the text to be unbounded.

Use size() to get the actual size of the text.

Note: This function will cause the layout of the text to require recalculation.

See also textWidth() and size().

QSizeF QStaticText::size() const

Returns the size of the bounding rect for this QStaticText.

See also textWidth().

void QStaticText::swap(QStaticText &other)

Swaps this static text instance with other. This function is very fast and never fails.

This function was introduced in Qt 5.0.

QString QStaticText::text() const

Returns the text of the QStaticText.

See also setText().

Qt::TextFormat QStaticText::textFormat() const

Returns the text format of the QStaticText.

See also setTextFormat(), setText(), and text().

QTextOption QStaticText::textOption() const

Returns the current text option used to control the layout process.

See also setTextOption().

qreal QStaticText::textWidth() const

Returns the preferred width for this QStaticText.

See also setTextWidth().

bool QStaticText::operator!=(const QStaticText &other) const

Compares other to this QStaticText. Returns true if the texts, fonts or maximum sizes are different.

QStaticText &QStaticText::operator=(QStaticText &&other)

Move-assignment operator.

QStaticText &QStaticText::operator=(const QStaticText &other)

Assigns other to this QStaticText.

bool QStaticText::operator==(const QStaticText &other) const

Compares other to this QStaticText. Returns true if the texts, fonts and text widths are equal.