QTextCharFormat Class

Dokumentation der Member-Funktionen

QTextCharFormat::QTextCharFormat()

Erstellt ein neues Zeichenformatobjekt.

QString QTextCharFormat::anchorHref() const

Gibt den Hypertext-Link des Textformats zurück oder eine leere Zeichenkette, falls keiner festgelegt wurde.

Siehe auch ` setAnchorHref()`.

QStringList QTextCharFormat::anchorNames() const

Gibt die mit diesem Textformat verknüpften Ankernamen zurück oder eine leere Zeichenfolgenliste, falls keine festgelegt wurden. Sind die Ankernamen festgelegt, kann Text in diesem Format das Ziel eines Hypertext-Links sein.

Siehe auch „ setAnchorNames()“.

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

Gibt den Versatz gegenüber der Grundlinie in % zurück.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch setBaselineOffset(), setSubScriptBaseline(), subScriptBaseline(), setSuperScriptBaseline() und superScriptBaseline().

QFont QTextCharFormat::font() const

Gibt die Schriftart für dieses Zeichenformat zurück.

Diese Funktion berücksichtigt die Schriftattribute des Formats (wie z. B. ` fontWeight()` und ` fontPointSize()`) und wendet sie auf die Standardschriftart an, die wie folgt definiert ist. Ist das Format Teil eines Dokuments, handelt es sich um die Standardschriftart des Dokuments. Andernfalls werden die Eigenschaften auf eine standardmäßig erstellte ` QFont` angewendet.

Wenn beispielsweise die Schriftgröße dieses Formats gegenüber der Standardschriftart nicht geändert wurde, gibt ` fontPointSize()` den Wert 0 zurück, während ` font().pointSize() ` die tatsächlich zum Zeichnen verwendete Größe zurückgibt.

Siehe auch setFont() und QTextDocument::defaultFont().

QFont::Capitalization QTextCharFormat::fontCapitalization() const

Gibt den aktuellen Großschreibungsstil der Schriftart zurück.

Siehe auch „ setFontCapitalization()“.

QVariant QTextCharFormat::fontFamilies() const

Gibt die Schriftfamilien des Textformats zurück.

Siehe auch setFontFamilies() und font().

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

Ruft die typografischen Eigenschaften der Schriftart des Textformats ab.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch „ setFontFeatures()“.

bool QTextCharFormat::fontFixedPitch() const

Gibt „ true “ zurück, wenn das Schriftformat eine Monospace-Schriftart ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch setFontFixedPitch() und font().

QFont::HintingPreference QTextCharFormat::fontHintingPreference() const

Gibt die für dieses Textformat festgelegten Hinting-Einstellungen zurück.

Siehe auch setFontHintingPreference(), font() und QFont::hintingPreference().

bool QTextCharFormat::fontItalic() const

Gibt „ true “ zurück, wenn die Schriftart des Textformats kursiv ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch setFontItalic() und font().

bool QTextCharFormat::fontKerning() const

Gibt „ true “ zurück, wenn die Schriftkernung aktiviert ist.

Siehe auch „ setFontKerning()“ und „ font()“.

qreal QTextCharFormat::fontLetterSpacing() const

Gibt den aktuellen Zeichenabstand zurück.

Siehe auch setFontLetterSpacing(), setFontLetterSpacingType() und fontLetterSpacingType().

QFont::SpacingType QTextCharFormat::fontLetterSpacingType() const

Gibt den Zeichenabstandstyp dieses Formats zurück.

Siehe auch „ setFontLetterSpacingType()“, „ setFontLetterSpacing()“ und „ fontLetterSpacing()“.

bool QTextCharFormat::fontOverline() const

Gibt „ true “ zurück, wenn die Schriftart des Textformats überstrichen ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch setFontOverline() und font().

qreal QTextCharFormat::fontPointSize() const

Gibt die Schriftgröße zurück, die zur Darstellung von Text in diesem Format verwendet wird.

Siehe auch „ setFontPointSize()“ und „ font()“.

int QTextCharFormat::fontStretch() const

Gibt die aktuelle Schriftstreckung zurück.

Siehe auch ` setFontStretch()`.

bool QTextCharFormat::fontStrikeOut() const

Gibt „ true “ zurück, wenn die Schriftart des Textformats durchgestrichen ist (mit einer horizontalen Linie durchzogen); andernfalls wird „ false “ zurückgegeben.

Siehe auch setFontStrikeOut() und font().

QFont::StyleHint QTextCharFormat::fontStyleHint() const

Gibt den Hinweis zum Schriftstil zurück.

Siehe auch setFontStyleHint() und font().

QVariant QTextCharFormat::fontStyleName() const

Gibt den Namen des Schriftstils des Textformats zurück.

Siehe auch setFontStyleName(), font() und QFont::styleName().

QFont::StyleStrategy QTextCharFormat::fontStyleStrategy() const

Gibt die aktuelle Strategie für den Schriftstil zurück.

Siehe auch „ setFontStyleStrategy()“ und „ font()“.

bool QTextCharFormat::fontUnderline() const

Gibt „ true “ zurück, wenn die Schriftart des Textformats unterstrichen ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch setFontUnderline() und font().

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

Ruft die variablen Achsen der Schriftart des Textformats ab.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch ` setFontVariableAxes()`.

int QTextCharFormat::fontWeight() const

Gibt die Schriftstärke des Textformats zurück.

Siehe auch „ setFontWeight()“, „ font()“ und „ QFont::Weight “.

qreal QTextCharFormat::fontWordSpacing() const

Gibt den aktuellen Wert für den Wortabstand zurück.

Siehe auch „ setFontWordSpacing()“.

bool QTextCharFormat::isAnchor() const

Gibt „ true “ zurück, wenn der Text als Anker formatiert ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch setAnchor(), setAnchorHref() und setAnchorNames().

bool QTextCharFormat::isValid() const

Gibt „ true “ zurück, wenn dieses Zeichenformat gültig ist; andernfalls wird „false“ zurückgegeben.

void QTextCharFormat::setAnchor(bool anchor)

Wenn „ anchor “ auf „true“ gesetzt ist, stellt Text in diesem Format einen Anker dar und wird entsprechend formatiert; andernfalls wird der Text normal formatiert. (Anker sind Hyperlinks, die häufig unterstrichen und in einer anderen Farbe als der normale Text dargestellt werden.)

Die Darstellung des Textes ist unabhängig davon, ob für das Format ein gültiger Anker definiert ist oder nicht. Verwenden Sie ` setAnchorHref()` und optional ` setAnchorNames()` (), um einen Hypertext-Link zu erstellen.

Siehe auch isAnchor().

void QTextCharFormat::setAnchorHref(const QString &value)

Legt den Hypertext-Link für das Textformat auf die angegebene Adresse value fest. Dabei handelt es sich in der Regel um eine URL wie „http://example.com/index.html“.

Der Anker wird mit der URL value als Anzeigetext angezeigt; wenn Sie einen anderen Text anzeigen möchten, rufen Sie setAnchorNames() auf.

Um den Text als Hypertext-Link zu formatieren, verwenden Sie „ setAnchor()“.

Siehe auch anchorHref().

void QTextCharFormat::setAnchorNames(const QStringList &names)

Legt den Anker des Textformats fest: names. Damit der Anker als Hyperlink funktioniert, muss das Ziel mit setAnchorHref() festgelegt und der Anker mit setAnchor() aktiviert werden.

Siehe auch anchorNames().

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

Setzt die Grundlinie (in % der Höhe) des Textes auf „ baseline “. Ein positiver Wert verschiebt den Text um den entsprechenden Prozentsatz nach oben; ein negativer Wert verschiebt ihn nach unten. Der Standardwert ist 0.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch baselineOffset(), setSubScriptBaseline(), subScriptBaseline(), setSuperScriptBaseline() und superScriptBaseline().

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

Legt die „ font “ des Textformats fest.

Wenn „ behavior “ auf „ QTextCharFormat::FontPropertiesAll “ gesetzt ist, wird die nicht explizit festgelegte Schriftarteneigenschaft so behandelt, als wäre sie mit dem Standardwert festgelegt worden; wenn „ behavior “ auf „ QTextCharFormat::FontPropertiesSpecifiedOnly “ gesetzt ist, wird die nicht explizit festgelegte Schriftarteneigenschaft ignoriert und der jeweilige Eigenschaftswert bleibt unverändert.

Siehe auch font().

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

Legt die Großschreibung des in dieser Schriftart angezeigten Textes auf „ capitalization “ fest.

Die Großschreibung einer Schriftart sorgt dafür, dass der Text im ausgewählten Großschreibungsmodus angezeigt wird.

Siehe auch „ fontCapitalization()“.

void QTextCharFormat::setFontFamilies(const QStringList &families)

Legt die Schriftart des Textformats fest: families.

Siehe auch fontFamilies() und setFont().

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

Legt die typografischen Eigenschaften der Schriftart des Textformats auf „ fontFeatures “ fest.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch „ fontFeatures()“ und „ QFont::setFeature()“.

void QTextCharFormat::setFontFixedPitch(bool fixedPitch)

Wenn „ fixedPitch “ wahr ist, wird die Schriftart des Textformats auf eine Schriftart mit fester Zeichenbreite festgelegt; andernfalls wird eine Schriftart ohne feste Zeichenbreite verwendet.

Siehe auch „ fontFixedPitch()“ und „ setFont()“.

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

Legt die Hinting-Einstellung der Schriftart des Textformats auf „ hintingPreference “ fest.

Siehe auch „ fontHintingPreference()“, „ setFont()“ und „ QFont::setHintingPreference()“.

void QTextCharFormat::setFontItalic(bool italic)

Wenn „ italic “ wahr ist, wird die Schriftart des Textformats auf kursiv gesetzt; andernfalls ist die Schriftart nicht kursiv.

Siehe auch „ fontItalic()“ und „ setFont()“.

void QTextCharFormat::setFontKerning(bool enable)

Aktiviert das Kerning für diese Schriftart, wenn „ enable “ auf „true“ gesetzt ist; andernfalls wird es deaktiviert.

Wenn das Kerning aktiviert ist, addieren sich die Glyphenmaße nicht mehr, selbst bei lateinischem Text. Mit anderen Worten: Die Annahme, dass width('a') + width('b') gleich width("ab") ist, trifft nicht unbedingt zu.

Siehe auch „ fontKerning()“ und „ setFont()“.

void QTextCharFormat::setFontLetterSpacing(qreal spacing)

Legt den Buchstabenabstand dieses Formats auf den angegebenen Wert „ spacing “ fest. Die Bedeutung des Werts hängt vom Typ des Schriftart-Buchstabenabstands ab.

Bei prozentualem Abstand entspricht ein Wert von 100 dem Standardabstand; ein Wert von 200 verdoppelt den Platz, den ein Buchstabe einnimmt.

Siehe auch „ fontLetterSpacing()“, „ setFontLetterSpacingType()“ und „ fontLetterSpacingType()“.

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

Legt den Zeichenabstandstyp für dieses Format auf „ letterSpacingType “ fest.

Siehe auch „ fontLetterSpacingType()“, „ setFontLetterSpacing()“ und „ fontLetterSpacing()“.

void QTextCharFormat::setFontOverline(bool overline)

Wenn „ overline “ wahr ist, wird die Schriftart des Textformats mit einer Überlinie versehen; andernfalls wird die Schriftart ohne Überlinie angezeigt.

Siehe auch „ fontOverline()“ und „ setFont()“.

void QTextCharFormat::setFontPointSize(qreal size)

Legt die Schriftart des Textformats fest: size.

Siehe auch fontPointSize() und setFont().

void QTextCharFormat::setFontStretch(int factor)

Legt den Stretch-Faktor für die Schriftart auf „ factor “ fest.

Der Stretch-Faktor verändert die Breite aller Zeichen in der Schriftart um den Faktor „prozent“. Wird beispielsweise „ factor “ auf 150 gesetzt, werden alle Zeichen der Schriftart um das 1,5-Fache (d. h. 150 %) breiter. Der Standard-Dehnungsfaktor beträgt 100. Der minimale Dehnungsfaktor ist 1, der maximale Dehnungsfaktor beträgt 4000.

Der Stretch-Faktor wird nur auf Outline-Schriftarten angewendet. Bei Bitmap-Schriftarten wird der Stretch-Faktor ignoriert.

Siehe auch fontStretch().

void QTextCharFormat::setFontStrikeOut(bool strikeOut)

Wenn „ strikeOut “ wahr ist, wird die Schriftart des Textformats mit Durchstreichung (mit einer horizontalen Linie darüber) festgelegt; andernfalls wird der Text ohne Durchstreichung angezeigt.

Siehe auch „ fontStrikeOut()“ und „ setFont()“.

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

Legt den Schriftstil fest: hint und strategy.

Qt unterstützt keine Stilhinweise unter X11, da diese Informationen vom Fenstersystem nicht bereitgestellt werden.

Siehe auch fontStyleHint(), setFont() und QFont::setStyleHint().

void QTextCharFormat::setFontStyleName(const QString &styleName)

Legt die Schriftart des Textformats fest: styleName.

Siehe auch fontStyleName(), setFont() und QFont::setStyleName().

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

Legt den Schriftstil „ strategy “ fest.

Siehe auch fontStyleStrategy(), setFont() und QFont::setStyleStrategy().

void QTextCharFormat::setFontUnderline(bool underline)

Wenn „ underline “ wahr ist, wird die Schriftart des Textformats unterstrichen; andernfalls wird sie ohne Unterstreichung angezeigt.

Siehe auch „ fontUnderline()“ und „ setFont()“.

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

Setzt die Achsen der Schriftart des Textformats auf „ fontVariableAxes “.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch „ fontVariableAxes()“ und „ QFont::setVariableAxis()“.

void QTextCharFormat::setFontWeight(int weight)

Legt die Schriftstärke des Textformats auf „ weight “ fest.

Siehe auch fontWeight(), setFont() und QFont::Weight.

void QTextCharFormat::setFontWordSpacing(qreal spacing)

Legt den Wortabstand dieses Formats auf den angegebenen Wert spacing in Pixeln fest.

Siehe auch ` fontWordSpacing()`.

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

Legt die Grundlinie des Index als Prozentsatz der Schrifthöhe fest, um „ baseline “ zu erzielen. Der Standardwert beträgt 16,67 % (1/6 der Schrifthöhe).

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch subScriptBaseline(), setSuperScriptBaseline(), superScriptBaseline(), setBaselineOffset() und baselineOffset().

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

Legt die Grundlinie des hochgestellten Zeichens als Prozentsatz der Schrifthöhe für „ baseline “ fest. Der Standardwert beträgt 50 % (die Hälfte der Höhe).

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch superScriptBaseline(), setSubScriptBaseline(), subScriptBaseline(), setBaselineOffset() und baselineOffset().

void QTextCharFormat::setTextOutline(const QPen &pen)

Setzt den Stift, der zum Zeichnen der Zeichenumrisse verwendet wird, auf den angegebenen „ pen “.

Siehe auch textOutline().

void QTextCharFormat::setToolTip(const QString &text)

Setzt den Tooltip für einen Textabschnitt auf den angegebenen text.

Siehe auch toolTip().

void QTextCharFormat::setUnderlineColor(const QColor &color)

Legt die Farbe fest, die zum Zeichnen von Unterstreichungen, Überestrichen und Durchstreichungen bei Zeichen mit diesem Format verwendet wird, und zwar auf den angegebenen Wert „ color “.

Siehe auch ` underlineColor()` ().

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

Legt den Stil für die Unterstreichung des Textes auf „ style “ fest.

Siehe auch ` underlineStyle()`.

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

Legt die vertikale Ausrichtung fest, die für die Zeichen mit diesem Format verwendet wird, und zwar gemäß der angegebenen „ alignment “.

Siehe auch verticalAlignment().

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

Gibt die Grundlinie des Index als Prozentsatz der Schrifthöhe zurück.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch setSubScriptBaseline(), setSuperScriptBaseline(), superScriptBaseline(), setBaselineOffset() und baselineOffset().

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

Gibt die Grundlinie des hochgestellten Zeichens als Prozentsatz der Schrifthöhe zurück.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch setSuperScriptBaseline(), setSubScriptBaseline(), subScriptBaseline(), setBaselineOffset() und baselineOffset().

QPen QTextCharFormat::textOutline() const

Gibt den Stift zurück, der zum Zeichnen der Umrisse von Zeichen in diesem Format verwendet wurde.

Siehe auch „ setTextOutline()“.

QString QTextCharFormat::toolTip() const

Gibt den Tooltip zurück, der für einen Textabschnitt angezeigt wird.

Siehe auch setToolTip().

QColor QTextCharFormat::underlineColor() const

Gibt die Farbe zurück, die zum Zeichnen von Unterstreichungen, Überestrichungen und Durchstreichungen bei Zeichen mit diesem Format verwendet wird.

Siehe auch „ setUnderlineColor()“.

QTextCharFormat::UnderlineStyle QTextCharFormat::underlineStyle() const

Gibt den Stil für die Unterstreichung des Textes zurück.

Siehe auch ` setUnderlineStyle()`.

QTextCharFormat::VerticalAlignment QTextCharFormat::verticalAlignment() const

Gibt die vertikale Ausrichtung zurück, die für Zeichen mit diesem Format verwendet wird.

Siehe auch ` setVerticalAlignment()`.