QStaticText 类

class MyWidget: public QWidget
{
public:
    MyWidget(QWidget *parent = nullptr) : 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;
};

成员函数文档

QStaticText::QStaticText()

构建一个空的QStaticText

[显式] QStaticText::QStaticText(const QString &text)

构建一个具有给定文本的QStaticText对象。

QStaticText::QStaticText(const QStaticText &other)

构建一个复制自other的QStaticText对象。

[noexcept] QStaticText::~QStaticText()

销毁QStaticText。

QStaticText::PerformanceHint QStaticText::performanceHint() const

返回为QStaticText设置的哪个性能提示。

另请参阅setPerformanceHint。

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

将QStaticText对象准备好绘制，使用指定的matrix和指定字体，以避免在调用的drawStaticText()时产生开销。

当调用drawStaticText()时，如果自上次绘制以来QStaticText对象的任何部分已更改，则将重新计算QStaticText的布局。如果绘制器的字体与QStaticText上次绘制时的字体不同，或在这种情况下不是OpenGL2引擎的任何其他绘制引擎，且自上次绘制静态文本以来绘制器矩阵已更改，也会重新计算。

为了避免在第一次绘制QStaticText并做出更改后创建布局的开销，您可以使用prepare()函数并传入当绘制文本时预期的matrix和font。

另请参阅QPainter::setFont() 和 QPainter::setWorldTransform。

void QStaticText::setPerformanceHint(QStaticText::PerformanceHint performanceHint)

根据提供的 performanceHint 设置 QStaticText 的性能提示。该 performanceHint 用于自定义内部进行多少缓存，从而提高性能。

默认值为 QStaticText::ModerateCaching。

另请参阅 performanceHint。

void QStaticText::setText(const QString &text )

设置 QStaticText 的文本为 text。

另请参阅 text。

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

设置 QStaticText 的文本格式为 textFormat。如果 textFormat 设置为 Qt::AutoText （默认值），则使用函数 Qt::mightBeRichText 尝试确定文本的格式。如果文本格式为 Qt::PlainText，则文本将按原样显示；如果格式为 Qt::RichText，则文本将被解释为 HTML。QStaticText 支持改变文本字体、颜色或布局的 HTML 标签。

另请参阅 textFormat，setText 和 text。

void QStaticText::setTextOption(const QTextOption &textOption )

将控制布局过程的文本选项结构设置为给定的 textOption。

另请参阅 textOption。

void QStaticText::setTextWidth(qreal textWidth )

设置此 QStaticText 的首选宽度。如果文本比指定的宽度大，它将分为多行并垂直增长。如果文本不能分成多行，它将大于指定的 textWidth。

将首选文本宽度设置为负数将导致文本无界。

使用 size() 获取文本的实际大小。

另请参阅 textWidth 和 size。

QSizeF QStaticText::size() const

返回此 QStaticText 的边界矩形的尺寸。

另请参阅 textWidth。

[noexcept] void QStaticText::swap(QStaticText &other )

与 other 交换此静态文本实例。此函数非常快且永远不会失败。

QString QStaticText::text() const

返回 QStaticText 的文本。

另请参阅 setText。

Qt::TextFormat QStaticText::textFormat() const

返回 QStaticText 的文本格式。

另请参阅 setTextFormat()，setText() 和 text()。

QTextOption QStaticText::textOption() const

返回当前用于控制布局过程的文本选项。

另请参阅 setTextOption()。

qreal QStaticText::textWidth() const

返回此 QStaticText 的首选宽度。

另请参阅 setTextWidth()。

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

将 other 与此 QStaticText 进行比较。如果文本、字体或最大尺寸不同则返回 true。

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

将 other 赋值给此 QStaticText。

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

将 other 与此 QStaticText 进行比较。如果文本、字体和文本宽度相等则返回 true。