QStaticText Class

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

[explicit] QStaticText::QStaticText(const QString &text)

使用给定的text 创建一个QStaticText对象。

QStaticText::QStaticText(const QStaticText &other)

创建一个 QStaticText 对象，该对象是other 的副本。

[noexcept] QStaticText::~QStaticText()

销毁QStaticText 。

QStaticText::PerformanceHint QStaticText::performanceHint() const

返回为QStaticText 设置了哪条性能提示。

另请参阅 setPerformanceHint()。

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

为QStaticText 对象做好绘制准备，使其能够使用给定的matrix 和font 进行绘制，从而在实际调用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 。