QTextOption Class
La classe QTextOption fournit une description des propriétés générales du texte enrichi. En savoir plus...
| 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 des API de traitement de texte enrichi.
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 sert à encapsuler les propriétés courantes du texte enrichi dans un seul objet. Elle contient des informations sur l’alignement du texte, le sens de mise en page, le retour à la ligne automatique 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 sur les types de membres
enum QTextOption::Flag
flags QTextOption::Flags
| Constante | Valeur | Description |
|---|---|---|
QTextOption::IncludeTrailingSpaces | 0x80000000 | Lorsque cette option est activée, les fonctions ` QTextLine::naturalTextWidth()` et `naturalTextRect()` renvoient une valeur qui inclut la largeur des espaces finaux dans le texte ; dans le cas contraire, cette largeur n’est pas prise en compte. |
QTextOption::ShowTabsAndSpaces | 0x1 | Affiche les espaces sous forme de petits points et les tabulations sous forme de petites flèches. Les espaces insécables sont affichés différemment des espaces séparables. |
QTextOption::ShowLineAndParagraphSeparators | 0x2 | Affichez les séparateurs de ligne et de paragraphe à l'aide des caractères symboliques appropriés. |
QTextOption::ShowDocumentTerminator (since Qt 5.7) | 0x10 | Affichez la fin du document à l'aide d'un signe de section. |
QTextOption::ShowDefaultIgnorables (since Qt 6.9) | 0x20 | Affiche normalement les caractères non visuels s’ils sont pris en charge par la police. |
QTextOption::AddSpaceForLineAndParagraphSeparators | 0x4 | Lors de la détermination des positions de saut de ligne, tenez compte de l'espace ajouté pour le tracé d'un caractère de séparation. |
QTextOption::SuppressColors | 0x8 | Supprimez 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étecte les séquences d'émojis dans les chaînes d'entrée et privilégie l'utilisation de polices en couleur pour les afficher. Cette étape supplémentaire peut être désactivée en définissant l'indicateur DisableEmojiParsing s'il est connu à l'avance qu'elle ne sera pas nécessaire. |
Le type Flags est un typedef pour QFlags<Flag>. Il stocke une combinaison OR de valeurs Flag.
enum QTextOption::TabType
Cette énumération regroupe les différents types de tabulateurs
| Constante | Valeur | Description |
|---|---|---|
QTextOption::LeftTab | 0 | Tabulation à gauche |
QTextOption::RightTab | 1 | Tabulation à droite |
QTextOption::CenterTab | 2 | Une tabulation centrée |
QTextOption::DelimiterTab | 3 | Un tabulation s'arrêtant à un certain caractère délimiteur |
enum QTextOption::WrapMode
Cette énumération décrit la manière dont le texte est mis en ligne dans un document.
| Constante | Valeur | Description |
|---|---|---|
QTextOption::NoWrap | 0 | Le texte n’est pas renvoyé du tout. |
QTextOption::WordWrap | 1 | Le texte est renvoyé aux fins de mot. |
QTextOption::ManualWrap | 2 | Identique à QTextOption::NoWrap |
QTextOption::WrapAnywhere | 3 | Le texte peut être renvoyé à n'importe quel endroit d'une ligne, même au milieu d'un mot. |
QTextOption::WrapAtWordBoundaryOrAnywhere | 4 | Si possible, le retour à la ligne s'effectue à la fin d'un mot ; sinon, il s'effectue à l'endroit approprié sur la ligne, même au milieu d'un mot. |
Documentation des fonctions membres
QTextOption::QTextOption()
Crée une option de texte avec les propriétés par défaut pour le texte. La propriété d'alignement du texte est définie sur « Qt::AlignLeft ». La propriété de retour à la ligne est définie sur « QTextOption::WordWrap ». L'indicateur d'utilisation des métriques de conception est défini sur « false ».
Remarque : l'appel de ce constructeur définit le sens par défaut du texte sur « Qt::LayoutDirectionAuto ».
QTextOption::QTextOption(Qt::Alignment alignment)
Crée une option de texte avec l'alignment s de texte fournies. La propriété « word wrap » est définie sur « QTextOption::WordWrap ». L'indicateur « using of design metrics » est défini sur « false ».
Remarque : l'appel de ce constructeur définit la direction par défaut du texte sur la valeur actuelle de ` QGuiApplication::layoutDirection()` (), qui dépend des paramètres régionaux du système. Pour des raisons de compatibilité ascendante, cela ne correspond pas à la direction par défaut du texte définie par le constructeur par défaut.
QTextOption::QTextOption(const QTextOption &other)
Créez une copie de l'option de texte « other ».
[noexcept] QTextOption::~QTextOption()
Supprime l'option « Texte ».
Qt::Alignment QTextOption::alignment() const
Renvoie l'alignement du texte défini par l'option.
Voir également setAlignment().
QTextOption::Flags QTextOption::flags() const
Renvoie les indicateurs associés à l'option.
Voir aussi setFlags().
void QTextOption::setAlignment(Qt::Alignment alignment)
Définit l'alignement du texte de l'option selon l'alignment spécifiée.
Voir également alignment().
void QTextOption::setFlags(QTextOption::Flags flags)
Définit les indicateurs associés à l'option sur la valeur indiquée flags.
Voir également flags().
void QTextOption::setTabArray(const QList<qreal> &tabStops)
Définit les positions des tabulations pour la mise en page du texte selon celles spécifiées par tabStops.
Voir également tabArray(), setTabStopDistance() et setTabs().
void QTextOption::setTabStopDistance(qreal tabStopDistance)
Définit la distance par défaut, en unités de l'appareil, entre les taquets de tabulation sur la valeur spécifiée par tabStopDistance.
Voir également tabStopDistance(), setTabArray(), setTabs() et tabs().
void QTextOption::setTabs(const QList<QTextOption::Tab> &tabStops)
Définit les positions des tabulations pour la mise en page du texte selon celles spécifiées par tabStops.
Voir également tabs() et tabStopDistance().
void QTextOption::setTextDirection(Qt::LayoutDirection direction)
Définit le sens de la mise en page du texte, tel que défini par l'option, sur la valeur indiquée direction.
Voir également textDirection().
void QTextOption::setUseDesignMetrics(bool enable)
Si la valeur de enable est « true », la mise en page utilisera les métriques de conception ; sinon, elle utilisera les métriques du périphérique de rendu (ce qui correspond au comportement par défaut).
Voir également useDesignMetrics().
void QTextOption::setWrapMode(QTextOption::WrapMode mode)
Définit le mode de retour à la ligne de l'option sur la valeur indiquée : mode.
Voir également wrapMode().
QList<qreal> QTextOption::tabArray() const
Renvoie une liste des positions de tabulation définies pour la mise en page du texte.
Voir également setTabArray() et tabStopDistance().
qreal QTextOption::tabStopDistance() const
Renvoie la distance, en unités de l'appareil, entre deux tabulations.
Voir également 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 également tabStopDistance(), setTabs() et setTabStopDistance().
Qt::LayoutDirection QTextOption::textDirection() const
Renvoie le sens de la disposition du texte défini par l'option.
Remarque : pour des raisons de compatibilité ascendante, la valeur par défaut de la direction du texte varie selon le constructeur utilisé. Consultez la documentation de chaque constructeur pour plus de détails.
Voir également setTextDirection().
bool QTextOption::useDesignMetrics() const
Renvoie « true » si la mise en page utilise des métriques de conception plutôt que des métriques d'appareil ; sinon, renvoie « false ».
Voir également setUseDesignMetrics().
QTextOption::WrapMode QTextOption::wrapMode() const
Renvoie le mode de retour à la ligne défini par l'option.
Voir aussi setWrapMode().
QTextOption &QTextOption::operator=(const QTextOption &other)
Renvoie « true » si l'option « text » est identique à l'option « 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.
