Тип QML TraceCanvas

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

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

Свойства

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

Сигналы

• onRecycle(var)

Методы

• 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.

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