QSGTextNode Class

Dokumentation der Member-Funktionen

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

Fügt den Inhalt von ` document ` zum Textknoten unter ` position` hinzu. Ist ` selectionStart ` >= 0, so markiert dies das erste Zeichen in einem ausgewählten Bereich mit der Anzahl an Zeichen ` selectionCount `. Die Auswahl wird als Hintergrundfüllung mit der Funktion ` selectionColor()` dargestellt, und der ausgewählte Text wird mit der Funktion ` selectionTextColor()` gerendert.

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

Siehe auch clear().

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 zum Textknoten unter position hinzu. Ist selectionStart >= 0, markiert dies das erste Zeichen in einem ausgewählten Bereich mit der Zeichenanzahl selectionCount. Die Auswahl wird als Hintergrundfüllung mit der Funktion selectionColor() dargestellt, und der ausgewählte Text wird mit der Funktion selectionTextColor() gerendert.

Der Einfachheit halber können „ lineStart “ und „ lineCount “ verwendet werden, um den Bereich der „ QTextLine “-Objekte auszuwählen, die aus dem Layout einbezogen werden sollen. Dies kann beispielsweise beim Erstellen von gekürzten Layouts nützlich sein. Ist „ lineCount “ < 0, dann umfasst der Knoten die Zeilen von „ lineStart “ bis zum Ende des Layouts.

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

Siehe auch clear().

[pure virtual] void QSGTextNode::clear()

Löscht den Inhalt des Knotens und entfernt dabei Knoten sowie andere Daten, die die ihm hinzugefügten Layouts und Dokumente darstellen.

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 private] void QSGTextNode::doAddTextDocument(QPointF position, QTextDocument *document, int selectionStart, int selectionCount)

Virtuelle Funktion, die von ` addTextDocument()` aufgerufen wird und den Inhalt von ` document ` in Szenengraph-Knoten umwandelt und diese dem aktuellen Knoten unter ` position` hinzufügt.

Ist selectionStart >= 0, so markiert dies das erste Zeichen in einem ausgewählten Bereich von selectionCount number of characters. Die Auswahl wird als Hintergrundfüllung mit der Funktion selectionColor() dargestellt, und der ausgewählte Text wird mit der Funktion selectionTextColor() gerendert.

Siehe auch „ clear()“ und „ addTextDocument()“.

[pure virtual private] void QSGTextNode::doAddTextLayout(QPointF position, QTextLayout *layout, int selectionStart, int selectionCount, int lineStart, int lineCount)

Virtuelle Funktion, die von ` addTextLayout()` aufgerufen wird und den Inhalt von ` layout ` in Szenengraph-Knoten umwandelt und diese dem aktuellen Knoten unter ` position` hinzufügt.

Ist selectionStart >= 0, so markiert dies das erste Zeichen in einem ausgewählten Bereich von selectionCount Anzahl von Zeichen. Die Auswahl wird als Hintergrundfüllung mit selectionColor() dargestellt, und der ausgewählte Text wird in selectionTextColor() gerendert.

Der Einfachheit halber können mit den Funktionen „ lineStart “ und „ lineCount “ der Bereich von „ QTextLine “-Objekten ausgewählt werden, der aus dem Layout einbezogen werden soll. Dies kann beispielsweise beim Erstellen von verkürzten Layouts nützlich sein. Ist „ lineCount “ < 0, umfasst der Knoten die Zeilen von „ lineStart “ bis zum Ende des Layouts.

Siehe auch clear() und addTextLayout().

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

Gibt den Skalierungsmodus zurück, der beim Skalieren von Bildern verwendet wird, die Teil des angezeigten Textes sind.

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. Weitere Informationen finden Sie unter setRenderTypeQuality().

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 ausgewählten Textes 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 werden soll.

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

Siehe auch color().

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

Legt den Skalierungsmodus fest, der beim Skalieren von Bildern verwendet wird, die Teil des angezeigten Textes sind, auf „ filtering “. Um Bilder stufenlos zu skalieren, verwenden Sie hier „ QSGTexture::Linear “.

Die Standardeinstellung ist „ QSGTexture::Nearest “.

Siehe auch „ filtering()“.

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

Legt die Farbe von Hyperlinks zu linkColor im Text fest.

Die Standardfarbe ist Blau: QColor(0, 0, 255).

Siehe auch linkColor().

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

Legt den Typ des verwendeten Glyphenknotens auf „ renderType “ fest.

Der Standardwert ist „ QtRendering “.

Siehe auch „ renderType()“.

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

Sofern der verwendete „ renderType()“ dies unterstützt, legen Sie die Qualität fest, die beim Rendern des Textes verwendet werden soll. Sofern dies unterstützt wird, kann damit ein Kompromiss zwischen visueller Wiedergabetreue und Ausführungsgeschwindigkeit oder Speicherbedarf eingegangen werden.

Ist der Wert „ renderTypeQuality “ kleiner als 0, wird die Standardqualität verwendet.

renderTypeQuality kann eine beliebige ganze Zahl sein, allerdings können bei extremen Werten Einschränkungen durch die zugrunde liegende Grafikhardware auftreten. Das Textelement „ Qt Quick “ arbeitet mit den folgenden vordefinierten Werten:

Dieser Wert wird derzeit nur vom Render-Typ „ QtRendering “ berücksichtigt. Durch die Einstellung wird die Auflösung der zur Darstellung der Glyphen verwendeten Entfernungsfelder geändert. Eine Einstellung über dem Normalwert führt zu einem höheren Speicherverbrauch, reduziert jedoch Filterartefakte bei sehr großem Text.

Der Standardwert ist -1.

Siehe auch „ renderTypeQuality()“.

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

Legt die Farbe des Auswahlhintergrunds auf color fest, sobald ein beliebiger Teil des Textes markiert ist.

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

Siehe auch selectionColor().

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

Legt die Farbe des ausgewählten Textes auf selectionTextColor fest, sobald ein beliebiger Teil des Textes als ausgewählt markiert ist.

Die Standardeinstellung 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 werden soll.

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

Siehe auch „ styleColor()“ und „ setTextStyle()“.

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

Legt den Stil des gerenderten Textes auf „ textStyle “ fest. Die Standardeinstellung ist „ Normal “.

Siehe auch „ textStyle()“ und „ setStyleColor()“.

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

Legt den Begrenzungsrahmen des Ansichtsfensters, in dem der Text angezeigt wird, auf ` viewport` fest. Durch die Angabe dieser Information kann der „ QSGTextNode “ optimieren, welche Teile des Textlayouts oder des Dokuments in den Szenengraphen aufgenommen werden.

Der Standardwert ist ein standardmäßig erstelltes ` QRectF`. Für diesen Ansichtsbereich werden alle Inhalte in den Graphen aufgenommen.

Siehe auch ` viewport()`.

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

Gibt die Stilfarbe zurück, die 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 den aktuell für dieses QSGTextNode festgelegten Ansichtsbereich zurück.

Siehe auch setViewport().