QTextCharFormat Class

Dokumentation der Mitgliedsfunktionen

QTextCharFormat::QTextCharFormat()

Konstruiert ein neues Zeichenformat-Objekt.

QString QTextCharFormat::anchorHref() const

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

Siehe auch setAnchorHref().

QStringList QTextCharFormat::anchorNames() const

Gibt die Ankernamen zurück, die mit diesem Textformat verbunden sind, oder eine leere String-Liste, wenn keine gesetzt wurde. Wenn die Ankernamen gesetzt sind, kann der Text mit diesem Format das Ziel eines Hypertext-Links sein.

Siehe auch setAnchorNames().

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

Gibt den Grundlinienversatz 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.

Siehe auch setFont().

QFont::Capitalization QTextCharFormat::fontCapitalization() const

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

Siehe auch setFontCapitalization().

QVariant QTextCharFormat::fontFamilies() const

Gibt die Schriftfamilien des Textformats zurück.

Siehe auch setFontFamilies() und font().

bool QTextCharFormat::fontFixedPitch() const

Gibt true zurück, wenn die Schriftart des Textformats einen festen Abstand hat; andernfalls false.

Siehe auch setFontFixedPitch() und font().

QFont::HintingPreference QTextCharFormat::fontHintingPreference() const

Gibt die für dieses Textformat eingestellte Hinting-Präferenz 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 das Kerning der Schriftart aktiviert ist.

Siehe auch setFontKerning() und font().

qreal QTextCharFormat::fontLetterSpacing() const

Gibt den aktuellen Buchstabenabstand zurück.

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

QFont::SpacingType QTextCharFormat::fontLetterSpacingType() const

Gibt die Art des Buchstabenabstands dieses Formats zurück.

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

bool QTextCharFormat::fontOverline() const

Gibt true zurück, wenn die Schriftart des Textformats overlined ist; andernfalls false.

Siehe auch setFontOverline() und font().

qreal QTextCharFormat::fontPointSize() const

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

Siehe auch setFontPointSize() und font().

int QTextCharFormat::fontStretch() const

Gibt die aktuelle Schriftausdehnung 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 auf den 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 Schriftstilstrategie 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().

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 des Wortabstands 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 wahr ist, stellt Text mit diesem Format einen Anker dar und wird entsprechend formatiert; andernfalls wird der Text normal formatiert. (Anker sind Hyperlinks, die oft unterstrichen und in einer anderen Farbe als normaler Text dargestellt werden.)

Die Art und Weise, wie der Text dargestellt wird, ist unabhängig davon, ob das Format einen gültigen Anker definiert hat oder nicht. Verwenden Sie setAnchorHref() und optional setAnchorNames(), um einen Hypertext-Link zu erstellen.

Siehe auch isAnchor().

void QTextCharFormat::setAnchorHref(const QString &value)

Setzt den Hypertext-Link für das Textformat auf die angegebene value. Dies ist normalerweise eine URL wie "http://example.com/index.html".

Der Anker wird mit 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)

Setzt den Anker des Textformats 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)

Setzt die font des Textformats.

Wenn behavior gleich QTextCharFormat::FontPropertiesAll ist, wird die nicht explizit eingestellte Schrifteigenschaft so behandelt, als wäre sie mit dem Standardwert eingestellt; wenn behavior gleich QTextCharFormat::FontPropertiesSpecifiedOnly ist, wird die nicht explizit eingestellte Schrifteigenschaft ignoriert und der entsprechende Eigenschaftswert bleibt unverändert.

Siehe auch font().

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

Stellt die Großschreibung des Textes, der in dieser Schriftart erscheint, auf capitalization ein.

Die Großschreibung einer Schriftart bewirkt, dass der Text im ausgewählten Großbuchstabenmodus erscheint.

Siehe auch fontCapitalization().

void QTextCharFormat::setFontFamilies(const QStringList &families)

Legt die Schriftart des Textformats families fest.

Siehe auch fontFamilies() und setFont().

void QTextCharFormat::setFontFixedPitch(bool fixedPitch)

Wenn fixedPitch true ist, wird die Schriftart des Textformats auf einen festen Abstand eingestellt; andernfalls wird eine Schriftart ohne festen Abstand verwendet.

Siehe auch fontFixedPitch() und setFont().

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

Setzt die Hinting-Präferenz der Schriftart des Textformats auf hintingPreference.

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

void QTextCharFormat::setFontItalic(bool italic)

Wenn italic true ist, wird die Schriftart des Textformats auf kursiv gesetzt; andernfalls wird die Schriftart nicht kursiv sein.

Siehe auch fontItalic() und setFont().

void QTextCharFormat::setFontKerning(bool enable)

Aktiviert Kerning für diese Schriftart, wenn enable true ist; andernfalls wird es deaktiviert.

Wenn Kerning aktiviert ist, addieren sich die Glyphenmetriken nicht mehr, selbst bei lateinischem Text. Mit anderen Worten, die Annahme, dass width('a') + width('b') gleich width("ab") ist, ist nicht unbedingt richtig.

Siehe auch fontKerning() und setFont().

void QTextCharFormat::setFontLetterSpacing(qreal spacing)

Setzt den Buchstabenabstand dieses Formats auf den angegebenen spacing. Die Bedeutung des Wertes hängt von der Art des Buchstabenabstands ab.

Bei prozentualen Abständen gibt ein Wert von 100 den Standardabstand an; ein Wert von 200 verdoppelt den Abstand, den ein Buchstabe benötigt.

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

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

Setzt den Buchstabenabstandstyp dieses Formats auf letterSpacingType.

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

void QTextCharFormat::setFontOverline(bool overline)

Wenn overline true ist, wird die Schrift des Textformats überstrichen, andernfalls wird die Schrift nicht überstrichen dargestellt.

Siehe auch fontOverline() und setFont().

void QTextCharFormat::setFontPointSize(qreal size)

Setzt die Schriftart des Textformats size.

Siehe auch fontPointSize() und setFont().

void QTextCharFormat::setFontStretch(int factor)

Setzt den Dehnungsfaktor für die Schriftart auf factor.

Der Streckungsfaktor ändert die Breite aller Zeichen in der Schriftart um den Faktor Prozent. Wenn Sie z. B. factor auf 150 setzen, werden alle Zeichen in der Schrift um das 1,5-fache (d. h. 150 %) breiter. Der Standard-Streckungsfaktor ist 100. Der minimale Streckungsfaktor ist 1 und der maximale Streckungsfaktor ist 4000.

Der Streckungsfaktor wird nur auf Umrissschriften angewendet. Bei Bitmap-Schriften wird der Dehnungsfaktor ignoriert.

Siehe auch fontStretch().

void QTextCharFormat::setFontStrikeOut(bool strikeOut)

Wenn strikeOut true ist, wird die Schriftart des Textformats mit aktivierter Durchstreichung (mit einer horizontalen Linie durch sie) eingestellt; andernfalls wird sie ohne Durchstreichung angezeigt.

Siehe auch fontStrikeOut() und setFont().

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

Setzt den Schriftstil hint und strategy.

Qt unterstützt keine Style-Hinweise unter X11, da diese Information nicht vom Fenstersystem bereitgestellt wird.

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

void QTextCharFormat::setFontStyleName(const QString &styleName)

Legt die Schriftart des Textformats styleName fest.

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 true ist, wird die Schriftart des Textformats unterstrichen, andernfalls wird sie nicht unterstrichen dargestellt.

Siehe auch fontUnderline() und setFont().

void QTextCharFormat::setFontWeight(int weight)

Setzt die Schriftstärke des Textformats auf weight.

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

void QTextCharFormat::setFontWordSpacing(qreal spacing)

Setzt den Wortabstand dieses Formats auf den angegebenen Wert spacing, in Pixeln.

Siehe auch fontWordSpacing().

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

Setzt die Grundlinie der tiefgestellten Schrift in % der Schrifthöhe auf baseline. Der Standardwert ist 16,67% (1/6 der Hö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)

Setzt die Grundlinie der hochgestellten Schrift in % der Schrifthöhe auf baseline. Der Standardwert ist 50% (1/2 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, mit dem die Umrisse der Zeichen gezeichnet werden, auf den angegebenen pen.

Siehe auch textOutline().

void QTextCharFormat::setToolTip(const QString &text)

Setzt den Tooltip für ein Textfragment auf den angegebenen text.

Siehe auch toolTip().

void QTextCharFormat::setUnderlineColor(const QColor &color)

Setzt die Farbe, mit der Unterstreichungen, Überstreichungen und Durchstreichungen auf den Zeichen mit diesem Format gezeichnet werden, auf die angegebene color.

Siehe auch underlineColor().

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

Setzt den Stil der Unterstreichung des Textes auf style.

Siehe auch underlineStyle().

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

Setzt die vertikale Ausrichtung für die Zeichen mit diesem Format auf die angegebene alignment.

Siehe auch verticalAlignment().

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

Gibt die Grundlinie der tiefgestellten Schrift in % 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 der hochgestellten Schrift in % 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 ein Textfragment angezeigt wird.

Siehe auch setToolTip().

QColor QTextCharFormat::underlineColor() const

Gibt die Farbe zurück, mit der Unterstreichungen, Überstreichungen und Durchstreichungen auf den Zeichen mit diesem Format gezeichnet werden.

Siehe auch setUnderlineColor().

QTextCharFormat::UnderlineStyle QTextCharFormat::underlineStyle() const

Gibt den Stil der 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().