Тип QML Trace

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

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

Свойства

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

Методы

• int addPoint(point)
• var channelData(channel, int pos, int count)
• var points(pos, int count)
• void setChannelData(index, string channel, var 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().

var channelData(channel, int pos, int count)

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

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

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

var points(pos, int count)

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

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

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

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

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

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

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