QTextFormat Class
La classe QTextFormat fournit des informations de formatage pour un QTextDocument. 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ée par : | QTextBlockFormat, QTextCharFormat, QTextFrameFormat, et QTextListFormat |
- Liste de tous les membres, y compris les membres hérités
- QTextFormat fait partie de Rich Text Processing APIs et de Implicitly Shared Classes.
Note : 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
Un QTextFormat est une classe générique utilisée pour décrire le format des parties d'un document QTextDocument. Les classes dérivées QTextCharFormat, QTextBlockFormat, QTextListFormat et QTextTableFormat sont généralement plus utiles et décrivent le formatage appliqué à des parties spécifiques du document.
Un format possède un FormatType qui spécifie les types d'éléments de texte qu'il peut formater, par exemple un bloc de texte, une liste, un tableau, etc. Un format possède également diverses propriétés (dont certaines sont spécifiques à des types de format particuliers), décrites par l'énumération Property. Chaque propriété a une propriété correspondante.
Le type de format est indiqué par type(), et le format peut être testé avec isCharFormat(), isBlockFormat(), isListFormat(), isTableFormat(), isFrameFormat() et isImageFormat(). Si le type est déterminé, il peut être récupéré avec 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 avec boolProperty(), intProperty(), doubleProperty() et stringProperty(), selon le cas. Tous les identifiants des propriétés utilisées dans le format peuvent être récupérés avec allPropertyIds(). Un format peut être fusionné avec un autre en utilisant merge().
L'index d'objet d'un format peut être défini avec setObjectIndex() et récupéré avec objectIndex(). Ces méthodes peuvent être utilisées pour associer le format à un QTextObject. Il est utilisé pour représenter des listes, des cadres et des tableaux à l'intérieur du document.
Voir aussi Rich Text Processing.
Documentation sur les types de membres
enum QTextFormat::FormatType
Cette énumération décrit l'élément de texte qu'un objet QTextFormat est en train de formater.
| Constante | Valeur | Description de l'objet |
|---|---|---|
QTextFormat::InvalidFormat | -1 | Un format invalide tel que créé par le constructeur par défaut. |
QTextFormat::BlockFormat | 1 | L'objet formate un bloc de texte |
QTextFormat::CharFormat | 2 | L'objet formate un seul caractère |
QTextFormat::ListFormat | 3 | L'objet formate une liste |
QTextFormat::FrameFormat | 5 | L'objet formate un cadre |
QTextFormat::UserFormat | 100 |
Voir aussi QTextCharFormat, QTextBlockFormat, QTextListFormat, QTextTableFormat, et type().
enum QTextFormat::ObjectTypes
Cette énumération décrit le type de QTextObject auquel ce format est associé.
| Constante | Valeur | Description de l'objet |
|---|---|---|
QTextFormat::NoObject | 0 | |
QTextFormat::ImageObject | 1 | |
QTextFormat::TableObject | 2 | |
QTextFormat::TableCellObject | 3 | |
QTextFormat::UserObject | 0x1000 | Le premier objet qui peut être utilisé à des fins spécifiques à l'application. |
Voir également QTextObject, QTextTable, et QTextObject::format().
enum QTextFormat::PageBreakFlag
flags QTextFormat::PageBreakFlags
Cette énumération décrit la manière dont le saut de page est effectué lors de l'impression. Elle correspond aux propriétés css correspondantes.
| Constante | Valeur | Description |
|---|---|---|
QTextFormat::PageBreak_Auto | 0 | Le saut de page est déterminé automatiquement en fonction de l'espace disponible sur la page en cours. |
QTextFormat::PageBreak_AlwaysBefore | 0x001 | La page est toujours interrompue avant le paragraphe/tableau |
QTextFormat::PageBreak_AlwaysAfter | 0x010 | Une nouvelle page est toujours créée après le paragraphe/la table. |
Le type PageBreakFlags est un typedef pour QFlags<PageBreakFlag>. Il stocke une combinaison OU 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 avoir.
| Constante | Valeur | Description de l'objet |
|---|---|---|
QTextFormat::ObjectIndex | 0x0 | L'index de l'objet formaté. Voir objectIndex(). |
Propriétés des paragraphes et des caractères
| Constante | Valeur | Description |
|---|---|---|
QTextFormat::CssFloat | 0x0800 | Position d'un cadre par rapport au texte qui l'entoure |
QTextFormat::LayoutDirection | 0x0801 | Sens de la 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 du paragraphe
| 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 la position des tabulations. Les positions de tabulation sont des structures de 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 la règle horizontale. |
QTextFormat::HeadingLevel | 0x1070 | Le niveau d'un titre, par exemple 1 correspond à une balise HTML H1, sinon 0. Cette valeur enum a été ajoutée dans Qt 5.12. |
QTextFormat::BlockCodeFence | 0x1091 | Le caractère utilisé dans les "clôtures" autour d'un bloc de code Markdown. Si le bloc de code a été indenté plutôt que clôturé, le bloc ne devrait pas avoir cette propriété. Cette valeur d'énumération a été ajoutée dans Qt 5.14. |
QTextFormat::BlockQuoteLevel | 0x1080 | La profondeur des guillemets imbriqués dans ce bloc : 1 signifie que le bloc est un guillemet de niveau supérieur. Les blocs qui ne sont pas des blocs de guillemets ne doivent pas avoir cette propriété. Cette valeur d'énumération a été ajoutée dans Qt 5.14. |
QTextFormat::BlockCodeLanguage | 0x1090 | Le langage de programmation dans un bloc préformaté ou de code. Les blocs qui ne contiennent pas de code ne doivent pas avoir cette propriété. Cette valeur a été ajoutée dans Qt 5.14. |
QTextFormat::BlockMarker | 0x10A0 | Le site 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 QTextFormat::FontFamilies à la place. |
QTextFormat::FontFamilies | 0x1FE7 | |
QTextFormat::FontStyleName | 0x1FE8 | |
QTextFormat::FontPointSize | 0x2001 | |
QTextFormat::FontPixelSize | 0x2009 | |
QTextFormat::FontSizeAdjustment | 0x2002 | Spécifie un ajustement 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 QTextFormat::TextUnderlineStyle à la place. |
QTextFormat::FontOverline | 0x2006 | |
QTextFormat::FontStrikeOut | 0x2007 | |
QTextFormat::FontCapitalization | FirstFontProperty | Spécifie le type de capitalisation à 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 individuelles de la police. La valeur est spécifiée en pourcentage ou en valeur absolue, en fonction de FontLetterSpacingType. La valeur par défaut est 100%. |
QTextFormat::FontWordSpacing | 0x1FE2 | Modifie l'espacement par défaut entre les mots individuels. Une valeur positive augmente l'espacement des mots des pixels correspondants ; une valeur négative diminue l'espacement. |
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 de la police est activé. |
QTextFormat::FontHintingPreference | 0x1FE6 | Contrôle l'utilisation de l'indice en fonction des valeurs de l'enum QFont::HintingPreference. |
QTextFormat::FontFeatures | 0x2010 | [depuis 6.11] Attribue des nombres entiers aux caractéristiques typographiques. Voir QFont::setFeature() pour plus d'informations. |
QTextFormat::FontVariableAxes | 0x2011 | [depuis 6.11] Assigne 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 pour dessiner les soulignements, les surlignements et les rayures. |
QTextFormat::TextVerticalAlignment | 0x2021 | Spécifie le type d'alignement vertical du texte en fonction des valeurs de l'enum QTextCharFormat::VerticalAlignment. |
QTextFormat::TextOutline | 0x2022 | Spécifie une adresse QPen utilisée pour dessiner 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 indice. |
QTextFormat::TextBaselineOffset | 0x2027 | Spécifie la ligne de base (en % de la hauteur) du texte. Une valeur positive fait monter le texte du % correspondant ; une valeur négative le fait descendre. |
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 degré d'indentation utilisé pour une liste. |
QTextFormat::ListNumberPrefix | 0x3002 | Définit le texte qui est ajouté aux numéros d'éléments dans les listes numériques. |
QTextFormat::ListNumberSuffix | 0x3003 | Définit le texte qui est ajouté aux numéros d'éléments dans les listes numériques. |
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 de la constante |
|---|---|---|
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 de 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 à utiliser lorsque QTextTableFormat::borderCollapse est activé
| 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 de l'image |
|---|---|---|
QTextFormat::ImageName | 0x5000 | Le nom de fichier ou la source de l'image. |
QTextFormat::ImageTitle | 0x5001 | L'attribut title d'une balise d'image HTML, ou la chaîne 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 d'image HTML, ou la description de l'image dans un lien d'image Markdown. Cette valeur a été ajoutée dans Qt 5.14. |
QTextFormat::ImageWidth | 0x5010 | |
QTextFormat::ImageHeight | 0x5011 | |
QTextFormat::ImageQuality | 0x5014 | |
QTextFormat::ImageMaxWidth | 0x5015 | Cette valeur 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 sur le characterFormat d'une sélection, toute la largeur du texte sera affichée comme étant sélectionnée. |
Propriétés du saut de page
| Constante | Valeur | Description |
|---|---|---|
QTextFormat::PageBreakPolicy | 0x7000 | Spécifie comment 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 avec une adresse InvalidFormat.
Voir aussi FormatType.
[explicit] QTextFormat::QTextFormat(int type)
Crée un nouveau format de texte à partir de l'adresse type.
Voir aussi FormatType.
QTextFormat::QTextFormat(const QTextFormat &other)
Crée un nouveau format de texte avec les mêmes attributs que le format de texte other.
[noexcept] QTextFormat::~QTextFormat()
Détruit ce format de texte.
QBrush QTextFormat::background() const
Renvoie la brosse utilisée pour peindre l'arrière-plan du document.
Voir aussi 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, false est renvoyé à la place.
Voir aussi setProperty(), intProperty(), doubleProperty(), stringProperty(), colorProperty(), lengthProperty(), lengthVectorProperty(), et Property.
QBrush QTextFormat::brushProperty(int propertyId) const
Renvoie la valeur de la propriété donnée par propertyId; si la propriété n'est pas de type QMetaType::QBrush, Qt::NoBrush est renvoyée à la place.
Voir aussi setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), lengthProperty(), lengthVectorProperty(), et Property.
void QTextFormat::clearBackground()
Efface la brosse utilisée pour peindre l'arrière-plan du document. La brosse par défaut sera utilisée.
Voir aussi background(), setBackground() et clearForeground().
void QTextFormat::clearForeground()
Efface la brosse utilisée pour peindre l'avant-plan du document. La brosse par défaut sera utilisée.
Voir aussi foreground(), setForeground() et clearBackground().
void QTextFormat::clearProperty(int propertyId)
Efface la valeur de la propriété donnée par propertyId
Voir aussi Property.
QColor QTextFormat::colorProperty(int propertyId) const
Renvoie la valeur de la propriété donnée par propertyId; si la propriété n'est pas de type QMetaType::QColor, une couleur invalide est renvoyée à la place.
Voir aussi 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, 0 est renvoyé à la place.
Voir aussi setProperty(), boolProperty(), intProperty(), stringProperty(), colorProperty(), lengthProperty(), lengthVectorProperty() et Property.
QBrush QTextFormat::foreground() const
Renvoie la brosse utilisée pour rendre les détails de premier plan, tels que le texte, les contours des cadres et les bordures des tableaux.
Voir aussi setForeground(), clearForeground() et background().
bool QTextFormat::hasProperty(int propertyId) const
Renvoie true si le format de texte a une propriété avec la valeur donnée propertyId; sinon, renvoie false.
Voir aussi 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, 0 est renvoyé à la place.
Voir aussi setProperty(), boolProperty(), doubleProperty(), stringProperty(), colorProperty(), lengthProperty(), lengthVectorProperty(), et Property.
bool QTextFormat::isBlockFormat() const
Renvoie true si ce format de texte est un BlockFormat; sinon, renvoie false.
bool QTextFormat::isCharFormat() const
Renvoie true si ce format de texte est un CharFormat; sinon, renvoie false.
bool QTextFormat::isEmpty() const
Retourne true si le format ne stocke aucune propriété, false dans le cas contraire.
Voir aussi 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 un 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 un TableFormat; sinon, renvoie false.
bool QTextFormat::isValid() const
Renvoie true si le format est valide (c'est-à-dire s'il ne s'agit pas de InvalidFormat) ; sinon, renvoie false.
Qt::LayoutDirection QTextFormat::layoutDirection() const
Renvoie la direction de la mise en page du document.
Voir aussi setLayoutDirection().
QTextLength QTextFormat::lengthProperty(int propertyId) const
Renvoie la valeur de la propriété donnée par propertyId.
Voir aussi setProperty(), boolProperty(), intProperty(), doubleProperty(), stringProperty(), colorProperty(), lengthVectorProperty() et Property.
QList<QTextLength> QTextFormat::lengthVectorProperty(int propertyId) const
Renvoie la valeur de la propriété donnée par propertyId. Si la propriété n'est pas de type QTextFormat::LengthVector, une liste vide est renvoyée à la place.
Voir aussi 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 est prioritaire.
int QTextFormat::objectIndex() const
Renvoie l'index de l'objet format, ou -1 si l'objet format n'est pas valide.
Voir aussi setObjectIndex().
int QTextFormat::objectType() const
Renvoie le type d'objet du format de texte.
Voir aussi ObjectTypes et setObjectType().
QPen QTextFormat::penProperty(int propertyId) const
Renvoie la valeur de la propriété donnée par propertyId; si la propriété n'est pas de type QMetaType::QPen, Qt::NoPen est renvoyée à la place.
Voir aussi 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'adresse propertyId.
Voir aussi 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 la brosse utilisée pour peindre l'arrière-plan du document à l'adresse brush spécifiée.
Voir également background(), clearBackground() et setForeground().
void QTextFormat::setForeground(const QBrush &brush)
Définit la brosse d'avant-plan à l'adresse brush. La brosse d'avant-plan est principalement utilisée pour le rendu du texte.
Voir aussi foreground(), clearForeground() et setBackground().
void QTextFormat::setLayoutDirection(Qt::LayoutDirection direction)
Définit la direction de la mise en page du document à la valeur spécifiée direction.
Voir également layoutDirection().
void QTextFormat::setObjectIndex(int index)
Définit l'objet de l'objet de format index.
Voir aussi objectIndex().
void QTextFormat::setObjectType(int type)
Définit le type d'objet du format de texte à type.
Voir aussi ObjectTypes et objectType().
void QTextFormat::setProperty(int propertyId, const QList<QTextLength> &value)
Définit la valeur de la propriété donnée par propertyId à value.
Voir aussi property(), lengthVectorProperty() et Property.
void QTextFormat::setProperty(int propertyId, const QVariant &value)
Fixe la propriété spécifiée par propertyId à la propriété donnée value.
Voir aussi Property.
QString QTextFormat::stringProperty(int propertyId) const
Renvoie la valeur de la propriété donnée par propertyId; si la propriété n'est pas de type QMetaType::QString, une chaîne vide est renvoyée à la place.
Voir aussi setProperty(), boolProperty(), intProperty(), doubleProperty(), colorProperty(), lengthProperty(), lengthVectorProperty(), et Property.
void QTextFormat::swap(QTextFormat &other)
Remplace ce format de texte par other. Cette opération est très rapide et n'échoue jamais.
QTextBlockFormat QTextFormat::toBlockFormat() const
Renvoie ce format sous forme de bloc.
QTextCharFormat QTextFormat::toCharFormat() const
Renvoie ce format sous la forme d'un format de caractères.
QTextFrameFormat QTextFormat::toFrameFormat() const
Renvoie ce format en tant que format de trame.
QTextImageFormat QTextFormat::toImageFormat() const
Renvoie ce format en tant que format d'image.
QTextListFormat QTextFormat::toListFormat() const
Renvoie ce format sous forme de liste.
QTextTableCellFormat QTextFormat::toTableCellFormat() const
Renvoie ce format en tant que 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 aussi FormatType.
QTextFormat::operator QVariant() const
Retourne le format du texte sous forme de 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.
