Тип QML XmlRole

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

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

Свойства

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

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

См. также Qt QML.

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

isKey : bool

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

См. также XmlListModel.

name : string

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

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

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

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

query : string

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

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

Вот некоторые допустимые 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.