Тип XmlRole QML

Для задания роли для XmlListModel. Подробнее...

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

Свойства

• isKey : bool
• name : строка
• query : строка

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

См. также Qt QML.

Документация по свойствам

isKey : bool

Определяет, является ли это ключевой ролью. Ключевые роли используются для определения, следует ли обновлять или добавлять набор значений в модель XML-списка, когда вызывается XmlListModel::reload().

См. также XmlListModel.

name : строка

Имя роли. Это имя используется для доступа к данным модели для этой роли.

Например, следующая модель имеет роль с именем "title", к которой можно получить доступ из делегата представления:

XmlListModel {
    id: xmlModel
    // ...
    XmlRole {
        name: "title"
        query: "title/string()"
    }
}

ListView {
    model: xmlModel
    delegate: Text { text: title }
}

query : строка

Запрос XPath-выражения относительно этой роли. Запрос должен быть относительным; он не может начинаться с '/'.

Например, если есть XML-документ такого вида:

<?xml version="1.0" encoding="iso-8859-1" ?>
<catalog>
    <book type="Online" wanted="true">
        <title>Qt 5 Cadaques</title>
        <year>2014</year>
        <author>Juergen Bocklage-Ryannel</author>
        <author>Johan Thelin</author>
    </book>
    <book type="Hardcover">
        <title>C++ GUI Programming with Qt 4</title>
        <year>2006</year>
        <author>Jasmin Blanchette</author>
        <author>Mark Summerfield</author>
    </book>
    <book type="Paperback">
        <title>Programming with Qt</title>
        <year>2002</year>
        <author>Matthias Kalle Dalheimer</author>
    </book>
 </catalog>

Вот некоторые допустимые XPath-выражения для запросов XmlRole в этом документе:

XmlListModel {
    id: model
    ...
    // XmlRole queries will be made on <book> elements
    query: "/catalog/book"

    // query the book title
    XmlRole { name: "title"; query: "title/string()" }

    // query the book's year
    XmlRole { name: "year"; query: "year/number()" }

    // query the book's type (the '@' indicates 'type' is an attribute, not an element)
    XmlRole { name: "type"; query: "@type/string()" }

    // query the book's first listed author (note in XPath the first index is 1, not 0)
    XmlRole { name: "first_author"; query: "author[1]/string()" }

    // query the wanted attribute as a boolean
    XmlRole { name: "wanted"; query: "boolean(@wanted)" }
}

Доступ к данным модели для вышеперечисленных ролей из делегата:

ListView {
    width: 300; height: 200
    model: model
    delegate: Column {
        Text { text: title + " (" + type + ")"; font.bold: wanted }
        Text { text: first_author }
        Text { text: year }
    }

Для получения дополнительной информации см. спецификацию W3C XPath 2.0.