Spec-Zone.ru › Qt 6.0

Класс QDomAttr

Класс QDomAttr представляет собой атрибут элемента QDomElement. Подробнее...

Заголовок: #include <QDomAttr>
CMake: find_package(Qt6 COMPONENTS Xml REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Xml)
qmake: QT += xml
Наследуется от: QDomNode
  • Список всех членов, включая унаследованные

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

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

QDomAttr(const QDomAttr &x)
QDomAttr()
QDomAttr & operator=(const QDomAttr &x)
QString name() const
QDomNode::NodeType nodeType() const
QDomElement ownerElement() const
void setValue(const QString &v)
bool specified() const
QString value() const

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

Например, следующий фрагмент XML создаёт элемент без дочерних элементов, но с двумя атрибутами:

<link href="http://qt-project.org" color="red" />

Вы можете получить доступ к атрибутам элемента с помощью такого кода:

QDomElement e;
//...
QDomAttr a = e.attributeNode("href");
cout << qPrintable(a.value()) << '\n';   // prints "http://qt-project.org"
a.setValue("http://qt-project.org/doc"); // change the node's attribute
QDomAttr a2 = e.attributeNode("href");
cout << qPrintable(a2.value()) << '\n';  // prints "http://qt-project.org/doc"

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

QDomAttr может возвращать имя() и значение() атрибута. Значение атрибута устанавливается с помощью setValue(). Если specified() возвращает true, значение было установлено с помощью setValue(). Узел, к которому прикреплён этот атрибут (если есть), возвращается методом ownerElement().

Дополнительную информацию об объектной модели документа см. на http://www.w3.org/TR/REC-DOM-Level-1/ и http://www.w3.org/TR/DOM-Level-2-Core/. Более общее введение в реализацию DOM см. в документации к QDomDocument.

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

QDomAttr::QDomAttr(const QDomAttr &x)

Создаёт копию x.

Данные копии разделяются (поверхностная копия): изменение одного узла также изменит другой. Если требуется глубокая копия, используйте cloneNode().

QDomAttr::QDomAttr()

Создаёт пустой атрибут.

QDomAttr &QDomAttr::operator=(const QDomAttr &x)

Присваивает x этому атрибуту DOM.

Данные копии разделяются (поверхностная копия): изменение одного узла также изменит другой. Если требуется глубокая копия, используйте cloneNode().

QString QDomAttr::name() const

Возвращает имя атрибута.

QDomNode::NodeType QDomAttr::nodeType() const

Возвращает AttributeNode.

QDomElement QDomAttr::ownerElement() const

Возвращает узел элемента, к которому прикреплён этот атрибут, или нулевой узел, если этот атрибут не прикреплён ни к одному элементу.

void QDomAttr::setValue(const QString &v)

Устанавливает значение атрибута в v.

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

bool QDomAttr::specified() const

Возвращает true если атрибут был задан пользователем с помощью setValue(). Возвращает false если значение не было задано или установлено.

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

QString QDomAttr::value() const

Возвращает значение атрибута или пустую строку, если атрибут не задан.

См. также specified() и setValue().

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.0/qdomattr.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API