Back to Qt.io
Contact Us Blog Download Qt

TraceCanvas QML Type

Ein spezialisierter Canvas-Typ zum Rendern von Trace-Objekten. Mehr...

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

Canvas

Eigenschaften

Signale

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

Methoden

Detaillierte Beschreibung

Dieser Typ bietet Funktionen für die Darstellung von Trace-Objekten auf dem Bildschirm.

Um das Trace-Rendering in der Tastatur verfügbar zu machen, muss dieser Typ als Komponente KeyboardStyle.traceCanvasDelegate deklariert werden.

traceCanvasDelegate: TraceCanvas {
}

Benutzerdefinierte Zeichenattribute können im Signal Canvas.available initialisiert werden. Ein Beispiel:

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
}

Der Typ bietet integrierte Optionen für das Trace-Rendering. Derzeit sind die folgenden Rendering-Optionen verfügbar:

  • renderSmoothedLine Rendering einer geglätteten Linie mit runden Ecken (Standard)

Die Rendering-Funktion kann mit der Eigenschaft renderFunction geändert werden.

renderFunction: renderSmoothedLine

Es werden auch benutzerdefinierte Rendering-Funktionen unterstützt. Betrachten Sie das folgende Beispiel:

renderFunction: renderCustomLine

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

    ...
}

Eigenschaft Dokumentation

autoDestroy : bool

Aktiviert den Modus der automatischen Zerstörung.

Wenn aktiviert, wird dieses Element zerstört, wenn das Objekt trace zerstört wird.

Der Standardwert ist false. In diesem Fall kann die Leinwand wiederverwendet werden, nachdem das Signal onRecycle ausgelöst wurde.


autoDestroyDelay : int

Gibt die ungefähre Verzögerung in Millisekunden an, die vom Beginn der automatischen Zerstörung an gerechnet wird, bevor das Objekt zerstört oder wiederverwendet werden soll.

Diese Verzögerung ermöglicht es z. B., das Objekt vor der Zerstörung zu animieren.

Der Standardwert ist 0.


renderFunction : var

Diese Eigenschaft definiert die Rendering-Funktion.

Der Standardwert ist renderSmoothedLine


trace : Trace

Ermöglicht den Zugriff auf das Objekt Trace.


Signal Dokumentation

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

Wird ausgegeben, wenn die traceCanvas wiederverwendet wird.

Hinweis: Der entsprechende Handler ist onOnRecycle.

Dieses Signal wurde in QtQuick.VirtualKeyboard.Styles 6.1 eingeführt.


Dokumentation der Methode

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

Recycelt Trace Canvas, indem es alle Zeichnungen löscht und die Variablen zurücksetzt.

Die Funktion löst nach Abschluss (vor der Rückkehr) das Signal onRecycle aus.

Die Funktion gibt true zurück, wenn das Recycling erfolgreich war.

Diese Methode wurde in QtQuick.VirtualKeyboard.Styles 6.1 eingeführt.


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

Löscht den Bildschirm und setzt das Rendering zurück.

Diese Methode wurde in QtQuick.VirtualKeyboard.Styles 6.1 eingeführt.


renderSmoothedLine()

Rendert eine geglättete Linie mit runden Ecken.

Diese Funktion ist inkrementell und rendert nur den neuen Teil, der dem Trace hinzugefügt wurde.

Diese Funktion verändert keine der Canvas-Attribute (d.h. sie können an anderer Stelle gesetzt werden.)


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.