Тип QML Trace

Trace — это модель данных для данных ввода касания. Подробнее...

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

Свойства

• canceled : bool
• channels : список<строки>
• final : bool
• opacity : qreal
• traceId : int

Методы

• int addPoint(точка point)
• var channelData(строка channel, int pos, int count)
• var points(int pos, int count)
• void setChannelData(int index, строка channel, var data)
• void startHideTimer(int delayMs)

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

Trace предоставляет модель данных для координат и других необязательных данных, связанных с одним нажатием.

Типичный сценарий использования объекта trace:

• TraceInputArea или другое устройство ввода инициирует событие trace, вызывая метод InputEngine.traceBegin().
• Если текущий метод ввода принимает событие, он создаёт объект trace и настраивает необходимые каналы данных (если таковые имеются).
• TraceInputArea собирает данные для объекта trace.
• TraceInputArea вызывает метод InputEngine.traceEnd(), чтобы завершить trace и передать объект trace обратно методу ввода.
• Метод ввода обрабатывает данные и удаляет объект, когда он больше не нужен.

Данные координат извлекаются с помощью функции points().

В дополнение к данным на основе координат можно прикрепить произвольный канал данных к каждому элементу данных.

Каналы данных должны быть определены перед добавлением точек. Ниже перечислены каналы данных, поддерживаемые TraceInputArea:

• "t" Собирает время для каждого элемента данных. Время — это количество миллисекунд с 1970/01/01:

Например, чтобы настроить объект на сбор времени для каждой точки:

QVirtualKeyboardTrace *trace = new QVirtualKeyboardTrace(this);
trace->setChannels(QStringList() << "t");

Получить собранные данные можно, используя функцию channelData():

QVariantList timeData = trace->channelData("t");

Объекты Trace принадлежат своему создателю, который в нормальном случае является методом ввода. Это означает, что объекты создаются в методе InputMethod.traceBegin() (QML).

По определению, объект trace может быть уничтожен не ранее, чем в методе InputMethod.traceEnd() (QML).

Документация по свойствам

canceled : bool

Это свойство определяет, отменён ли Trace. Данные ввода не должны обрабатываться из Trace, для которых свойство canceled установлено в значение true.

channels : список<строки>

Список дополнительных каналов данных в Trace. Это свойство должно быть инициализировано перед добавлением данных.

final : bool

Это свойство определяет, может ли Trace принять больше данных. Если значение равно true, больше данных не принимаются.

[с QtQuick.VirtualKeyboard 2.4] opacity : qreal

Это свойство определяет, насколько непрозрачен Trace.

Меньшее значение приводит к более прозрачному trace: 0.0 полностью прозрачен, а 1.0 полностью непрозрачен.

Это свойство полезно для повышения прозрачности старых trace при добавлении новых.

Это свойство было добавлено в QtQuick.VirtualKeyboard 2.4.

traceId : int

Уникальный идентификатор этого Trace.

Документация по методам

int addPoint(точка point)

Добавляет point в Trace.

Метод возвращает индекс добавленной точки или -1, если точки нельзя добавить (т.е. final равно true).

var channelData(строка channel, int pos, int count)

Возвращает данные из указанного channel. Если другие параметры не заданы, функция возвращает все данные.

Если параметр pos задан, функция возвращает данные, начиная с позиции. Параметр count ограничивает количество возвращаемых элементов.

См. также setChannelData().

var points(int pos, int count)

Возвращает список точек. Если параметры не заданы, функция возвращает все точки.

Если параметр pos задан, функция возвращает точки, начиная с позиции. Параметр count ограничивает количество возвращаемых точек.

Возвращаемый список содержит point типы.

void setChannelData(int index, строка channel, var data)

Устанавливает data для точки с индексом index в заданном канале channel.

Если этот метод не вызывается для каждой точки данных, данные канала будут заполнены пустыми значениями. Однако данные нельзя добавить на произвольный индекс, т. е. они должны быть добавлены синхронно с данными точки.

См. также channelData().

[since QtQuick.VirtualKeyboard.Styles 6.1] void startHideTimer(int delayMs)

Запускает таймер, чтобы установить непрозрачность в ноль после delayMs. Если он вызван снова в течение delayMs, таймер перезапускается.

С помощью этой функции метод ввода может скрыть trace с экрана до уничтожения объекта trace, например, чтобы указать, что trace обработано.

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