Тип QML Trace

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

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

Свойства

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

Методы

• int addPoint(точка point)
• переменная channelData(строка channel, int pos, int count)
• переменная points(int pos, int count)
• void setChannelData(int index, строка channel, переменная data)

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

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, больше данных не принимается.

opacity : qreal

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

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

Это свойство полезно для того, чтобы старые следы становились более прозрачными по мере добавления новых.

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

traceId : int

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

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

int addPoint(точка point)

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

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

Примечание: Возвращаемый индекс необходим для привязки дополнительных данных к точке с помощью функции setChannelData().

переменная channelData(строка channel, int pos, int count)

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

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

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

переменная points(int pos, int count)

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

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

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

void setChannelData(int index, строка channel, переменная data)

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

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

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