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)

other をこのQStaticText に代入します。

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

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