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())

为使用给定的matrix 和font 绘制QStaticText 对象做准备，以避免实际调用 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 。