TraceCanvas QML Type
A specialized Canvas type for rendering Trace objects. More...
Import Statement: | import QtQuick.VirtualKeyboard.Styles 2.2 |
Since: | QtQuick.VirtualKeyboard 2.0 |
Inherits: |
Properties
- autoDestroy : bool
- autoDestroyDelay : int
- renderFunction : var
- trace : var
Methods
Detailed Description
This type provides capabilities for rendering Trace objects on the screen.
To make the Trace rendering available in the keyboard, this type must be declared as the KeyboardStyle.traceCanvasDelegate component.
traceCanvasDelegate: TraceCanvas { }
Custom drawing attributes can be initialized in the Canvas.available signal. For example:
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 }
The type offers built-in options for Trace rendering. Currently the following rendering options are available:
renderSmoothedLine
Renders smoothed line with round corners (the default)
The rendering function can be changed with the renderFunction property.
renderFunction: renderSmoothedLine
Custom rendering function is also supported. Consider the following example:
renderFunction: renderCustomLine function renderCustomLine() { getContext("2d") var points = trace.points() ... }
Property Documentation
autoDestroy : bool |
Enables auto destruction mode.
If enabled, this item will be destroyed when the trace
object is destroyed.
The default value is false.
autoDestroyDelay : int |
Specifies the approximate delay in milliseconds, counted from the beginning of the auto destruction, before the object is to be destroyed.
This delay makes it possible, for example, to animate the item before destruction.
The default value is 0.
renderFunction : var |
This property defines the rendering function.
The default value is renderSmoothedLine
Method Documentation
Renders smoothed line with round corners.
This function is incremental and renders only the new part added to the Trace.
This function does not alter any of the canvas attributes (i.e. they can be set elsewhere.)
© 2021 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.