QSGTextNode Class

Documentation des fonctions membres

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

Ajoute le contenu de document au nœud de texte situé à l'adresse position. Si selectionStart est >= 0, cela marque le premier caractère d'une zone sélectionnée de selectionCount nombre de caractères. La sélection est représentée sous forme de remplissage d'arrière-plan à l'aide de la fonction selectionColor() et le texte sélectionné est affiché à l'aide de la fonction selectionTextColor().

Cette fonction transmet ses arguments à la fonction virtuelle doAddTextDocument().

Voir également clear().

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

Ajoute le contenu de layout au nœud de texte situé à l'adresse position. Si selectionStart est >= 0, cela marque le premier caractère d'une zone sélectionnée de selectionCount nombre de caractères. La sélection est représentée sous forme de remplissage d'arrière-plan à l'aide de la fonction selectionColor() et le texte sélectionné est affiché à l'aide de la fonction selectionTextColor().

Pour plus de commodité, les fonctions lineStart et lineCount peuvent être utilisées pour sélectionner la plage d’objets QTextLine à inclure dans la mise en page. Cela peut s’avérer utile, par exemple, lors de la création de mises en page elidées. Si lineCount est < 0, alors le nœud inclura les lignes comprises entre lineStart et la fin de la mise en page.

Cette fonction transmet ses arguments à la fonction virtuelle doAddTextLayout().

Voir également clear().

[pure virtual] void QSGTextNode::clear()

Efface le contenu du nœud, en supprimant les nœuds et autres données correspondant aux mises en page et aux documents qui y ont été ajoutés.

Voir également addTextLayout() et addTextDocument().

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

Renvoie la couleur principale utilisée lors du rendu du texte.

Voir aussi setColor().

[pure virtual private] void QSGTextNode::doAddTextDocument(QPointF position, QTextDocument *document, int selectionStart, int selectionCount)

Fonction virtuelle appelée par ` addTextDocument()`, qui convertit le contenu de ` document ` en nœuds du graphe de scène et les ajoute au nœud actuel à l'adresse ` position`.

Si selectionStart est >= 0, cela désigne le premier caractère d’une zone sélectionnée de selectionCount nombre de caractères. La sélection est représentée sous forme de remplissage d’arrière-plan avec la fonction selectionColor() et le texte sélectionné est affiché dans la fonction selectionTextColor().

Voir également clear() et addTextDocument().

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

Fonction virtuelle appelée par ` addTextLayout()`, qui convertit le contenu de ` layout ` en nœuds du graphe de scène et les ajoute au nœud actuel à l'adresse ` position`.

Si selectionStart est >= 0, cela marque alors le premier caractère d’une zone sélectionnée de selectionCount nombre de caractères. La sélection est représentée sous forme de remplissage d’arrière-plan avec la fonction selectionColor() et le texte sélectionné est affiché dans la fonction selectionTextColor().

Pour plus de commodité, les fonctions ` lineStart ` et ` lineCount ` peuvent être utilisées pour sélectionner la plage d'objets ` QTextLine ` à inclure dans la mise en page. Cela peut s'avérer utile, par exemple, lors de la création de mises en page elidées. Si ` lineCount ` est inférieur à 0, le nœud inclura alors les lignes comprises entre ` lineStart ` et la fin de la mise en page.

Voir également clear() et addTextLayout().

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

Renvoie le mode d'échantillonnage utilisé lors de la mise à l'échelle des images faisant partie du texte affiché.

Voir également setFiltering().

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

Renvoie la couleur des liens hypertextes dans le texte.

Voir aussi setLinkColor().

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

Renvoie le type de nœud de glyphe utilisé pour le rendu du texte.

Voir aussi setRenderType().

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

Renvoie la qualité du rendu du nœud. Voir setRenderTypeQuality() pour plus de détails.

Voir également setRenderTypeQuality().

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

Renvoie la couleur de l'arrière-plan de la sélection lorsqu'une partie quelconque du texte est marquée comme sélectionnée.

Voir aussi setSelectionColor().

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

Renvoie la couleur du texte sélectionné lorsqu'une partie quelconque de ce texte est marquée comme sélectionnée.

Voir aussi setSelectionTextColor().

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

Définit la couleur principale à utiliser lors du rendu du texte sur color.

La valeur par défaut est le noir : QColor(0, 0, 0).

Voir également color().

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

Définit le mode d'échantillonnage utilisé lors de la mise à l'échelle des images faisant partie du texte affiché sur filtering. Pour obtenir des images mises à l'échelle de manière fluide, utilisez ici QSGTexture::Linear.

La valeur par défaut est ` QSGTexture::Nearest`.

Voir également filtering().

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

Définit la couleur des liens hypertextes vers linkColor dans le texte.

La couleur par défaut est le bleu : QColor(0, 0, 255).

Voir aussi linkColor().

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

Définit le type de nœud de glyphe utilisé sur « renderType ».

La valeur par défaut est ` QtRendering`.

Voir également renderType().

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

Si l'renderType() utilisée le prend en charge, définissez la qualité à utiliser lors du rendu du texte. Lorsque cette fonctionnalité est prise en charge, elle permet de privilégier la vitesse d'exécution ou l'économie de mémoire au détriment de la fidélité visuelle.

Lorsque la valeur de l'renderTypeQuality est inférieure à 0, la qualité par défaut est utilisée.

renderTypeQuality peut être n'importe quel nombre entier, bien que des limitations imposées par le matériel graphique sous-jacent puissent se présenter si des valeurs extrêmes sont définies. L'élément Text de Qt Quick fonctionne avec les valeurs prédéfinies suivantes :

Cette valeur n'est actuellement prise en compte que par le type de rendu « QtRendering ». Sa configuration modifie la résolution des champs de distance utilisés pour représenter les glyphes. Une valeur supérieure à la normale entraîne une augmentation de la consommation de mémoire, mais réduit les artefacts de filtrage sur les textes très volumineux.

La valeur par défaut est -1.

Voir aussi renderTypeQuality().

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

Définit la couleur d'arrière-plan de la sélection sur color dès qu'une partie du texte est sélectionnée.

La valeur par défaut est le bleu foncé : QColor(0, 0, 128).

Voir également selectionColor().

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

Définit la couleur du texte sélectionné sur selectionTextColor dès qu'une partie quelconque du texte est marquée comme sélectionnée.

La valeur par défaut est le blanc : QColor(255, 255, 255).

Voir également selectionTextColor().

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

Définit la couleur de style à utiliser lors du rendu du texte vers styleColor.

La valeur par défaut est le noir : QColor(0, 0, 0).

Voir également styleColor() et setTextStyle().

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

Définit le style du texte affiché sur « textStyle ». La valeur par défaut est « Normal ».

Voir également textStyle() et setStyleColor().

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

Définit le rectangle englobant de la fenêtre d'affichage dans laquelle le texte est affiché à l'adresse viewport. La fourniture de cette information permet à l'QSGTextNode d'optimiser les parties de la mise en page du texte ou du document qui sont incluses dans le graphe de scène.

La valeur par défaut est un objet ` QRectF` construit par défaut. Pour cette fenêtre d’affichage, tout le contenu sera inclus dans le graphe.

Voir également viewport().

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

Renvoie la couleur de style utilisée lors du rendu du texte.

Voir également setStyleColor() et textStyle().

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

Renvoie le style du texte affiché.

Voir également setTextStyle() et styleColor().

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

Renvoie la fenêtre d'affichage actuellement définie pour cet objet ` QSGTextNode`.

Voir aussi setViewport().