Класс QXmlNodeModelIndex

Класс QXmlNodeModelIndex идентифицирует узел в модели узлов XML, унаследованной от QAbstractXmlNodeModel. Подробнее...

Этот класс был представлен в Qt 4.4.

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

Примечание: Все функции в этом классе являются реентерабельными.

Общедоступные типы

Общедоступные функции

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

QXmlNodeModelIndex — это индекс в модели узлов XML. Он содержит:

• Указатель на модель узлов XML, которая возвращается функцией model(), и
• Некоторые данные, которые возвращаются функциями data(), internalPointer() и additionalData().

Поскольку QXmlNodeModelIndex намеренно является простым классом, он не имеет функций-членов для доступа к свойствам узлов. Например, он не имеет функций для получения имени узла или его списка атрибутов или дочерних узлов. Если вам необходимо получить эту информацию из результатов запроса, есть два способа.

• Отправить вывод вашего XQuery в получатель XML, или
• Позвольте вашему XQuery выполнить всю работу по получению желаемого результата.

Второй случай поясняется на примере. Предположим, что вы хотите заполнить список виджетов значениями определенных атрибутов из набора элементов результатов. Вы можете написать XQuery, чтобы вернуть набор элементов, а затем написать код для итерации по результатам элементов, получения их атрибутов и извлечения необходимых строковых значений. Но более простой способ — просто дополнить ваш XQuery, чтобы найти нужные значения атрибутов. Затем вам нужно только оценить XQuery с помощью версии QXmlQuery::evaluateTo(), которая заполняет QStringList, которую вы можете напрямую отправить своему виджету.

QXmlNodeModelIndex не накладывает никаких ограничений на data значение, которое должен содержать QXmlNodeModelIndex. Значение данных зависит от связанной модели узлов. Поскольку QXmlNodeModelIndex зависит от определенного подкласса QAbstractXmlNodeModel для своего существования, единственный способ создать экземпляр QXmlNodeModelIndex — попросить модель узлов создать его для вас с помощью QAbstractXmlNodeModel::createIndex(). Поскольку эта функция защищена, обычно рекомендуется написать общедоступную функцию, которая создает QXmlNodeModelIndex из аргументов, подходящих для вашей конкретной модели узлов.

Индекс узла по умолчанию считается нулевым, т.е. isNull() возвращает true.

QXmlNodeModelIndex и QAbstractXmlNodeModel следуют той же схеме проектирования, что и QModelIndex и QAbstractItemModel.

Документация по типам членов

перечисление QXmlNodeModelIndex::DocumentOrder

Идентифицирует конкретный оператор сравнения узлов, который должен использоваться.

typedef QXmlNodeModelIndex::List

Тип-синоним для QList<QXmlNodeModelIndex>.

перечисление QXmlNodeModelIndex::NodeKind

Идентифицирует тип узла.

Обратите внимание, что необъявленная декларация XML в самом начале документа XML не является инструкцией обработки.

См. также QAbstractXmlNodeModel::kind().

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

QXmlNodeModelIndex::QXmlNodeModelIndex(const QXmlNodeModelIndex &other)

Стандартный конструктор копирования. Создаёт экземпляр QXmlNodeModelIndex, являющийся копией other.

QXmlNodeModelIndex::QXmlNodeModelIndex()

Конструктор по умолчанию. Создаёт элемент, являющийся null.

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

qint64 QXmlNodeModelIndex::additionalData() const

Возвращает второе значение данных. Индекс узла содержит два значения данных. data() возвращает первое.

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

qint64 QXmlNodeModelIndex::data() const

Возвращает первое значение данных. Индекс узла содержит два значения данных. additionalData() возвращает второе.

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

void *QXmlNodeModelIndex::internalPointer() const

Возвращает первое значение данных как указатель void*.

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

bool QXmlNodeModelIndex::isNull() const

Возвращает true, если этот QXmlNodeModelIndex — значение по умолчанию, в противном случае — false.

Нулевой QXmlNodeModelIndex не представляет какой-либо узел и не может использоваться совместно с QAbstractXmlNodeModel.

const QAbstractXmlNodeModel *QXmlNodeModelIndex::model() const

Возвращает QAbstractXmlNodeModel, к которому относится этот индекс узла. QXmlNodeModelIndex не владеет QAbstractXmlNodeModel и не отслеживает его срок жизни, поэтому этот указатель будет висячим, если QAbstractXmlNodeModel будет удалён первым.

Для модели узла нет метода-установщика, поскольку экземпляры QXmlNodeModelIndex создаются только с помощью QAbstractXmlNodeModel::createIndex().

bool QXmlNodeModelIndex::operator!=(const QXmlNodeModelIndex &other) const

Возвращает true, если other — тот же узел, что и этот.

bool QXmlNodeModelIndex::operator==(const QXmlNodeModelIndex &other) const

Возвращает true, если этот узел такой же, как other. Этот оператор не сравнивает значения, дочерние узлы или имена узлов. Он сравнивает идентичности узлов, то есть, являются ли два узла из одного документа и находятся ли они в точном том же месте.