- Qt 6.12
- Qt Virtual Keyboard
- QML Types
- QtQuick.VirtualKeyboard.Components
- TraceInputArea
- Qt Virtual Keyboard | Commercial or GPLv3

# TraceInputArea QML Type

A specialized MultiPointTouchArea for collecting touch input data. More...

Import Statement: | `import QtQuick.VirtualKeyboard.Components`
Since: | QtQuick.VirtualKeyboard 2.0
Inherits: | MultiPointTouchArea

- List of all members, including inherited members

## Properties

- boundingBox : rect
- canvasType : string
- horizontalRulers : var
- patternRecognitionMode : int
- verticalRulers : var

## Detailed Description

This type handles the trace interaction between the touch screen and the input engine.

The traces are rendered using the delegate from the traceCanvasDelegate property of the current KeyboardStyle.

## Property Documentation

### boundingBox : rect `[read-only]`

Bounding box for the trace input.

This property is readonly and is automatically updated based on the item size and margins.

### canvasType : string

Canvas type of this trace input area.

This property can be used to distinguish between different types of canvases. For example, in full screen handwriting mode this property is set to `"fullscreen"`, and in keyboard handwriting mode this property is set to `"keyboard"`.

### horizontalRulers : var

List of horizontal rulers in the input area.

The rulers are defined as a number of pixels from the top edge of the boundingBox.

Here is an example that demonstrates how to define rulers:

     horizontalRulers: [boundingBox.height / 3, boundingBox.height / 3 * 2]
     verticalRulers: [boundingBox.width / 3, boundingBox.width / 3 * 2]

### patternRecognitionMode : int

Pattern recognition mode of this input area.

The default value is InputEngine.PatternRecognitionMode.None.

### verticalRulers : var

List of vertical rulers in the input area.

The rulers are defined as a number of pixels from the left edge of the boundingBox.