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)

other のコピーであるQStaticTextオブジェクトを作成します。

[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 として解釈されます。テキストのフォント、色、またはレイアウトを変更する HTML タグは、QStaticText によってサポートされています。

関連項目： 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 を返します。