QTextCharFormat Class

Documentation des fonctions membres

QTextCharFormat::QTextCharFormat()

Crée un nouvel objet de format de caractère.

QString QTextCharFormat::anchorHref() const

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

Voir aussi setAnchorHref().

QStringList QTextCharFormat::anchorNames() const

Renvoie les noms d'ancrage associés à ce format de texte, ou une liste de chaînes vide si aucun n'a été défini. Si des noms d'ancrage sont définis, le texte présentant ce format peut servir de destination à un lien hypertexte.

Voir également setAnchorNames().

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

Renvoie le décalage par rapport à la ligne de base, exprimé en %.

Cette fonction a été introduite dans Qt 6.0.

Voir également setBaselineOffset(), setSubScriptBaseline(), subScriptBaseline(), setSuperScriptBaseline() et superScriptBaseline().

QFont QTextCharFormat::font() const

Renvoie la police associée à ce format de caractère.

Cette fonction prend en compte les attributs de police du format (tels que fontWeight() et fontPointSize()) et les applique à 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 de ce document. Sinon, les propriétés sont appliquées à une police par défaut construite QFont.

Par exemple, si la taille de 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 tracé.

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

QFont::Capitalization QTextCharFormat::fontCapitalization() const

Renvoie le type de majuscules actuel de la police.

Voir aussi setFontCapitalization().

QVariant QTextCharFormat::fontFamilies() const

Renvoie les familles de polices du format de texte.

Voir également setFontFamilies() et font().

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

Récupère les caractéristiques typographiques de la police du format de texte.

Cette fonction a été introduite dans Qt 6.11.

Voir également setFontFeatures().

bool QTextCharFormat::fontFixedPitch() const

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

Voir également setFontFixedPitch() et font().

QFont::HintingPreference QTextCharFormat::fontHintingPreference() const

Renvoie les préférences de hinting définies pour ce format de texte.

Voir également 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 également setFontItalic() et font().

bool QTextCharFormat::fontKerning() const

Renvoie « true » si le crénage des polices est activé.

Voir également setFontKerning() et font().

qreal QTextCharFormat::fontLetterSpacing() const

Renvoie l'espacement actuel entre les lettres.

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

QFont::SpacingType QTextCharFormat::fontLetterSpacingType() const

Renvoie le type d'espacement entre les lettres de ce format.

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

bool QTextCharFormat::fontOverline() const

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

Voir également setFontOverline() et font().

qreal QTextCharFormat::fontPointSize() const

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

Voir également setFontPointSize() et font().

int QTextCharFormat::fontStretch() const

Renvoie le facteur d'étirement actuel de la police.

Voir aussi setFontStretch().

bool QTextCharFormat::fontStrikeOut() const

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

Voir également setFontStrikeOut() et font().

QFont::StyleHint QTextCharFormat::fontStyleHint() const

Renvoie l'indication de style de police.

Voir également setFontStyleHint() et font().

QVariant QTextCharFormat::fontStyleName() const

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

Voir également setFontStyleName(), font() et QFont::styleName().

QFont::StyleStrategy QTextCharFormat::fontStyleStrategy() const

Renvoie la stratégie de style de police actuelle.

Voir également 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

Récupère les axes variables de la police du format de texte.

Cette fonction a été introduite dans Qt 6.11.

Voir également setFontVariableAxes().

int QTextCharFormat::fontWeight() const

Renvoie l'épaisseur de la police du format de texte.

Voir également setFontWeight(), font() et QFont::Weight.

qreal QTextCharFormat::fontWordSpacing() const

Renvoie la valeur actuelle de l'espacement entre les mots.

Voir aussi setFontWordSpacing().

bool QTextCharFormat::isAnchor() const

Renvoie « true » si le texte est formaté comme un lien ; sinon, renvoie « false ».

Voir également 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 présentant ce format représente une ancre et est mis en forme de manière appropriée ; dans le cas contraire, le texte est mis en forme normalement. (Les ancres sont des liens hypertextes qui apparaissent souvent soulignés et dans une couleur différente de celle du texte brut.)

Le rendu du texte est indépendant du fait que le format comporte ou non une ancre valide définie. Utilisez ` setAnchorHref()` et, éventuellement, ` setAnchorNames()` pour créer un lien hypertexte.

Voir également isAnchor().

void QTextCharFormat::setAnchorHref(const QString &value)

Définit le lien hypertexte pour le format texte sur l'value fournie. Il s'agit généralement d'une URL telle que « http://example.com/index.html ».

L'ancre s'affichera avec l'value comme texte d'affichage ; si vous souhaitez afficher un texte différent, appelez la fonction setAnchorNames().

Pour mettre le texte en forme de lien hypertexte, utilisez setAnchor().

Voir également anchorHref().

void QTextCharFormat::setAnchorNames(const QStringList &names)

Définit l'ancrage du format de texte names. Pour que l'ancrage fonctionne comme un lien hypertexte, la destination doit être définie à l'aide de setAnchorHref() et l'ancrage doit être activé à l'aide de setAnchor().

Voir également anchorNames().

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

Définit la ligne de base (en % de la hauteur) du texte à l'adresse baseline. Une valeur positive déplace le texte vers le haut, du pourcentage 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 également baselineOffset(), setSubScriptBaseline(), subScriptBaseline(), setSuperScriptBaseline() et superScriptBaseline().

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

Définit l'font e du format de texte.

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 également font().

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

Définit la capitalisation du texte affiché avec cette police sur « capitalization ».

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

Voir également fontCapitalization().

void QTextCharFormat::setFontFamilies(const QStringList &families)

Définit la police du format de texte families.

Voir également 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 sur « fontFeatures ».

Cette fonction a été introduite dans Qt 6.11.

Voir également ` fontFeatures()` et ` QFont::setFeature()`.

void QTextCharFormat::setFontFixedPitch(bool fixedPitch)

Si fixedPitch est vrai, définit la police du format de texte sur une police à espacement fixe ; dans le cas contraire, une police à espacement variable est utilisée.

Voir également fontFixedPitch() et setFont().

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

Définit la préférence d'hinting de la police du format de texte sur « hintingPreference ».

Voir également fontHintingPreference(), setFont() et QFont::setHintingPreference().

void QTextCharFormat::setFontItalic(bool italic)

Si italic est vrai, définit la police du format de texte en italique ; dans le cas contraire, la police sera en droit.

Voir également fontItalic() et setFont().

void QTextCharFormat::setFontKerning(bool enable)

Active le crénage pour cette police si la valeur de « enable » est « true » ; sinon, il le désactive.

Lorsque le crénage est activé, les métriques 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 également fontKerning() et setFont().

void QTextCharFormat::setFontLetterSpacing(qreal spacing)

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

Pour l'espacement en pourcentage, une valeur de 100 correspond à l'espacement par défaut ; une valeur de 200 double l'espace occupé par 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 sur « letterSpacingType ».

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

void QTextCharFormat::setFontOverline(bool overline)

Si overline est vrai, la police du format de texte est affichée avec une ligne au-dessus ; dans le cas contraire, elle s'affiche sans ligne au-dessus.

Voir également fontOverline() et setFont().

void QTextCharFormat::setFontPointSize(qreal size)

Définit la police du format de texte size.

Voir également fontPointSize() et setFont().

void QTextCharFormat::setFontStretch(int factor)

Définit le facteur d'étirement de la police sur « factor ».

Le facteur d'étirement modifie la largeur de tous les caractères de la police d'un pourcentage donné. Par exemple, si vous définissez « factor » sur 150, tous les caractères de la police seront 1,5 fois (soit 150 %) plus larges. Le facteur d'étirement par défaut est 100. Le facteur d'étirement minimum est 1 et le facteur d'étirement maximum est 4 000.

Le facteur d'étirement s'applique uniquement aux polices vectorielles. Il est ignoré pour les polices matricielles.

Voir également fontStretch().

void QTextCharFormat::setFontStrikeOut(bool strikeOut)

Si strikeOut est vrai, la police du format de texte est définie avec la fonction « barré » activée (avec une ligne horizontale traversant le texte) ; sinon, le texte s'affiche sans être barré.

Voir également ` 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 prend pas en charge les indications de style sous X11, car ces informations ne sont pas fournies par le système de fenêtrage.

Voir également fontStyleHint(), setFont() et QFont::setStyleHint().

void QTextCharFormat::setFontStyleName(const QString &styleName)

Définit la police du format de texte styleName.

Voir également fontStyleName(), setFont() et QFont::setStyleName().

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

Définit le style de police strategy.

Voir également fontStyleStrategy(), setFont() et QFont::setStyleStrategy().

void QTextCharFormat::setFontUnderline(bool underline)

Si la valeur de underline est « true », la police du format de texte est soulignée ; dans le cas contraire, elle s'affiche sans soulignement.

Voir également ` 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 sur « fontVariableAxes ».

Cette fonction a été introduite dans Qt 6.11.

Voir également fontVariableAxes() et QFont::setVariableAxis().

void QTextCharFormat::setFontWeight(int weight)

Définit l'épaisseur de la police du format de texte sur « weight ».

Voir également fontWeight(), setFont() et QFont::Weight.

void QTextCharFormat::setFontWordSpacing(qreal spacing)

Définit l'espacement entre les mots de ce format selon la valeur indiqué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 pourcentage de la hauteur de la police, de manière à ce qu'elle soit à baseline. La valeur par défaut est 16,67 % (1/6 de la hauteur).

Cette fonction a été introduite dans Qt 6.0.

Voir également subScriptBaseline(), setSuperScriptBaseline(), superScriptBaseline(), setBaselineOffset() et baselineOffset().

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

Définit la ligne de base de l'exposant en pourcentage de la hauteur de la police, selon la formule baseline. La valeur par défaut est 50 % (la moitié de la hauteur).

Cette fonction a été introduite dans Qt 6.0.

Voir également superScriptBaseline(), setSubScriptBaseline(), subScriptBaseline(), setBaselineOffset() et baselineOffset().

void QTextCharFormat::setTextOutline(const QPen &pen)

Définit le stylo utilisé pour tracer les contours des caractères sur l'pen.

Voir aussi textOutline().

void QTextCharFormat::setToolTip(const QString &text)

Définit l'info-bulle d'un fragment de texte sur l'adresse text indiquée.

Voir aussi toolTip().

void QTextCharFormat::setUnderlineColor(const QColor &color)

Définit la couleur utilisée pour tracer les soulignements, les surlignements et les barrages sur les caractères ayant ce format, en fonction de la valeur spécifiée dans color.

Voir aussi underlineColor().

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

Définit le style de soulignement du texte sur « style ».

Voir aussi underlineStyle().

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

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

Voir également verticalAlignment().

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

Renvoie la ligne de base de l'indice sous forme de pourcentage de la hauteur de la police.

Cette fonction a été introduite dans Qt 6.0.

Voir également setSubScriptBaseline(), setSuperScriptBaseline(), superScriptBaseline(), setBaselineOffset() et baselineOffset().

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

Renvoie la ligne de base de l'exposant sous forme de pourcentage de la hauteur de la police.

Cette fonction a été introduite dans Qt 6.0.

Voir également 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 tracer les soulignements, les surlignements et les barrages sur les caractères ayant 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().