QTextCharFormat Class

Documentation des fonctions membres

QTextCharFormat::QTextCharFormat()

Construit un nouvel objet de format de caractères.

QString QTextCharFormat::anchorHref() const

Renvoie le lien hypertexte du format de texte, ou une chaîne vide si aucun lien n'a été défini.

Voir aussi setAnchorHref().

QStringList QTextCharFormat::anchorNames() const

Renvoie les noms d'ancres associés à ce format de texte, ou une liste de chaînes vides si aucune n'a été définie. Si les noms d'ancres sont définis, le texte de ce format peut être la destination d'un lien hypertexte.

Voir aussi setAnchorNames().

[since 6.0] qreal QTextCharFormat::baselineOffset() const

Renvoie le décalage de la ligne de base en %.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi setBaselineOffset(), setSubScriptBaseline(), subScriptBaseline(), setSuperScriptBaseline() et superScriptBaseline().

QFont QTextCharFormat::font() const

Renvoie la police de ce format de caractères.

Cette fonction prend en compte les attributs de police du format (tels que fontWeight() et fontPointSize()) et les résout en plus de la police par défaut, définie comme suit. Si le format fait partie d'un document, il s'agit de la police par défaut du document. Dans le cas contraire, les propriétés sont résolues au-dessus d'une police par défaut construite QFont.

Par exemple, si la taille de la police de ce format n'a pas été modifiée par rapport à la police par défaut, fontPointSize() renvoie 0, tandis que font().pointSize() renvoie la taille réelle utilisée pour le dessin.

Voir également setFont() et QTextDocument::defaultFont().

QFont::Capitalization QTextCharFormat::fontCapitalization() const

Renvoie le type de capitalisation actuel de la police.

Voir aussi setFontCapitalization().

QVariant QTextCharFormat::fontFamilies() const

Renvoie les familles de polices du format de texte.

Voir aussi setFontFamilies() et font().

[since 6.11] QMap<QFont::Tag, quint32> QTextCharFormat::fontFeatures() const

Obtient les caractéristiques typographiques de la police du format de texte.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi setFontFeatures().

bool QTextCharFormat::fontFixedPitch() const

Renvoie true si la police du format de texte est à hauteur fixe ; sinon, renvoie false.

Voir aussi setFontFixedPitch() et font().

QFont::HintingPreference QTextCharFormat::fontHintingPreference() const

Renvoie la préférence d'indication définie pour ce format de texte.

Voir aussi setFontHintingPreference(), font(), et QFont::hintingPreference().

bool QTextCharFormat::fontItalic() const

Renvoie true si la police du format de texte est en italique ; sinon, renvoie false.

Voir aussi setFontItalic() et font().

bool QTextCharFormat::fontKerning() const

Renvoie true si le crénage de la police est activé.

Voir aussi setFontKerning() et font().

qreal QTextCharFormat::fontLetterSpacing() const

Renvoie l'espacement actuel entre les lettres.

Voir aussi setFontLetterSpacing(), setFontLetterSpacingType() et fontLetterSpacingType().

QFont::SpacingType QTextCharFormat::fontLetterSpacingType() const

Renvoie le type d'espacement des lettres de ce format....

Voir aussi setFontLetterSpacingType(), setFontLetterSpacing(), et fontLetterSpacing().

bool QTextCharFormat::fontOverline() const

Renvoie true si la police du format de texte est superposée ; sinon, renvoie false.

Voir aussi setFontOverline() et font().

qreal QTextCharFormat::fontPointSize() const

Renvoie la taille de la police utilisée pour afficher le texte dans ce format.

Voir aussi setFontPointSize() et font().

int QTextCharFormat::fontStretch() const

Renvoie l'étirement actuel de la police.

Voir aussi setFontStretch().

bool QTextCharFormat::fontStrikeOut() const

Renvoie true si la police du format de texte est barrée (elle est traversée par une ligne horizontale) ; sinon, renvoie false.

Voir aussi setFontStrikeOut() et font().

QFont::StyleHint QTextCharFormat::fontStyleHint() const

Renvoie l'indice de style de police.

Voir aussi setFontStyleHint() et font().

QVariant QTextCharFormat::fontStyleName() const

Renvoie le nom du style de police du format de texte.

Voir aussi setFontStyleName(), font(), et QFont::styleName().

QFont::StyleStrategy QTextCharFormat::fontStyleStrategy() const

Renvoie la stratégie de style de police actuelle.

Voir aussi setFontStyleStrategy() et font().

bool QTextCharFormat::fontUnderline() const

Renvoie true si la police du format de texte est soulignée ; sinon, renvoie false.

Voir aussi setFontUnderline() et font().

[since 6.11] QMap<QFont::Tag, float> QTextCharFormat::fontVariableAxes() const

Obtient les axes variables de la police du format de texte.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi setFontVariableAxes().

int QTextCharFormat::fontWeight() const

Renvoie le poids de la police du format de texte.

Voir aussi setFontWeight(), font(), et QFont::Weight.

qreal QTextCharFormat::fontWordSpacing() const

Renvoie la valeur actuelle de l'espacement des mots.

Voir aussi setFontWordSpacing().

bool QTextCharFormat::isAnchor() const

Renvoie true si le texte est formaté comme une ancre ; sinon, renvoie false.

Voir aussi setAnchor(), setAnchorHref() et setAnchorNames().

bool QTextCharFormat::isValid() const

Renvoie true si ce format de caractère est valide, sinon renvoie false.

void QTextCharFormat::setAnchor(bool anchor)

Si anchor est vrai, le texte ayant ce format représente une ancre et est formaté de manière appropriée ; sinon, le texte est formaté normalement. (Les ancres sont des liens hypertextes qui sont souvent soulignés et affichés dans une couleur différente de celle du texte ordinaire).

La manière dont le texte est rendu est indépendante de la définition ou non d'une ancre valide dans le format. Utilisez setAnchorHref(), et éventuellement setAnchorNames() pour créer un lien hypertexte.

Voir aussi isAnchor().

void QTextCharFormat::setAnchorHref(const QString &value)

Définit le lien hypertexte pour le format de texte à l'adresse value. Il s'agit généralement d'une URL comme "http://example.com/index.html".

L'ancre sera affichée avec value comme texte d'affichage ; si vous souhaitez afficher un texte différent, appelez setAnchorNames().

Pour formater le texte comme un lien hypertexte, utilisez setAnchor().

Voir aussi anchorHref().

void QTextCharFormat::setAnchorNames(const QStringList &names)

Définit l'ancre du format de texte names. Pour que l'ancre fonctionne comme un hyperlien, la destination doit être définie avec setAnchorHref() et l'ancre doit être activée avec setAnchor().

Voir aussi anchorNames().

[since 6.0] void QTextCharFormat::setBaselineOffset(qreal baseline)

Fixe la ligne de base (en % de la hauteur) du texte à baseline. Une valeur positive déplace le texte vers le haut, du % correspondant ; une valeur négative le déplace vers le bas. La valeur par défaut est 0.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi baselineOffset(), setSubScriptBaseline(), subScriptBaseline(), setSuperScriptBaseline() et superScriptBaseline().

void QTextCharFormat::setFont(const QFont &font, QTextCharFormat::FontPropertiesInheritanceBehavior behavior = FontPropertiesAll)

Définit la propriété de police du format de texte font.

Si behavior est QTextCharFormat::FontPropertiesAll, la propriété de police qui n'a pas été explicitement définie est traitée comme si elle avait été définie avec la valeur par défaut ; Si behavior est QTextCharFormat::FontPropertiesSpecifiedOnly, la propriété de police qui n'a pas été explicitement définie est ignorée et la valeur de la propriété correspondante reste inchangée.

Voir aussi font().

void QTextCharFormat::setFontCapitalization(QFont::Capitalization capitalization)

Définit la capitalisation du texte qui apparaît dans cette police à capitalization.

La capitalisation d'une police fait apparaître le texte dans le mode de capitalisation sélectionné.

Voir également fontCapitalization().

void QTextCharFormat::setFontFamilies(const QStringList &families)

Définit la police de caractères du format de texte families.

Voir aussi fontFamilies() et setFont().

[since 6.11] void QTextCharFormat::setFontFeatures(const QMap<QFont::Tag, quint32> &fontFeatures)

Définit les caractéristiques typographiques de la police du format de texte à fontFeatures.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi fontFeatures() et QFont::setFeature().

void QTextCharFormat::setFontFixedPitch(bool fixedPitch)

Si fixedPitch est vrai, la police du format de texte est définie comme étant à hauteur fixe ; sinon, une police à hauteur non fixe est utilisée.

Voir aussi fontFixedPitch() et setFont().

void QTextCharFormat::setFontHintingPreference(QFont::HintingPreference hintingPreference)

Définit la préférence d'indication de la police du format de texte à hintingPreference.

Voir aussi fontHintingPreference(), setFont() et QFont::setHintingPreference().

void QTextCharFormat::setFontItalic(bool italic)

Si italic est vrai, la police du format de texte est mise en italique ; sinon, la police n'est pas mise en italique.

Voir aussi fontItalic() et setFont().

void QTextCharFormat::setFontKerning(bool enable)

Active le crénage pour cette police si enable est vrai, sinon le désactive.

Lorsque le crénage est activé, les mesures des glyphes ne s'additionnent plus, même pour le texte latin. En d'autres termes, l'hypothèse selon laquelle width('a') + width('b') est égal à width("ab") n'est pas nécessairement vraie.

Voir aussi fontKerning() et setFont().

void QTextCharFormat::setFontLetterSpacing(qreal spacing)

Définit l'espacement des lettres de ce format à la valeur donnée spacing. La signification de la valeur dépend du type d'espacement des lettres de la police.

Pour un espacement en pourcentage, une valeur de 100 indique un espacement par défaut ; une valeur de 200 double l'espacement d'une lettre.

Voir également fontLetterSpacing(), setFontLetterSpacingType() et fontLetterSpacingType().

void QTextCharFormat::setFontLetterSpacingType(QFont::SpacingType letterSpacingType)

Définit le type d'espacement des lettres de ce format à letterSpacingType.

Voir aussi fontLetterSpacingType(), setFontLetterSpacing() et fontLetterSpacing().

void QTextCharFormat::setFontOverline(bool overline)

Si overline est vrai, la police du format de texte est surlignée ; sinon, la police est affichée sans surlignage.

Voir aussi fontOverline() et setFont().

void QTextCharFormat::setFontPointSize(qreal size)

Définit la police de caractères du format de texte size.

Voir aussi fontPointSize() et setFont().

void QTextCharFormat::setFontStretch(int factor)

Définit le facteur d'étirement de la police à factor.

Le facteur d'étirement modifie la largeur de tous les caractères de la police en fonction d'un pourcentage. Par exemple, si vous fixez factor à 150, tous les caractères de la police seront 1,5 fois plus larges (soit 150 %). Le facteur d'étirement par défaut est de 100. Le facteur d'étirement minimum est de 1 et le facteur d'étirement maximum est de 4000.

Le facteur d'étirement n'est appliqué qu'aux polices de contour. Le facteur d'étirement est ignoré pour les polices bitmap.

Voir aussi fontStretch().

void QTextCharFormat::setFontStrikeOut(bool strikeOut)

Si strikeOut est vrai, la police du format de texte est affichée avec les caractères barrés activés (avec une ligne horizontale) ; sinon, elle est affichée sans les caractères barrés.

Voir aussi fontStrikeOut() et setFont().

void QTextCharFormat::setFontStyleHint(QFont::StyleHint hint, QFont::StyleStrategy strategy = QFont::PreferDefault)

Définit le style de police hint et strategy.

Qt ne supporte pas les indications de style sur X11 car cette information n'est pas fournie par le système de fenêtres.

Voir aussi fontStyleHint(), setFont(), et QFont::setStyleHint().

void QTextCharFormat::setFontStyleName(const QString &styleName)

Définit la police de caractères du format de texte styleName.

Voir aussi fontStyleName(), setFont() et QFont::setStyleName().

void QTextCharFormat::setFontStyleStrategy(QFont::StyleStrategy strategy)

Définit le style de police strategy.

Voir aussi fontStyleStrategy(), setFont() et QFont::setStyleStrategy().

void QTextCharFormat::setFontUnderline(bool underline)

Si underline est vrai, la police du format de texte est soulignée ; sinon, elle n'est pas soulignée.

Voir aussi fontUnderline() et setFont().

[since 6.11] void QTextCharFormat::setFontVariableAxes(const QMap<QFont::Tag, float> &fontVariableAxes)

Définit les axes variables de la police du format de texte à fontVariableAxes.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi fontVariableAxes() et QFont::setVariableAxis().

void QTextCharFormat::setFontWeight(int weight)

Définit la graisse de la police du format de texte à weight.

Voir aussi fontWeight(), setFont(), et QFont::Weight.

void QTextCharFormat::setFontWordSpacing(qreal spacing)

Fixe l'espacement des mots de ce format à la valeur donnée spacing, en pixels.

Voir aussi fontWordSpacing().

[since 6.0] void QTextCharFormat::setSubScriptBaseline(qreal baseline)

Définit la ligne de base de l'indice en % de la hauteur de la police à baseline. La valeur par défaut est 16,67% (1/6 de la hauteur).

Cette fonction a été introduite dans Qt 6.0.

Voir aussi subScriptBaseline(), setSuperScriptBaseline(), superScriptBaseline(), setBaselineOffset() et baselineOffset().

[since 6.0] void QTextCharFormat::setSuperScriptBaseline(qreal baseline)

Définit la ligne de base de l'exposant en % de la hauteur de la police à baseline. La valeur par défaut est 50% (1/2 de la hauteur).

Cette fonction a été introduite dans Qt 6.0.

Voir aussi superScriptBaseline(), setSubScriptBaseline(), subScriptBaseline(), setBaselineOffset() et baselineOffset().

void QTextCharFormat::setTextOutline(const QPen &pen)

Définit le stylo utilisé pour dessiner les contours des caractères à l'adresse pen.

Voir aussi textOutline().

void QTextCharFormat::setToolTip(const QString &text)

Définit la bulle d'aide d'un fragment de texte à l'adresse text.

Voir aussi toolTip().

void QTextCharFormat::setUnderlineColor(const QColor &color)

Définit la couleur utilisée pour dessiner les soulignements, les surlignements et les rayures sur les caractères avec ce format à la valeur color spécifiée.

Voir aussi underlineColor().

void QTextCharFormat::setUnderlineStyle(QTextCharFormat::UnderlineStyle style)

Définit le style de soulignement du texte à style.

Voir aussi underlineStyle().

void QTextCharFormat::setVerticalAlignment(QTextCharFormat::VerticalAlignment alignment)

Définit l'alignement vertical utilisé pour les caractères de ce format à l'adresse alignment spécifiée.

Voir aussi verticalAlignment().

[since 6.0] qreal QTextCharFormat::subScriptBaseline() const

Renvoie la ligne de base de l'indice en % de la hauteur de la police.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi setSubScriptBaseline(), setSuperScriptBaseline(), superScriptBaseline(), setBaselineOffset() et baselineOffset().

[since 6.0] qreal QTextCharFormat::superScriptBaseline() const

Renvoie la ligne de base de l'exposant en % de la hauteur de la police.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi setSuperScriptBaseline(), setSubScriptBaseline(), subScriptBaseline(), setBaselineOffset() et baselineOffset().

QPen QTextCharFormat::textOutline() const

Renvoie le stylo utilisé pour dessiner les contours des caractères dans ce format.

Voir aussi setTextOutline().

QString QTextCharFormat::toolTip() const

Renvoie l'info-bulle affichée pour un fragment de texte.

Voir aussi setToolTip().

QColor QTextCharFormat::underlineColor() const

Renvoie la couleur utilisée pour dessiner les soulignés, les surlignés et les barrés sur les caractères de ce format.

Voir aussi setUnderlineColor().

QTextCharFormat::UnderlineStyle QTextCharFormat::underlineStyle() const

Renvoie le style de soulignement du texte.

Voir aussi setUnderlineStyle().

QTextCharFormat::VerticalAlignment QTextCharFormat::verticalAlignment() const

Renvoie l'alignement vertical utilisé pour les caractères de ce format.

Voir aussi setVerticalAlignment().