QSGTextNode Class

メンバ関数のドキュメント

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

document の内容を、position にあるテキストノードに追加します。selectionStart が 0 以上の場合、これはselectionCount 文字分の選択範囲の最初の文字をマークします。選択範囲はselectionColor() による背景塗りつぶしとして表現され、選択されたテキストはselectionTextColor() で描画されます。

この関数は、その引数を仮想関数doAddTextDocument()に転送します。

clear()も参照してください 。

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

layout の内容を、position にあるテキストノードに追加します。selectionStart が 0 以上の場合、これはselectionCount 文字分の選択範囲の最初の文字としてマークされます。選択範囲はselectionColor() による背景塗りつぶしとして表現され、選択されたテキストはselectionTextColor() でレンダリングされます。

便宜上、lineStart およびlineCount を使用して、レイアウトから含めるQTextLine オブジェクトの範囲を選択できます。これは、例えば、省略レイアウトを作成する際に役立ちます。lineCount が< 0の場合、ノードにはlineStart からレイアウトの終わりまでの行が含まれます。

この関数は、その引数を仮想関数 `doAddTextLayout()` に転送します。

clear()も参照してください 。

[pure virtual] void QSGTextNode::clear()

ノードの内容を消去し、そのノードに追加されていたレイアウトやドキュメントを表すノードやその他のデータを削除します。

addTextLayout() およびaddTextDocument()も参照してください 。

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

テキストの描画に使用されるメインカラーを返します。

setColor()も参照してください 。

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

addTextDocument() によって呼び出される仮想関数。これは、document の内容をシーングラフノードに変換し、position にある現在のノードにそれらを追加します。

selectionStart が0以上の場合、これはselectionCount で指定された文字数の選択範囲の先頭文字を示します。選択範囲はselectionColor()による背景塗りつぶしとして表現され、選択されたテキストはselectionTextColor()で描画されます。

clear() およびaddTextDocument()も参照してください 。

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

addTextLayout() によって呼び出される仮想関数。これは、layout の内容をシーングラフノードに変換し、それらをposition の現在のノードに追加します。

selectionStart が0以上の場合、これはselectionCount の文字数に相当する選択領域の最初の文字を示します。選択範囲はselectionColor()による背景塗りつぶしとして表現され、選択されたテキストはselectionTextColor()でレンダリングされます。

便宜上、lineStart およびlineCount を使用して、レイアウトから含めるQTextLine オブジェクトの範囲を選択できます。これは、例えば、省略されたレイアウトを作成する際に役立ちます。lineCount が< 0の場合、ノードにはlineStart からレイアウトの終わりまでの行が含まれます。

clear() およびaddTextLayout()も参照してください 。

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

表示されているテキストに含まれる画像を拡大・縮小する際に使用されるサンプリングモードを返します。

setFiltering()も参照してください 。

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

テキスト内のハイパーリンクの色を返します。

setLinkColor()も参照してください 。

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

テキストのレンダリングに使用されるグリフノードの型を返します。

setRenderType()も参照してください 。

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

ノードのレンダリング品質を返します。詳細については、setRenderTypeQuality() を参照してください。

setRenderTypeQuality()も参照してください 。

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

テキストの任意の部分が選択状態になると、選択範囲の背景色を返します。

setSelectionColor()も参照してください 。

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

テキストの一部が選択状態になっている場合、その選択されたテキストの色を返します。

setSelectionTextColor()も参照してください 。

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

color にテキストを描画する際に使用するメインカラーを設定します。

デフォルトは黒です：QColor(0, 0, 0) 。

color()も参照してください 。

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

表示されているテキストに含まれる画像を拡大・縮小する際に使用するサンプリングモードを「filtering 」に設定します。画像を滑らかに拡大・縮小するには、ここで「QSGTexture::Linear 」を使用してください。

デフォルトは `QSGTexture::Nearest` です。

filtering()も参照してください 。

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

テキスト内のlinkColor へのハイパーリンクの色を設定します。

デフォルトは青色です：QColor(0, 0, 255) 。

linkColor()も参照してください 。

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

使用中のグリフノードのタイプを「renderType 」に設定します。

デフォルトは `QtRendering` です。

renderType()も参照してください 。

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

使用中のrenderType()がこれをサポートしている場合は、テキストのレンダリングに使用する品質を設定します。サポートされている場合、これを利用して、視覚的な忠実度と実行速度やメモリ使用量のバランスを調整することができます。

renderTypeQuality が< 0の場合、デフォルトの品質が使用されます。

renderTypeQuality には任意の整数を指定できますが、極端な値を設定すると、基盤となるグラフィックスハードウェアによる制限が生じる場合があります。Qt Quick の Text 要素では、以下の事前定義された値が使用されます：

この値は現在、QtRendering レンダリングタイプでのみ適用されます。この値を設定すると、グリフの表現に使用される距離フィールドの解像度が変更されます。標準値より高く設定すると、メモリ消費量は増加しますが、非常に大きなテキストにおけるフィルタリングによるアーティファクトが軽減されます。

デフォルト値は -1 です。

renderTypeQuality()も参照してください 。

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

テキストの任意の部分が選択状態になると、選択範囲の背景色をcolor に設定します。

デフォルトは濃い青（QColor(0, 0, 128) ）です。

selectionColor()も参照してください 。

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

テキストの一部が選択状態になると、選択テキストの色をselectionTextColor に設定します。

デフォルトは白です：QColor(255, 255, 255) 。

selectionTextColor()も参照してください 。

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

styleColor にテキストを描画する際に使用するスタイルの色を設定します。

デフォルトは黒です：QColor(0, 0, 0) 。

styleColor() およびsetTextStyle()も参照してください 。

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

レンダリングされるテキストのスタイルを `textStyle` に設定します。デフォルトは `Normal` です。

textStyle() およびsetStyleColor()も参照してください 。

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

テキストが表示されるビューポートのバウンディング矩形を `viewport` に設定します。この情報を指定することで、QSGTextNode は、テキストレイアウトやドキュメントのどの部分をシーングラフに含めるかを最適化できるようになります。

デフォルトは、デフォルトのコンストラクタで生成された `QRectF` です。このビューポートの場合、すべてのコンテンツがシーングラフに含まれます。

viewport()も参照してください 。

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

テキストの描画に使用されるスタイルの色を返します。

setStyleColor() およびtextStyle()も参照してください 。

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

レンダリングされたテキストのスタイルを返します。

setTextStyle() およびstyleColor()も参照してください 。

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

このQSGTextNode に対して現在設定されているビューポートを返します。

setViewport()も参照してください 。