Класс QXmlNodeModelIndex

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

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

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

Типы общедоступного использования

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

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

Класс QXmlNodeModelIndex идентифицирует узел в модели узлов XML, являющейся подклассом QAbstractXmlNodeModel.

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

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

Тип QXmlNodeModelIndex::Список

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

Перечисление QXmlNodeModelIndex::ТипУзла

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

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

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

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

QXmlNodeModelIndex::QXmlNodeModelIndex()

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

См. также являетсяПустым().

QXmlNodeModelIndex::QXmlNodeModelIndex(const QXmlNodeModelIndex &other)

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

qint64 QXmlNodeModelIndex::дополнительныеДанные() const

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

См. также данные().

qint64 QXmlNodeModelIndex::данные() const

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

См. также дополнительныеДанные().

void *QXmlNodeModelIndex::внутреннийУказатель() const

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

См. также дополнительныеДанные().

bool QXmlNodeModelIndex::являетсяПустым() const

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

Null 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. Этот оператор не сравнивает значения, дочерние элементы или имена узлов. Он сравнивает идентификаторы узлов, то есть проверяет, являются ли два узла из одного документа и находятся ли они в точно одном и том же месте.