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 |
- Liste de tous les membres, y compris les membres hérités
- QTextOption fait partie de Rich Text Processing APIs.
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
| Constante | Valeur | Description de l'option |
|---|---|---|
QTextOption::IncludeTrailingSpaces | 0x80000000 | Lorsque 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::ShowTabsAndSpaces | 0x1 | Les 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::ShowLineAndParagraphSeparators | 0x2 | Les séparateurs de lignes et de paragraphes sont représentés par des symboles appropriés. |
QTextOption::ShowDocumentTerminator (since Qt 5.7) | 0x10 | Visualisez la fin du document avec un signe de section. |
QTextOption::ShowDefaultIgnorables (since Qt 6.9) | 0x20 | Rendre normalement les caractères non visuels si la police le permet. |
QTextOption::AddSpaceForLineAndParagraphSeparators | 0x4 | Lors 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::SuppressColors | 0x8 | Supprimer tous les changements de couleur dans les formats de caractères (à l'exception de la sélection principale). |
QTextOption::DisableEmojiParsing (since Qt 6.9) | 0x40 | Par 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.
| Constante | Valeur | Description du tabulateur |
|---|---|---|
QTextOption::LeftTab | 0 | Un tabulateur gauche |
QTextOption::RightTab | 1 | Un tabulateur droit |
QTextOption::CenterTab | 2 | Un onglet centré |
QTextOption::DelimiterTab | 3 | Une 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.
| Constante | Valeur | Description |
|---|---|---|
QTextOption::NoWrap | 0 | Le texte n'est pas enveloppé du tout. |
QTextOption::WordWrap | 1 | Le texte est enveloppé à la limite des mots. |
QTextOption::ManualWrap | 2 | Identique à QTextOption::NoWrap |
QTextOption::WrapAnywhere | 3 | Le texte peut être enveloppé à n'importe quel endroit de la ligne, même s'il se trouve au milieu d'un mot. |
QTextOption::WrapAtWordBoundaryOrAnywhere | 4 | Si 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.