Тип TraceCanvas QML

Специализированный тип Canvas для отрисовки объектов Trace. Подробнее...

• Список всех членов, включая унаследованные

Свойства

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

Сигналы

• onRecycle(var traceCanvas)

Методы

• recycle()
• renderClear()
• renderSmoothedLine()

Подробное описание

Этот тип предоставляет возможности для отрисовки объектов 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()

Перерабатывает холст trace, очищая все рисунки и сбрасывая переменные.

Функция вызывает сигнал onRecycle после завершения (перед возвратом).

Функция возвращает true, если переработка выполнена успешно.

Этот метод был введен в QtQuick.VirtualKeyboard.Styles 6.1.

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

Очищает экран и сбрасывает отрисовку.

Этот метод был введен в QtQuick.VirtualKeyboard.Styles 6.1.

renderSmoothedLine()

Отрисовывает сглаженную линию с закругленными углами.

Эта функция инкрементная и отрисовывает только новую часть, добавленную в Trace.

Эта функция не изменяет атрибуты холста (их можно установить в другом месте).