Back to Qt.io
Contact Us Blog Download Qt

TraceCanvas QML Type

Traceオブジェクトのレンダリングに特化したCanvasタイプ。詳細...

Import Statement: import QtQuick.VirtualKeyboard.Styles
Since: QtQuick.VirtualKeyboard 2.0
Inherits:

Canvas

プロパティ

シグナル

  • onRecycle(var traceCanvas) (since QtQuick.VirtualKeyboard.Styles 6.1)

メソッド

詳細説明

この型は、画面上にTraceオブジェクトをレンダリングする機能を提供する。

キーボードでTraceレンダリングを利用できるようにするには、この型をKeyboardStyle.traceCanvasDelegate コンポーネントとして宣言する必要があります。

traceCanvasDelegate: TraceCanvas {
}

カスタム描画属性は、Canvas.available シグナルで初期化できます。例えば

onAvailableChanged: {
    if (!available)
        return;
    var ctx = getContext("2d")
    ctx.lineWidth = 8 * scaleHint
    ctx.lineCap = "round"
    ctx.strokeStyle = Qt.rgba(0xFF, 0xFF, 0xFF)
    ctx.fillStyle = ctx.strokeStyle
}

この型は、Traceレンダリングの組み込みオプションを提供します。現在、以下のレンダリング・オプションが利用可能です：

  • renderSmoothedLine 角が丸い平滑化された線をレンダリングする（デフォルト）

レンダリング関数はrenderFunction プロパティで変更できます。

renderFunction: renderSmoothedLine

カスタムレンダリング関数もサポートされています。次の例を見てください：

renderFunction: renderCustomLine

function renderCustomLine() {
    getContext("2d")
    var points = trace.points()

    ...
}

プロパティの説明

autoDestroy : bool

自動破棄モードを有効にします。

有効にすると、trace オブジェクトが破棄されたときに、この項目も破棄される。

デフォルト値は false です。この場合、onRecycle シグナルがトリガーされた後、キャンバスを再利用することができます。


autoDestroyDelay : int

オブジェクトが破棄または再利用されるまでのおおよその遅延を、自動破棄の開始から数えてミリ秒単位で指定します。

この遅延によって、例えば、破壊前にアイテムをアニメーションさせることが可能になります。

デフォルト値は 0 です。


renderFunction : var

このプロパティは、レンダリング関数を定義します。

デフォルト値はrenderSmoothedLine


trace : Trace

Trace オブジェクトへのアクセスを提供します。


シグナル ドキュメント

[since QtQuick.VirtualKeyboard.Styles 6.1] onRecycle(var traceCanvas)

traceCanvas がリサイクルされたときに発せられる。

注意: 対応するハンドラはonOnRecycle です。

このシグナルは QtQuick.VirtualKeyboard.Styles 6.1 で導入されました。


メソッドの説明

[since QtQuick.VirtualKeyboard.Styles 6.1] recycle()

すべての描画をクリアし、変数をリセットすることで、トレースキャンバスをリサイクルします。

この関数は、完了後（リターン前）にonRecycle シグナルをトリガーします。

リサイクルに成功すると、この関数は true を返します。

このメソッドは QtQuick.VirtualKeyboard.Styles 6.1 で導入されました。


[since QtQuick.VirtualKeyboard.Styles 6.1] renderClear()

画面をクリアし、レンダリングをリセットします。

このメソッドは QtQuick.VirtualKeyboard.Styles 6.1 で導入されました。


renderSmoothedLine()

角が丸い滑らかな線をレンダリングします。

この関数はインクリメンタルで、トレースに追加された新しい部分だけをレンダリングします。

この関数はキャンバスの属性を変更しません。


©2024 The Qt Company Ltd. 本書に含まれるドキュメントの著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。