Главная · Все классы · Основные классы · Классы по группам · Модули · Функции

Описание класса QDomAttr
[модуль QtXml]

Класс QDomAttr представляет один атрибут QDomElement. Далее...

 #include <QDomAttr>

Унаследован от QDomNode.

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

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


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

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

Например, следующий XML код описывает элемент без потомков, но с двумя атрибутами:

 <link href="http://www.trolltech.com" color="red" />

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

 QDomElement e = //...
 //...
 QDomAttr a = e.attributeNode("href");
 cout << a.value() << endl;                // выводит "http://www.trolltech.com"
 a.setValue("http://doc.trolltech.com"); // изменяет атрибут узла
 QDomAttr a2 = e.attributeNode("href");
 cout << a2.value() << endl;               // выводит "http://doc.trolltech.com"

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

QDomAttr может возвращать имя name() и значение value() атрибута. Изменить значение атрибута можно с помощью функции setValue(). Если функция specified() возвращает true, значение атрибута было ранее установлено в документе или же задано с помощью функции setValue() (т.е. точно определено тем или иным образом); в другом случае значение не было установлено. Узел, владеющий атрибутом, если таковой имеется, может быть получен с помощью ownerElement().

Для получения более подробной информации о Document Object Model смотрите http://www.w3.org/TR/REC-DOM-Level-1/ и http://www.w3.org/TR/DOM-Level-2-Core/. Для того, чтобы больше узнать о реализации DOM, смотрите документацию по QDomDocument.


Описание функций-членов

QDomAttr::QDomAttr ()

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

QDomAttr::QDomAttr ( const QDomAttr & x )

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

Данные в копиях общие (поверхностное копирование): изменение одного узла повлечет за собой изменение другого. Если вы хотите использовать глубокое копирование, воспользуйтесь 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, если атрибут имеет ранее установленное значение - в XML документе или с помощью setValue(). Возвращает false, если значение не было установлено.

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

QString QDomAttr::value () const

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

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

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

Ассоциирует x с данным DOM атрибутом.

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


Copyright © 2008 Trolltech Торговые марки
Qt 4.3.5