TraceCanvas QML Type

Ein spezieller Canvas-Typ zur Darstellung von Trace-Objekten. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• autoDestroy : bool
• autoDestroyDelay : int
• renderFunction : var
• trace : Trace

Signale

• onRecycle(var traceCanvas) (since 6.1)

Methoden

• recycle() (since 6.1)
• renderClear() (since 6.1)
• renderSmoothedLine()

Ausführliche Beschreibung

Dieser Typ bietet Funktionen zum Darstellen von Trace-Objekten auf dem Bildschirm.

Damit die Trace-Darstellung in der Tastatur verfügbar ist, muss dieser Typ als „ KeyboardStyle.traceCanvasDelegate “-Komponente deklariert werden.

traceCanvasDelegate: TraceCanvas {
}

Benutzerdefinierte Zeichenattribute können im Signal „Canvas.available“ initialisiert werden. 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 die Darstellung von Trace-Objekten. Derzeit sind die folgenden Darstellungsoptionen verfügbar:

• renderSmoothedLine Zeichnet eine geglättete Linie mit abgerundeten Ecken (Standard)

Die Darstellungsfunktion kann mit der Eigenschaft „ renderFunction “ geändert werden.

renderFunction: renderSmoothedLine

Eine benutzerdefinierte Darstellungsfunktion wird ebenfalls unterstützt. Betrachten Sie das folgende Beispiel:

renderFunction: renderCustomLine

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

    ...
}

Dokumentation zu den Eigenschaften

autoDestroy : bool

Aktiviert den Modus zur automatischen Löschung.

Wenn diese Option aktiviert ist, wird dieses Element zerstört, sobald das Objekt „ trace “ zerstört wird.

Der Standardwert ist „false“. In diesem Fall kann die Leinwand nach dem Auslösen des Signals „ onRecycle “ wiederverwendet werden.

autoDestroyDelay : int

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

Diese Verzögerung ermöglicht es beispielsweise, das Element vor der Zerstörung zu animieren.

Der Standardwert ist 0.

renderFunction : var

Diese Eigenschaft definiert die Darstellungsfunktion.

Der Standardwert lautet renderSmoothedLine

trace : Trace

Bietet Zugriff auf das Objekt „ Trace “.

Signal-Dokumentation

[since 6.1] onRecycle(var traceCanvas)

Wird ausgegeben, wenn das „ traceCanvas “ wiederverwertet wird.

Dieses Signal wurde in Qt 6.1 eingeführt.

Methodendokumentation

[since 6.1] recycle()

Recycelt die Trace-Leinwand, indem alle Zeichnungen gelöscht und die Variablen zurückgesetzt werden.

Die Funktion löst nach Abschluss (vor dem „return“) das Signal „ onRecycle “ aus.

Die Funktion gibt „true“ zurück, wenn das Recyceln erfolgreich war.

Diese Methode wurde in Qt 6.1 eingeführt.

[since 6.1] renderClear()

Löscht den Bildschirm und setzt die Darstellung zurück.

Diese Methode wurde in Qt 6.1 eingeführt.

renderSmoothedLine()

Zeichnet eine geglättete Linie mit abgerundeten Ecken.

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

Diese Funktion verändert keine der Leinwandattribute (d. h., diese können an anderer Stelle festgelegt werden).