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;
};

Dokumentation der Mitgliedsfunktionen

QStaticText::QStaticText()

Konstruiert einen leeren QStaticText

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

Konstruiert ein QStaticText-Objekt mit dem angegebenen text.

QStaticText::QStaticText(const QStaticText &other)

Konstruiert ein QStaticText-Objekt, das eine Kopie von other ist.

[noexcept] QStaticText::~QStaticText()

Zerstört die QStaticText.

QStaticText::PerformanceHint QStaticText::performanceHint() const

Gibt zurück, welcher Performance-Hinweis für die QStaticText gesetzt ist.

Siehe auch setPerformanceHint().

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

Bereitet das Objekt QStaticText darauf vor, mit dem angegebenen matrix und dem angegebenen font gezeichnet zu werden, um Overhead zu vermeiden, wenn der eigentliche drawStaticText()-Aufruf erfolgt.

Wenn drawStaticText() aufgerufen wird, wird das Layout von QStaticText neu berechnet, wenn sich irgendein Teil des QStaticText Objekts seit dem letzten Mal, als es gezeichnet wurde, verändert hat. Es wird auch neu berechnet, wenn die Schriftart des Malers nicht die gleiche ist wie beim letzten Zeichnen von QStaticText, oder, auf jeder anderen Paint-Engine als der OpenGL2-Engine, wenn die Matrix des Malers seit dem letzten Zeichnen des statischen Textes geändert wurde.

Um den Overhead der Erstellung des Layouts beim ersten Zeichnen von QStaticText nach Änderungen zu vermeiden, können Sie die Funktion prepare() verwenden und die matrix und font übergeben, die Sie beim Zeichnen des Textes verwenden möchten.

Siehe auch QPainter::setFont() und QPainter::setWorldTransform().

void QStaticText::setPerformanceHint(QStaticText::PerformanceHint performanceHint)

Legt den Leistungshinweis von QStaticText entsprechend dem angegebenen performanceHint fest. Die performanceHint wird verwendet, um den Umfang der internen Zwischenspeicherung zur Verbesserung der Leistung anzupassen.

Der Standardwert ist QStaticText::ModerateCaching.

Siehe auch performanceHint().

void QStaticText::setText(const QString &text)

Setzt den Text der Seite QStaticText auf text.

Siehe auch text().

void QStaticText::setTextFormat(Qt::TextFormat textFormat)

Setzt das Textformat von QStaticText auf textFormat. Wenn textFormat auf Qt::AutoText (Standardeinstellung) gesetzt ist, wird versucht, das Format des Textes mit der Funktion Qt::mightBeRichText() zu ermitteln. Wenn das Textformat Qt::PlainText ist, wird der Text so angezeigt, wie er ist, während er als HTML interpretiert wird, wenn das Format Qt::RichText ist. HTML-Tags, die die Schriftart des Textes, seine Farbe oder sein Layout verändern, werden von QStaticText unterstützt.

Siehe auch textFormat(), setText(), und text().

void QStaticText::setTextOption(const QTextOption &textOption)

Setzt die Textoptionsstruktur, die den Layoutprozess steuert, auf die angegebene textOption.

Siehe auch textOption().

void QStaticText::setTextWidth(qreal textWidth)

Legt die bevorzugte Breite für diese QStaticText fest. Wenn der Text breiter ist als die angegebene Breite, wird er in mehrere Zeilen aufgeteilt und wächst vertikal. Wenn der Text nicht in mehrere Zeilen aufgeteilt werden kann, wird er größer als die angegebene textWidth.

Wenn Sie die bevorzugte Textbreite auf eine negative Zahl setzen, wird der Text nicht begrenzt.

Verwenden Sie size(), um die tatsächliche Größe des Textes zu ermitteln.

Siehe auch textWidth() und size().

QSizeF QStaticText::size() const

Gibt die Größe des Begrenzungsrechtecks für dieses QStaticText zurück.

Siehe auch textWidth().

[noexcept] void QStaticText::swap(QStaticText &other)

Tauscht diese statische Textinstanz mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

QString QStaticText::text() const

Gibt den Text der Seite QStaticText zurück.

Siehe auch setText().

Qt::TextFormat QStaticText::textFormat() const

Gibt das Textformat von QStaticText zurück.

Siehe auch setTextFormat(), setText(), und text().

QTextOption QStaticText::textOption() const

Gibt die aktuelle Textoption zurück, die zur Steuerung des Layout-Prozesses verwendet wird.

Siehe auch setTextOption().

qreal QStaticText::textWidth() const

Gibt die bevorzugte Breite für diese QStaticText zurück.

Siehe auch setTextWidth().

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

Vergleicht other mit dieser QStaticText. Gibt true zurück, wenn die Texte, Schriftarten oder maximalen Größen unterschiedlich sind.

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

Weist other dieser QStaticText zu.

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

Vergleicht other mit diesem QStaticText. Gibt true zurück, wenn die Texte, Schriftarten und Textbreiten gleich sind.