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

Documentation des fonctions membres

QStaticText::QStaticText()

Construit un QStaticText vide

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

Construit un objet QStaticText avec l'adresse text.

QStaticText::QStaticText(const QStaticText &other)

Construit un objet QStaticText qui est une copie de other.

[noexcept] QStaticText::~QStaticText()

Détruit le site QStaticText.

QStaticText::PerformanceHint QStaticText::performanceHint() const

Renvoie l'indice de performance défini pour le site QStaticText.

Voir aussi setPerformanceHint().

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

Prépare l'objet QStaticText à être peint avec les objets matrix et font afin d'éviter les surcharges lors de l'appel à la fonction drawStaticText().

Lorsque drawStaticText() est appelé, la disposition de l'objet QStaticText est recalculée si une partie de l'objet QStaticText a été modifiée depuis la dernière fois qu'elle a été dessinée. Elle sera également recalculée si la police du peintre n'est pas la même que celle utilisée lors du dernier dessin de QStaticText, ou, sur tout autre moteur de peinture que le moteur OpenGL2, si la matrice du peintre a été modifiée depuis que le texte statique a été dessiné pour la dernière fois.

Pour éviter d'avoir à créer la mise en page la première fois que vous dessinez le site QStaticText après l'avoir modifié, vous pouvez utiliser la fonction prepare() et lui transmettre les adresses matrix et font que vous prévoyez d'utiliser pour dessiner le texte.

Voir également QPainter::setFont() et QPainter::setWorldTransform().

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

Définit l'indice de performance de QStaticText en fonction de performanceHint fourni. performanceHint est utilisé pour personnaliser le niveau de mise en cache interne afin d'améliorer les performances.

La valeur par défaut est QStaticText::ModerateCaching.

Voir aussi performanceHint().

void QStaticText::setText(const QString &text)

Fixe le texte du site QStaticText à text.

Voir aussi text().

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

Définit le format de texte de QStaticText à textFormat. Si textFormat est défini à Qt::AutoText (par défaut), le format du texte tentera d'être déterminé à l'aide de la fonction Qt::mightBeRichText(). Si le format du texte est Qt::PlainText, le texte sera affiché tel quel, alors qu'il sera interprété comme du HTML si le format est Qt::RichText. Les balises HTML qui modifient la police du texte, sa couleur ou sa mise en page sont prises en charge par QStaticText.

Voir également textFormat(), setText() et text().

void QStaticText::setTextOption(const QTextOption &textOption)

Définit la structure d'option de texte qui contrôle le processus de mise en page à l'adresse textOption.

Voir aussi textOption().

void QStaticText::setTextWidth(qreal textWidth)

Définit la largeur préférée pour ce site QStaticText. Si le texte est plus large que la largeur spécifiée, il sera divisé en plusieurs lignes et s'étendra verticalement. Si le texte ne peut pas être divisé en plusieurs lignes, il sera plus grand que la largeur spécifiée textWidth.

Si la largeur préférée du texte est définie sur un nombre négatif, le texte ne sera pas délimité.

Utilisez size() pour obtenir la taille réelle du texte.

Voir également textWidth() et size().

QSizeF QStaticText::size() const

Renvoie la taille du rectangle de délimitation pour cette QStaticText.

Voir également textWidth().

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

Remplace cette instance de texte statique par other. Cette opération est très rapide et n'échoue jamais.

QString QStaticText::text() const

Renvoie le texte de QStaticText.

Voir aussi setText().

Qt::TextFormat QStaticText::textFormat() const

Renvoie le format de texte de la page QStaticText.

Voir aussi setTextFormat(), setText(), et text().

QTextOption QStaticText::textOption() const

Renvoie l'option de texte courante utilisée pour contrôler le processus de mise en page.

Voir aussi setTextOption().

qreal QStaticText::textWidth() const

Renvoie la largeur préférée pour cette QStaticText.

Voir aussi setTextWidth().

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

Compare other à QStaticText. Renvoie true si les textes, les polices ou les tailles maximales sont différents.

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

Attribue other à ce QStaticText.

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

Compare other à QStaticText. Renvoie true si les textes, les polices et les largeurs de texte sont identiques.