Класс QDomAttr

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

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

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

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

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

Например, следующий фрагмент 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().