Sur cette page

QTextOption Class

La classe QTextOption fournit une description des propriétés générales du texte riche. Plus d'informations...

En-tête : #include <QTextOption>
CMake : find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake : QT += gui

Remarque : toutes les fonctions de cette classe sont réentrantes.

Types publics

struct Tab
enum Flag { IncludeTrailingSpaces, ShowTabsAndSpaces, ShowLineAndParagraphSeparators, ShowDocumentTerminator, ShowDefaultIgnorables, …, DisableEmojiParsing }
flags Flags
enum TabType { LeftTab, RightTab, CenterTab, DelimiterTab }
enum WrapMode { NoWrap, WordWrap, ManualWrap, WrapAnywhere, WrapAtWordBoundaryOrAnywhere }

Fonctions publiques

QTextOption()
QTextOption(Qt::Alignment alignment)
QTextOption(const QTextOption &other)
~QTextOption()
Qt::Alignment alignment() const
QTextOption::Flags flags() const
void setAlignment(Qt::Alignment alignment)
void setFlags(QTextOption::Flags flags)
void setTabArray(const QList<qreal> &tabStops)
void setTabStopDistance(qreal tabStopDistance)
void setTabs(const QList<QTextOption::Tab> &tabStops)
void setTextDirection(Qt::LayoutDirection direction)
void setUseDesignMetrics(bool enable)
void setWrapMode(QTextOption::WrapMode mode)
QList<qreal> tabArray() const
qreal tabStopDistance() const
QList<QTextOption::Tab> tabs() const
Qt::LayoutDirection textDirection() const
bool useDesignMetrics() const
QTextOption::WrapMode wrapMode() const
QTextOption &operator=(const QTextOption &other)

Description détaillée

QTextOption est utilisé pour encapsuler les propriétés courantes du texte riche dans un seul objet. Elle contient des informations sur l'alignement du texte, la direction de la mise en page, l'habillage des mots et d'autres propriétés standard associées au rendu et à la mise en page du texte.

Voir également QTextEdit, QTextDocument, et QTextCursor.

Documentation des types de membres

enum QTextOption::Flag
flags QTextOption::Flags

ConstanteValeurDescription de l'option
QTextOption::IncludeTrailingSpaces0x80000000Lorsque cette option est activée, QTextLine::naturalTextWidth() et naturalTextRect() renvoient une valeur qui inclut la largeur des espaces de fin de texte ; dans le cas contraire, cette largeur est exclue.
QTextOption::ShowTabsAndSpaces0x1Les espaces sont représentés par des petits points et les tabulations par des petites flèches. Les espaces insécables sont représentés différemment des espaces sécables.
QTextOption::ShowLineAndParagraphSeparators0x2Les séparateurs de lignes et de paragraphes sont représentés par des symboles appropriés.
QTextOption::ShowDocumentTerminator (since Qt 5.7)0x10Visualisez la fin du document avec un signe de section.
QTextOption::ShowDefaultIgnorables (since Qt 6.9)0x20Rendre normalement les caractères non visuels si la police le permet.
QTextOption::AddSpaceForLineAndParagraphSeparators0x4Lors de la détermination de la position des sauts de ligne, tenez compte de l'espace ajouté pour dessiner un caractère de séparation.
QTextOption::SuppressColors0x8Supprimer tous les changements de couleur dans les formats de caractères (à l'exception de la sélection principale).
QTextOption::DisableEmojiParsing (since Qt 6.9)0x40Par défaut, Qt détectera les séquences emoji dans les chaînes d'entrée et utilisera en priorité des polices de couleur pour les afficher. Cette étape supplémentaire peut être désactivée en activant le drapeau DisableEmojiParsing si l'on sait à l'avance qu'elle ne sera pas nécessaire.

Le type Flags est un typedef pour QFlags<Flag>. Il stocke une combinaison OU de valeurs de drapeaux.

enum QTextOption::TabType

Cette énumération contient les différents types de tabulateurs.

ConstanteValeurDescription du tabulateur
QTextOption::LeftTab0Un tabulateur gauche
QTextOption::RightTab1Un tabulateur droit
QTextOption::CenterTab2Un onglet centré
QTextOption::DelimiterTab3Une tabulation s'arrêtant à un certain caractère de délimitation

enum QTextOption::WrapMode

Cette énumération décrit la manière dont le texte est enveloppé dans un document.

ConstanteValeurDescription
QTextOption::NoWrap0Le texte n'est pas enveloppé du tout.
QTextOption::WordWrap1Le texte est enveloppé à la limite des mots.
QTextOption::ManualWrap2Identique à QTextOption::NoWrap
QTextOption::WrapAnywhere3Le texte peut être enveloppé à n'importe quel endroit de la ligne, même s'il se trouve au milieu d'un mot.
QTextOption::WrapAtWordBoundaryOrAnywhere4Si possible, l'habillage se fait à la limite d'un mot, sinon il se fait à l'endroit approprié sur la ligne, même au milieu d'un mot.

Documentation des fonctions membres

QTextOption::QTextOption()

Construit une option de texte avec les propriétés par défaut du texte. La propriété d'alignement du texte est fixée à Qt::AlignLeft. La propriété de retour à la ligne est fixée à QTextOption::WordWrap. L'indicateur d'utilisation des métriques de conception est fixé à false.

QTextOption::QTextOption(Qt::Alignment alignment)

Construit une option de texte avec l'adresse alignment donnée pour le texte. La propriété word wrap est fixée à QTextOption::WordWrap. L'indicateur using of design metrics est fixé à false.

QTextOption::QTextOption(const QTextOption &other)

Construire une copie de l'option de texte other.

[noexcept] QTextOption::~QTextOption()

Détruit l'option de texte.

Qt::Alignment QTextOption::alignment() const

Renvoie l'alignement du texte défini par l'option.

Voir aussi setAlignment().

QTextOption::Flags QTextOption::flags() const

Renvoie les drapeaux associés à l'option.

Voir aussi setFlags().

void QTextOption::setAlignment(Qt::Alignment alignment)

Définit l'alignement du texte de l'option sur la valeur spécifiée alignment.

Voir également alignment().

void QTextOption::setFlags(QTextOption::Flags flags)

Fixe les drapeaux associés à l'option à l'adresse flags.

Voir aussi flags().

void QTextOption::setTabArray(const QList<qreal> &tabStops)

Définit les positions de tabulation pour la mise en page du texte à celles spécifiées par tabStops.

Voir aussi tabArray(), setTabStopDistance() et setTabs().

void QTextOption::setTabStopDistance(qreal tabStopDistance)

Définit la distance par défaut entre les taquets de tabulation, en unités de mesure, à la valeur spécifiée par tabStopDistance.

Voir aussi tabStopDistance(), setTabArray(), setTabs() et tabs().

void QTextOption::setTabs(const QList<QTextOption::Tab> &tabStops)

Définit les positions de tabulation pour la mise en page du texte à celles spécifiées par tabStops.

Voir aussi tabs() et tabStopDistance().

void QTextOption::setTextDirection(Qt::LayoutDirection direction)

Définit la direction de la mise en page du texte définie par l'option à l'adresse direction.

Voir aussi textDirection().

void QTextOption::setUseDesignMetrics(bool enable)

Si enable est vrai, la mise en page utilisera les métriques de conception ; sinon, elle utilisera les métriques du périphérique de peinture (ce qui est le comportement par défaut).

Voir également useDesignMetrics().

void QTextOption::setWrapMode(QTextOption::WrapMode mode)

Définit le mode d'habillage du texte de l'option à l'adresse mode.

Voir aussi wrapMode().

QList<qreal> QTextOption::tabArray() const

Renvoie une liste des positions de tabulation définies pour la mise en page du texte.

Voir aussi setTabArray() et tabStopDistance().

qreal QTextOption::tabStopDistance() const

Renvoie la distance entre les taquets de tabulation, exprimée en unités de dispositif.

Voir aussi setTabStopDistance(), tabArray(), setTabs() et tabs().

QList<QTextOption::Tab> QTextOption::tabs() const

Renvoie une liste des positions de tabulation définies pour la mise en page du texte.

Voir aussi tabStopDistance(), setTabs() et setTabStopDistance().

Qt::LayoutDirection QTextOption::textDirection() const

Renvoie la direction de la mise en page du texte définie par l'option.

Voir aussi setTextDirection().

bool QTextOption::useDesignMetrics() const

Renvoie true si la disposition utilise des métriques de conception plutôt que des métriques de périphérique ; sinon, renvoie false.

Voir également setUseDesignMetrics().

QTextOption::WrapMode QTextOption::wrapMode() const

Renvoie le mode d'habillage du texte défini par l'option.

Voir aussi setWrapMode().

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

Renvoie true si l'option de texte est la même que l'option de texte other; sinon, renvoie false.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.