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

実際の drawStaticText() 呼び出し時のオーバーヘッドを避けるため、与えられたmatrix と与えられたfont で描画されるQStaticText オブジェクトを準備する。

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)

QStaticText にother を割り当てる。

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

other をこのQStaticText と比較する。テキスト、フォント、テキスト幅が等しい場合はtrue を返す。