QSGTextNode Class

Dokumentation der Mitgliedsfunktionen

void QSGTextNode::addTextDocument(QPointF position, QTextDocument *document, int selectionStart = -1, int selectionCount = -1)

Fügt den Inhalt von document an den Textknoten position an. Wenn selectionStart >= 0 ist, wird damit das erste Zeichen in einem ausgewählten Bereich von selectionCount Anzahl der Zeichen markiert. Die Auswahl wird als Hintergrundfüllung mit selectionColor() dargestellt und der ausgewählte Text wird in selectionTextColor() wiedergegeben.

Diese Funktion leitet ihre Argumente an die virtuelle Funktion doAddTextDocument() weiter.

Siehe auch clear() und doAddTextDocument().

void QSGTextNode::addTextLayout(QPointF position, QTextLayout *layout, int selectionStart = -1, int selectionCount = -1, int lineStart = 0, int lineCount = -1)

Fügt den Inhalt von layout an den Textknoten position an. Wenn selectionStart >= 0 ist, wird damit das erste Zeichen in einem ausgewählten Bereich von selectionCount Anzahl der Zeichen markiert. Die Auswahl wird als Hintergrundfüllung mit selectionColor() dargestellt und der ausgewählte Text wird in selectionTextColor() wiedergegeben.

Der Einfachheit halber können lineStart und lineCount verwendet werden, um den Bereich der QTextLine Objekte auszuwählen, die in das Layout aufgenommen werden sollen. Dies kann z. B. bei der Erstellung von elidierten Layouts nützlich sein. Wenn lineCount < 0 ist, dann schließt der Knoten die Zeilen von lineStart bis zum Ende des Layouts ein.

Diese Funktion leitet ihre Argumente an die virtuelle Funktion doAddTextLayout() weiter.

Siehe auch clear() und doAddTextLayout().

[pure virtual] void QSGTextNode::clear()

Löscht den Inhalt des Knotens, wobei Knoten und andere Daten, die die ihm hinzugefügten Layouts und Dokumente darstellen, gelöscht werden.

Siehe auch addTextLayout() und addTextDocument().

[pure virtual] QColor QSGTextNode::color() const

Gibt die Hauptfarbe zurück, die beim Rendern des Textes verwendet wird.

Siehe auch setColor().

[pure virtual] QSGTexture::Filtering QSGTextNode::filtering() const

Gibt den Abtastmodus zurück, der bei der Skalierung von Bildern, die Teil des angezeigten Textes sind, verwendet wird.

Siehe auch setFiltering().

[pure virtual] QColor QSGTextNode::linkColor() const

Gibt die Farbe der Hyperlinks im Text zurück.

Siehe auch setLinkColor().

[pure virtual] QSGTextNode::RenderType QSGTextNode::renderType() const

Gibt den Typ des Glyphenknotens zurück, der für die Darstellung des Textes verwendet wird.

Siehe auch setRenderType().

[pure virtual] int QSGTextNode::renderTypeQuality() const

Gibt die Qualität des Rendertyps des Knotens zurück. Siehe setRenderTypeQuality() für Details.

Siehe auch setRenderTypeQuality().

[pure virtual] QColor QSGTextNode::selectionColor() const

Gibt die Farbe des Auswahlhintergrunds zurück, wenn ein beliebiger Teil des Textes als ausgewählt markiert ist.

Siehe auch setSelectionColor().

[pure virtual] QColor QSGTextNode::selectionTextColor() const

Gibt die Farbe des Auswahltextes zurück, wenn ein beliebiger Teil des Textes als ausgewählt markiert ist.

Siehe auch setSelectionTextColor().

[pure virtual] void QSGTextNode::setColor(QColor color)

Legt die Hauptfarbe fest, die beim Rendern des Textes auf color verwendet wird.

Die Vorgabe ist Schwarz: QColor(0, 0, 0).

Siehe auch color().

[pure virtual] void QSGTextNode::setFiltering(QSGTexture::Filtering filtering)

Legt den Abtastmodus fest, der verwendet wird, wenn Bilder, die Teil des angezeigten Textes sind, auf filtering skaliert werden. Für gleichmäßig skalierte Bilder verwenden Sie hier QSGTexture::Linear.

Die Vorgabe ist QSGTexture::Nearest.

Siehe auch filtering().

[pure virtual] void QSGTextNode::setLinkColor(QColor linkColor)

Legt die Farbe von oder Hyperlinks zu linkColor im Text fest.

Die Standardeinstellung ist blau: QColor(0, 0, 255).

Siehe auch linkColor().

[pure virtual] void QSGTextNode::setRenderType(QSGTextNode::RenderType renderType)

Setzt den Typ des verwendeten Glyphknotens auf renderType.

Die Vorgabe ist QtRendering.

Siehe auch renderType().

[pure virtual] void QSGTextNode::setRenderTypeQuality(int renderTypeQuality)

Wenn das verwendete renderType() dies unterstützt, legen Sie die Qualität fest, die beim Rendern des Textes verwendet werden soll. Wenn dies unterstützt wird, kann dies verwendet werden, um visuelle Wiedergabetreue gegen Ausführungsgeschwindigkeit oder Speicher zu tauschen.

Wenn renderTypeQuality < 0 ist, wird die Standardqualität verwendet.

renderTypeQuality kann eine beliebige ganze Zahl sein, obwohl es bei extremen Werten zu Einschränkungen durch die zugrunde liegende Grafikhardware kommen kann. Das Element Qt Quick Text arbeitet mit den folgenden vordefinierten Werten:

Dieser Wert wird derzeit nur vom Rendertyp QtRendering beachtet. Seine Einstellung ändert die Auflösung der Abstandsfelder, die zur Darstellung der Glyphen verwendet werden. Eine Einstellung über dem Normalwert führt zu einem höheren Speicherverbrauch, verringert aber Filterungsartefakte bei sehr großem Text.

Die Voreinstellung ist -1.

Siehe auch renderTypeQuality().

[pure virtual] void QSGTextNode::setSelectionColor(QColor color)

Legt die Farbe des Auswahlhintergrunds auf color fest, wenn ein Teil des Textes als ausgewählt markiert ist.

Die Standardeinstellung ist dunkelblau: QColor(0, 0, 128).

Siehe auch selectionColor().

[pure virtual] void QSGTextNode::setSelectionTextColor(QColor selectionTextColor)

Legt die Farbe des Auswahltextes auf selectionTextColor fest, wenn ein Teil des Textes als ausgewählt markiert ist.

Der Standardwert ist weiß: QColor(255, 255, 255).

Siehe auch selectionTextColor().

[pure virtual] void QSGTextNode::setStyleColor(QColor styleColor)

Legt die Stilfarbe fest, die beim Rendern des Textes auf styleColor verwendet wird.

Die Standardeinstellung ist Schwarz: QColor(0, 0, 0).

Siehe auch styleColor() und setTextStyle().

[pure virtual] void QSGTextNode::setTextStyle(QSGTextNode::TextStyle textStyle)

Setzt den Stil des gerenderten Textes auf textStyle. Die Vorgabe ist Normal.

Siehe auch textStyle() und setStyleColor().

[pure virtual] void QSGTextNode::setViewport(const QRectF &viewport)

Legt das Begrenzungsrechteck des Ansichtsfensters, in dem der Text angezeigt wird, auf viewport fest. Die Bereitstellung dieser Informationen ermöglicht es QSGTextNode zu optimieren, welche Teile des Textlayouts oder des Dokuments in den Szenegraphen aufgenommen werden.

Die Voreinstellung ist ein standardmäßig konstruiertes QRectF. Für dieses Ansichtsfenster werden alle Inhalte in den Graphen aufgenommen.

Siehe auch viewport().

[pure virtual] QColor QSGTextNode::styleColor() const

Gibt die Farbe des Stils zurück, der beim Rendern des Textes verwendet wird.

Siehe auch setStyleColor() und textStyle().

[pure virtual] QSGTextNode::TextStyle QSGTextNode::textStyle()

Gibt den Stil des gerenderten Textes zurück.

Siehe auch setTextStyle() und styleColor().

[pure virtual] QRectF QSGTextNode::viewport() const

Gibt das aktuelle Ansichtsfenster für dieses QSGTextNode zurück.

Siehe auch setViewport().