Класс QVirtualKeyboardTrace

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

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

Свойства

• 1 свойство унаследовано от QObject

Открытые функции

• 31 открытая функция унаследована от QObject

Сигналы

• 2 сигнала унаследованы от QObject

Статические открытые члены

• 9 статических открытых членов унаследованы от QObject

Дополнительные унаследованные члены

• 1 открытый слот унаследован от QObject
• 9 защищенных функций унаследованы от QObject

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

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

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");

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

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

Документация функций-членов

int QVirtualKeyboardTrace::addPoint(const QPointF &point)

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

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

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

Примечание: Эту функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.

QVariantList QVirtualKeyboardTrace::channelData(const QString &channel, int pos = 0, int count = -1) const

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

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

Примечание: Эту функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.

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

QVariantList QVirtualKeyboardTrace::points(int pos = 0, int count = -1) const

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

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

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

Примечание: Эту функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.

void QVirtualKeyboardTrace::setChannelData(const QString &channel, int index, const QVariant &data)

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

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

Примечание: Эту функцию можно вызывать через систему метаобъектов и из QML. См. Q_INVOKABLE.

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