QTextFormat Class
La classe QTextFormat fournit des informations de mise en forme pour un objet ` QTextDocument`. En savoir plus...
| En-tête : | #include <QTextFormat> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
| Hérité par : | QTextBlockFormat, QTextCharFormat, QTextFrameFormat et QTextListFormat |
- Liste de tous les membres, y compris les membres hérités
- QTextFormat fait partie des API de traitement de texte enrichi et des classes partagées implicitement.
Remarque : toutes les fonctions de cette classe sont réentrantes.
Types publics
| enum | FormatType { InvalidFormat, BlockFormat, CharFormat, ListFormat, FrameFormat, UserFormat } |
| enum | ObjectTypes { NoObject, ImageObject, TableObject, TableCellObject, UserObject } |
| enum | PageBreakFlag { PageBreak_Auto, PageBreak_AlwaysBefore, PageBreak_AlwaysAfter } |
| flags | PageBreakFlags |
| enum | Property { ObjectIndex, CssFloat, LayoutDirection, OutlinePen, ForegroundBrush, …, UserProperty } |
Fonctions publiques
| QTextFormat() | |
| QTextFormat(int type) | |
| QTextFormat(const QTextFormat &other) | |
| ~QTextFormat() | |
| QBrush | background() const |
| bool | boolProperty(int propertyId) const |
| QBrush | brushProperty(int propertyId) const |
| void | clearBackground() |
| void | clearForeground() |
| void | clearProperty(int propertyId) |
| QColor | colorProperty(int propertyId) const |
| qreal | doubleProperty(int propertyId) const |
| QBrush | foreground() const |
| bool | hasProperty(int propertyId) const |
| int | intProperty(int propertyId) const |
| bool | isBlockFormat() const |
| bool | isCharFormat() const |
| bool | isEmpty() const |
| bool | isFrameFormat() const |
| bool | isImageFormat() const |
| bool | isListFormat() const |
| bool | isTableCellFormat() const |
| bool | isTableFormat() const |
| bool | isValid() const |
| Qt::LayoutDirection | layoutDirection() const |
| QTextLength | lengthProperty(int propertyId) const |
| QList<QTextLength> | lengthVectorProperty(int propertyId) const |
| void | merge(const QTextFormat &other) |
| int | objectIndex() const |
| int | objectType() const |
| QPen | penProperty(int propertyId) const |
| QMap<int, QVariant> | properties() const |
| QVariant | property(int propertyId) const |
| int | propertyCount() const |
| void | setBackground(const QBrush &brush) |
| void | setForeground(const QBrush &brush) |
| void | setLayoutDirection(Qt::LayoutDirection direction) |
| void | setObjectIndex(int index) |
| void | setObjectType(int type) |
| void | setProperty(int propertyId, const QList<QTextLength> &value) |
| void | setProperty(int propertyId, const QVariant &value) |
| QString | stringProperty(int propertyId) const |
| void | swap(QTextFormat &other) |
| QTextBlockFormat | toBlockFormat() const |
| QTextCharFormat | toCharFormat() const |
| QTextFrameFormat | toFrameFormat() const |
| QTextImageFormat | toImageFormat() const |
| QTextListFormat | toListFormat() const |
| QTextTableCellFormat | toTableCellFormat() const |
| QTextTableFormat | toTableFormat() const |
| int | type() const |
| operator QVariant() const | |
| bool | operator!=(const QTextFormat &other) const |
| QTextFormat & | operator=(const QTextFormat &other) |
| bool | operator==(const QTextFormat &other) const |
Description détaillée
Une classe QTextFormat est une classe générique utilisée pour décrire le format de certaines parties d’un QTextDocument. Les classes dérivées QTextCharFormat, QTextBlockFormat, QTextListFormat et QTextTableFormat sont généralement plus utiles et décrivent la mise en forme appliquée à des parties spécifiques du document.
Un format possède un type de format ( FormatType ) qui spécifie les types d’éléments de texte qu’il peut mettre en forme ; par exemple, un bloc de texte, une liste, un tableau, etc. Un format possède également diverses propriétés (certaines spécifiques à des types de format particuliers), telles que décrites par l’énumération Property. Chaque propriété correspond à un élément Property.
Le type de format est fourni par la fonction ` type()`, et le format peut être vérifié à l’aide des fonctions ` isCharFormat()`, ` isBlockFormat()`, ` isListFormat()`, ` isTableFormat()`, ` isFrameFormat()` et ` isImageFormat()`. Si le type est déterminé, il peut être récupéré à l’aide des fonctions ` toCharFormat()`, ` toBlockFormat()`, ` toListFormat()`, ` toTableFormat()`, ` toFrameFormat()` et ` toImageFormat()`.
Les propriétés d’un format peuvent être définies à l’aide des fonctions setProperty(), et récupérées à l’aide de boolProperty(), intProperty(), doubleProperty() et stringProperty(), selon le cas. Tous les identifiants de propriété utilisés dans le format peuvent être récupérés à l’aide de allPropertyIds(). Un format peut être fusionné avec un autre à l’aide de merge().
L'index d’objet d’un format peut être défini à l’aide de setObjectIndex() et récupéré à l’aide de objectIndex(). Ces méthodes permettent d’associer le format à un QTextObject. Il sert à représenter les listes, les cadres et les tableaux au sein du document.
Voir également Traitement du texte enrichi.
Documentation sur les types de membres
enum QTextFormat::FormatType
Cette énumération décrit l'élément de texte qu'un objet ` QTextFormat ` met en forme.
| Constante | Valeur | Description |
|---|---|---|
QTextFormat::InvalidFormat | -1 | Format non valide tel que créé par le constructeur par défaut |
QTextFormat::BlockFormat | 1 | L'objet formate un bloc de texte |
QTextFormat::CharFormat | 2 | L'objet met en forme un caractère unique |
QTextFormat::ListFormat | 3 | L’objet met en forme une liste |
QTextFormat::FrameFormat | 5 | L'objet met en forme un cadre |
QTextFormat::UserFormat | 100 |
Voir également QTextCharFormat, QTextBlockFormat, QTextListFormat, QTextTableFormat et type().
enum QTextFormat::ObjectTypes
Cette énumération décrit le type d'QTextObject s auquel ce format est associé.
| Constante | Valeur | Description |
|---|---|---|
QTextFormat::NoObject | 0 | |
QTextFormat::ImageObject | 1 | |
QTextFormat::TableObject | 2 | |
QTextFormat::TableCellObject | 3 | |
QTextFormat::UserObject | 0x1000 | Premier objet pouvant être utilisé à des fins spécifiques à une application. |
Voir également QTextObject, QTextTable et QTextObject::format().
enum QTextFormat::PageBreakFlag
flags QTextFormat::PageBreakFlags
Cette énumération décrit la manière dont les sauts de page sont gérés lors de l'impression. Elle correspond aux propriétés CSS associées.
| Constante | Valeur | Description |
|---|---|---|
QTextFormat::PageBreak_Auto | 0 | Le saut de page est déterminé automatiquement en fonction de l'espace disponible sur la page actuelle |
QTextFormat::PageBreak_AlwaysBefore | 0x001 | Le saut de page est toujours effectué avant le paragraphe/le tableau |
QTextFormat::PageBreak_AlwaysAfter | 0x010 | Une nouvelle page commence toujours après le paragraphe/le tableau |
Le type PageBreakFlags est un typedef pour QFlags<PageBreakFlag>. Il stocke une combinaison OR de valeurs PageBreakFlag.
Voir également QTextBlockFormat::pageBreakPolicy(), QTextFrameFormat::pageBreakPolicy() et PageBreakPolicy.
enum QTextFormat::Property
Cette énumération décrit les différentes propriétés qu'un format peut présenter.
| Constante | Valeur | Description |
|---|---|---|
QTextFormat::ObjectIndex | 0x0 | L'index de l'objet formaté. Voir objectIndex(). |
Propriétés de paragraphe et de caractère
| Constante | Valeur | Description |
|---|---|---|
QTextFormat::CssFloat | 0x0800 | Position d’un cadre par rapport au texte environnant |
QTextFormat::LayoutDirection | 0x0801 | Le sens de mise en page du texte dans le document (Qt::LayoutDirection). |
QTextFormat::OutlinePen | 0x810 | |
QTextFormat::ForegroundBrush | 0x821 | |
QTextFormat::BackgroundBrush | 0x820 | |
QTextFormat::BackgroundImageUrl | 0x823 |
Propriétés des paragraphes
| Constante | Valeur | Description |
|---|---|---|
QTextFormat::BlockAlignment | 0x1010 | |
QTextFormat::BlockTopMargin | 0x1030 | |
QTextFormat::BlockBottomMargin | 0x1031 | |
QTextFormat::BlockLeftMargin | 0x1032 | |
QTextFormat::BlockRightMargin | 0x1033 | |
QTextFormat::TextIndent | 0x1034 | |
QTextFormat::TabPositions | 0x1035 | Spécifie les positions des tabulations. Les positions des tabulations sont des structures de type « QTextOption::Tab » qui sont stockées dans un « QList » (en interne, dans un « QList<QVariant> »). |
QTextFormat::BlockIndent | 0x1040 | |
QTextFormat::LineHeight | 0x1048 | |
QTextFormat::LineHeightType | 0x1049 | |
QTextFormat::BlockNonBreakableLines | 0x1050 | |
QTextFormat::BlockTrailingHorizontalRulerWidth | 0x1060 | La largeur d’un élément de règle horizontale. |
QTextFormat::HeadingLevel | 0x1070 | Le niveau d'un titre ; par exemple, 1 correspond à une balise HTML H1 ; sinon, la valeur est 0. Cette valeur d'énumération a été ajoutée dans Qt 5.12. |
QTextFormat::BlockCodeFence | 0x1091 | Le caractère utilisé pour les « barrières » entourant un bloc de code Markdown. Si le bloc de code est indenté plutôt qu’entouré de barrières, il ne doit pas posséder cette propriété. Cette valeur d’énumération a été ajoutée dans Qt 5.14. |
QTextFormat::BlockQuoteLevel | 0x1080 | La profondeur de l'imbrication des citations dans ce bloc : 1 signifie que le bloc est une citation de niveau supérieur. Les blocs qui ne sont pas des citations ne doivent pas posséder cette propriété. Cette valeur d'énumération a été ajoutée dans Qt 5.14. |
QTextFormat::BlockCodeLanguage | 0x1090 | Le langage de programmation d'un bloc préformaté ou d'un bloc de code. Les blocs qui ne contiennent pas de code ne devraient pas posséder cette propriété. Cette valeur d'énumération a été ajoutée dans Qt 5.14. |
QTextFormat::BlockMarker | 0x10A0 | L'type of adornment à afficher à côté du bloc. Cette valeur d'énumération a été ajoutée dans Qt 5.14. |
Propriétés des caractères
| Constante | Valeur | Description |
|---|---|---|
QTextFormat::FontFamily | 0x2000 | e{Cette propriété est obsolète.} Utilisez plutôt QTextFormat::FontFamilies. |
QTextFormat::FontFamilies | 0x1FE7 | |
QTextFormat::FontStyleName | 0x1FE8 | |
QTextFormat::FontPointSize | 0x2001 | |
QTextFormat::FontPixelSize | 0x2009 | |
QTextFormat::FontSizeAdjustment | 0x2002 | Spécifie un ajustement sous forme d'entier ajouté à la taille de police de base définie à l'aide de ` FontPointSize ` ou ` FontPixelSize`. |
QTextFormat::FontFixedPitch | 0x2008 | |
QTextFormat::FontWeight | 0x2003 | |
QTextFormat::FontItalic | 0x2004 | |
QTextFormat::FontUnderline | 0x2005 | Cette propriété est obsolète. Utilisez plutôt QTextFormat::TextUnderlineStyle. |
QTextFormat::FontOverline | 0x2006 | |
QTextFormat::FontStrikeOut | 0x2007 | |
QTextFormat::FontCapitalization | FirstFontProperty | Spécifie le type de majuscules à appliquer au texte. |
QTextFormat::FontLetterSpacingType | 0x1FE9 | Spécifie la signification de la propriété FontLetterSpacing. La valeur par défaut est « QFont::PercentageSpacing ». |
QTextFormat::FontLetterSpacing | 0x1FE1 | Modifie l'espacement par défaut entre les lettres de la police. La valeur est spécifiée sous forme de pourcentage ou de valeur absolue, selon la propriété FontLetterSpacingType. La valeur par défaut est 100 %. |
QTextFormat::FontWordSpacing | 0x1FE2 | Modifie l'espacement par défaut entre les mots. Une valeur positive augmente l'espacement entre les mots du nombre de pixels correspondant ; une valeur négative le réduit. |
QTextFormat::FontStretch | 0x1FEA | Correspond à la propriété QFont::Stretch |
QTextFormat::FontStyleHint | 0x1FE3 | Correspond à la propriété QFont::StyleHint |
QTextFormat::FontStyleStrategy | 0x1FE4 | Correspond à la propriété QFont::StyleStrategy |
QTextFormat::FontKerning | 0x1FE5 | Spécifie si le crénage est activé pour la police. |
QTextFormat::FontHintingPreference | 0x1FE6 | Contrôle l’utilisation du hinting en fonction des valeurs de l’énumération QFont::HintingPreference. |
QTextFormat::FontFeatures | 0x2010 | [depuis la version 6.11] Attribue des nombres entiers aux caractéristiques typographiques. Voir QFont::setFeature() pour plus d’informations. |
QTextFormat::FontVariableAxes | 0x2011 | [depuis la version 6.11] Attribue des nombres à virgule flottante aux axes variables dans les polices variables. Voir QFont::setVariableAxis() pour plus d’informations. |
QTextFormat::TextUnderlineColor | 0x2020 | Spécifie la couleur à utiliser pour dessiner les soulignements, les surlignements et les barrages. |
QTextFormat::TextVerticalAlignment | 0x2021 | Spécifie le type d’alignement vertical du texte en fonction des valeurs de l’énumération QTextCharFormat::VerticalAlignment. |
QTextFormat::TextOutline | 0x2022 | Spécifie une valeur de l'énumération QPen utilisée pour tracer le contour du texte. |
QTextFormat::TextUnderlineStyle | 0x2023 | Spécifie le style de soulignement du texte en fonction des valeurs de l’énumération QTextCharFormat::UnderlineStyle. |
QTextFormat::TextToolTip | 0x2024 | Spécifie l’info-bulle (facultative) à afficher pour un fragment de texte. |
QTextFormat::TextSuperScriptBaseline | 0x2025 | Spécifie la ligne de base (en % de la hauteur) des textes en exposant. |
QTextFormat::TextSubScriptBaseline | 0x2026 | Spécifie la ligne de base (en % de la hauteur) des textes en exposant. |
QTextFormat::TextBaselineOffset | 0x2027 | Spécifie la ligne de base (en % de la hauteur) du texte. Une valeur positive déplace le texte vers le haut, du pourcentage correspondant ; une valeur négative le déplace vers le bas. |
QTextFormat::IsAnchor | 0x2030 | |
QTextFormat::AnchorHref | 0x2031 | |
QTextFormat::AnchorName | 0x2032 | |
QTextFormat::ObjectType | 0x2f00 |
Propriétés de la liste
| Constante | Valeur | Description |
|---|---|---|
QTextFormat::ListStyle | 0x3000 | Spécifie le style utilisé pour les éléments d'une liste, décrit par les valeurs de l'énumération QTextListFormat::Style. |
QTextFormat::ListIndent | 0x3001 | Spécifie le niveau d’indentation utilisé pour une liste. |
QTextFormat::ListNumberPrefix | 0x3002 | Définit le texte qui précède les numéros d'éléments dans les listes numérotées. |
QTextFormat::ListNumberSuffix | 0x3003 | Définit le texte ajouté à la fin des numéros d'éléments dans les listes numérotées. |
QTextFormat::ListStart (since Qt 6.6) | 0x3004 | Définit la première valeur d'une liste. |
Propriétés des tableaux et des cadres
| Constante | Valeur | Description |
|---|---|---|
QTextFormat::FrameBorder | 0x4000 | |
QTextFormat::FrameBorderBrush | 0x4009 | |
QTextFormat::FrameBorderStyle | 0x4010 | Voir l'énumération « BorderStyle ». |
QTextFormat::FrameBottomMargin | 0x4006 | |
QTextFormat::FrameHeight | 0x4004 | |
QTextFormat::FrameLeftMargin | 0x4007 | |
QTextFormat::FrameMargin | 0x4001 | |
QTextFormat::FramePadding | 0x4002 | |
QTextFormat::FrameRightMargin | 0x4008 | |
QTextFormat::FrameTopMargin | 0x4005 | |
QTextFormat::FrameWidth | 0x4003 | |
QTextFormat::TableCellSpacing | 0x4102 | |
QTextFormat::TableCellPadding | 0x4103 | |
QTextFormat::TableColumns | 0x4100 | |
QTextFormat::TableColumnWidthConstraints | 0x4101 | |
QTextFormat::TableHeaderRowCount | 0x4104 | |
QTextFormat::TableBorderCollapse | 0x4105 | Spécifie la propriété « QTextTableFormat::borderCollapse ». |
Propriétés des cellules du tableau
| Constante | Valeur |
|---|---|
QTextFormat::TableCellRowSpan | 0x4810 |
QTextFormat::TableCellColumnSpan | 0x4811 |
QTextFormat::TableCellLeftPadding | 0x4814 |
QTextFormat::TableCellRightPadding | 0x4815 |
QTextFormat::TableCellTopPadding | 0x4812 |
QTextFormat::TableCellBottomPadding | 0x4813 |
Propriétés des cellules de tableau destinées à être utilisées lorsque l'QTextTableFormat::borderCollapse est activée
| Constante | Valeur |
|---|---|
QTextFormat::TableCellTopBorder | 0x4816 |
QTextFormat::TableCellBottomBorder | 0x4817 |
QTextFormat::TableCellLeftBorder | 0x4818 |
QTextFormat::TableCellRightBorder | 0x4819 |
QTextFormat::TableCellTopBorderStyle | 0x481a |
QTextFormat::TableCellBottomBorderStyle | 0x481b |
QTextFormat::TableCellLeftBorderStyle | 0x481c |
QTextFormat::TableCellRightBorderStyle | 0x481d |
QTextFormat::TableCellTopBorderBrush | 0x481e |
QTextFormat::TableCellBottomBorderBrush | 0x481f |
QTextFormat::TableCellLeftBorderBrush | 0x4820 |
QTextFormat::TableCellRightBorderBrush | 0x4821 |
Propriétés de l’image
| Constante | Valeur | Description |
|---|---|---|
QTextFormat::ImageName | 0x5000 | Le nom de fichier ou la source de l'image. |
QTextFormat::ImageTitle | 0x5001 | L'attribut « title » d'une balise image HTML, ou la chaîne de caractères entre guillemets qui suit l'URL dans un lien d'image Markdown. Cette valeur d'énumération a été ajoutée dans Qt 5.14. |
QTextFormat::ImageAltText | 0x5002 | L'attribut « alt » d'une balise image HTML, ou la description de l'image dans un lien d'image Markdown. Cette valeur d'énumération a été ajoutée dans Qt 5.14. |
QTextFormat::ImageWidth | 0x5010 | |
QTextFormat::ImageHeight | 0x5011 | |
QTextFormat::ImageQuality | 0x5014 | |
QTextFormat::ImageMaxWidth | 0x5015 | Cette valeur d'énumération a été ajoutée dans Qt 6.8. |
Propriétés de sélection
| Constante | Valeur | Description |
|---|---|---|
QTextFormat::FullWidthSelection | 0x06000 | Lorsqu’elle est définie dans le paramètre characterFormat d’une sélection, toute la largeur du texte apparaîtra comme sélectionnée. |
Propriétés de saut de page
| Constante | Valeur | Description |
|---|---|---|
QTextFormat::PageBreakPolicy | 0x7000 | Spécifie la manière dont les pages sont coupées. Voir l'énumération « PageBreakFlag ». |
QTextFormat::UserProperty | 0x100000 |
Voir également property() et setProperty().
Documentation des fonctions membres
QTextFormat::QTextFormat()
Crée un nouveau format de texte à l'aide d'une instruction « InvalidFormat ».
Voir aussi FormatType.
[explicit] QTextFormat::QTextFormat(int type)
Crée un nouveau format de texte à partir de l'type on fournie.
Voir aussi FormatType.
QTextFormat::QTextFormat(const QTextFormat &other)
Crée un nouveau format de texte présentant les mêmes attributs que le format de texte « other ».
[noexcept] QTextFormat::~QTextFormat()
Supprime ce format de texte.
QBrush QTextFormat::background() const
Renvoie le pinceau utilisé pour peindre l'arrière-plan du document.
Voir également setBackground(), clearBackground() et foreground().
bool QTextFormat::boolProperty(int propertyId) const
Renvoie la valeur de la propriété spécifiée par propertyId. Si la propriété n'est pas de type QTextFormat::Bool, la valeur false est renvoyée à la place.
Voir également setProperty(), intProperty(), doubleProperty(), stringProperty(), colorProperty(), lengthProperty(), lengthVectorProperty() et Property.
QBrush QTextFormat::brushProperty(int propertyId) const
Renvoie la valeur de la propriété indiquée par propertyId; si la propriété n'est pas de type QMetaType::QBrush, la valeur Qt::NoBrush est renvoyée à la place.
Voir également setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), lengthProperty(), lengthVectorProperty() et Property.
void QTextFormat::clearBackground()
Efface le pinceau utilisé pour peindre l'arrière-plan du document. Le pinceau par défaut sera utilisé.
Voir également background(), setBackground() et clearForeground().
void QTextFormat::clearForeground()
Efface le pinceau utilisé pour peindre le premier plan du document. Le pinceau par défaut sera utilisé.
Voir également foreground(), setForeground() et clearBackground().
void QTextFormat::clearProperty(int propertyId)
Efface la valeur de la propriété indiquée par propertyId
Voir aussi Property.
QColor QTextFormat::colorProperty(int propertyId) const
Renvoie la valeur de la propriété spécifiée par propertyId; si la propriété n'est pas de type QMetaType::QColor, une couleur non valide est renvoyée à la place.
Voir également setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), lengthProperty(), lengthVectorProperty() et Property.
qreal QTextFormat::doubleProperty(int propertyId) const
Renvoie la valeur de la propriété spécifiée par propertyId. Si la propriété n'est pas de type QMetaType::Double ou QMetaType::Float, la valeur 0 est renvoyée à la place.
Voir également setProperty(), boolProperty(), intProperty(), stringProperty(), colorProperty(), lengthProperty(), lengthVectorProperty() et Property.
QBrush QTextFormat::foreground() const
Renvoie le pinceau utilisé pour afficher les détails au premier plan, tels que le texte, les contours des cadres et les bordures de tableau.
Voir également setForeground(), clearForeground() et background().
bool QTextFormat::hasProperty(int propertyId) const
Renvoie « true » si le format de texte possède une propriété dont l'propertyId est celle indiquée ; sinon, renvoie « false ».
Voir également properties() et Property.
int QTextFormat::intProperty(int propertyId) const
Renvoie la valeur de la propriété spécifiée par propertyId. Si la propriété n'est pas de type QTextFormat::Integer, la valeur 0 est renvoyée à la place.
Voir également setProperty(), boolProperty(), doubleProperty(), stringProperty(), colorProperty(), lengthProperty(), lengthVectorProperty() et Property.
bool QTextFormat::isBlockFormat() const
Renvoie « true » si ce format de texte correspond à « BlockFormat » ; sinon, renvoie « false ».
bool QTextFormat::isCharFormat() const
Renvoie « true » si ce format de texte est « CharFormat » ; sinon, renvoie « false ».
bool QTextFormat::isEmpty() const
Renvoie « true » si le format ne contient aucune propriété ; « false » dans le cas contraire.
Voir également propertyCount() et properties().
bool QTextFormat::isFrameFormat() const
Renvoie « true » si ce format de texte est un « FrameFormat » ; sinon, renvoie « false ».
bool QTextFormat::isImageFormat() const
Renvoie « true » si ce format de texte est un format d'image ; sinon, renvoie « false ».
bool QTextFormat::isListFormat() const
Renvoie « true » si ce format de texte est « ListFormat » ; sinon, renvoie « false ».
bool QTextFormat::isTableCellFormat() const
Renvoie « true » si ce format de texte est un « TableCellFormat » ; sinon, renvoie « false ».
bool QTextFormat::isTableFormat() const
Renvoie « true » si ce format de texte est « TableFormat » ; sinon, renvoie « false ».
bool QTextFormat::isValid() const
Renvoie « true » si le format est valide (c'est-à-dire s'il n'est pas « InvalidFormat ») ; sinon, renvoie « false ».
Qt::LayoutDirection QTextFormat::layoutDirection() const
Renvoie le sens de mise en page du document.
Voir aussi setLayoutDirection().
QTextLength QTextFormat::lengthProperty(int propertyId) const
Renvoie la valeur de la propriété indiquée par propertyId.
Voir également setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), colorProperty(), lengthVectorProperty() et Property.
QList<QTextLength> QTextFormat::lengthVectorProperty(int propertyId) const
Renvoie la valeur de la propriété indiquée par propertyId. Si la propriété n'est pas de type QTextFormat::LengthVector, une liste vide est renvoyée à la place.
Voir également setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), colorProperty(), lengthProperty() et Property.
void QTextFormat::merge(const QTextFormat &other)
Fusionne le format other avec ce format ; en cas de conflit, le format other prévaut.
int QTextFormat::objectIndex() const
Renvoie l'index de l'objet de format, ou -1 si celui-ci n'est pas valide.
Voir aussi setObjectIndex().
int QTextFormat::objectType() const
Renvoie le type d'objet du format de texte.
Voir également ObjectTypes et setObjectType().
QPen QTextFormat::penProperty(int propertyId) const
Renvoie la valeur de la propriété indiquée par propertyId; si la propriété n'est pas de type QMetaType::QPen, la valeur Qt::NoPen est renvoyée à la place.
Voir également setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), lengthProperty(), lengthVectorProperty() et Property.
QMap<int, QVariant> QTextFormat::properties() const
Renvoie une carte contenant toutes les propriétés de ce format de texte.
QVariant QTextFormat::property(int propertyId) const
Renvoie la propriété spécifiée par l'propertyId.
Voir également setProperty() et Property.
int QTextFormat::propertyCount() const
Renvoie le nombre de propriétés stockées dans le format.
void QTextFormat::setBackground(const QBrush &brush)
Définit le pinceau utilisé pour peindre l'arrière-plan du document selon les paramètres spécifiés dans brush.
Voir également background(), clearBackground() et setForeground().
void QTextFormat::setForeground(const QBrush &brush)
Définit le pinceau de premier plan sur la couleur spécifiée brush. Le pinceau de premier plan est principalement utilisé pour afficher du texte.
Voir également foreground(), clearForeground() et setBackground().
void QTextFormat::setLayoutDirection(Qt::LayoutDirection direction)
Définit le sens de mise en page du document sur la valeur spécifiée direction.
Voir également layoutDirection().
void QTextFormat::setObjectIndex(int index)
Définit l'index de l'objet de format.
Voir aussi objectIndex().
void QTextFormat::setObjectType(int type)
Définit le type d'objet du format de texte sur « type ».
Voir également ObjectTypes et objectType().
void QTextFormat::setProperty(int propertyId, const QList<QTextLength> &value)
Définit la valeur de la propriété indiquée par propertyId sur value.
Voir également property(), lengthVectorProperty() et Property.
void QTextFormat::setProperty(int propertyId, const QVariant &value)
Définit la propriété spécifiée par l'propertyId sur la valeur indiquée value.
Voir également Property.
QString QTextFormat::stringProperty(int propertyId) const
Renvoie la valeur de la propriété indiquée par propertyId; si la propriété n'est pas de type QMetaType::QString, une chaîne vide est renvoyée à la place.
Voir également setProperty(), boolProperty(), intProperty(), doubleProperty(), colorProperty(), lengthProperty(), lengthVectorProperty() et Property.
void QTextFormat::swap(QTextFormat &other)
Permute ce format de texte avec celui d'other. Cette opération est très rapide et ne rencontre jamais d'échec.
QTextBlockFormat QTextFormat::toBlockFormat() const
Renvoie ce format sous forme de format de bloc.
QTextCharFormat QTextFormat::toCharFormat() const
Renvoie ce format sous forme de chaîne de caractères.
QTextFrameFormat QTextFormat::toFrameFormat() const
Renvoie ce format sous forme de format de trame.
QTextImageFormat QTextFormat::toImageFormat() const
Renvoie ce format sous forme d'image.
QTextListFormat QTextFormat::toListFormat() const
Renvoie ce format sous forme de liste.
QTextTableCellFormat QTextFormat::toTableCellFormat() const
Renvoie ce format sous la forme d'un format de cellule de tableau.
QTextTableFormat QTextFormat::toTableFormat() const
Renvoie ce format sous forme de tableau.
int QTextFormat::type() const
Renvoie le type de ce format.
Voir également FormatType.
QTextFormat::operator QVariant() const
Renvoie le format de texte sous la forme d'un QVariant
bool QTextFormat::operator!=(const QTextFormat &other) const
Renvoie « true » si ce format de texte est différent du format de texte « other ».
QTextFormat &QTextFormat::operator=(const QTextFormat &other)
Attribue le format de texte « other » à ce format de texte et renvoie une référence à ce format de texte.
bool QTextFormat::operator==(const QTextFormat &other) const
Renvoie « true » si ce format de texte est identique au format de texte « other ».
© 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.
