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

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

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

 #include <QDomAttr>

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

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

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

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

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

• 66 открытых функций, унаследованных от QDomNode

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

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

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

 <link href="http://qt.nokia.com" color="red" />

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

 QDomElement e = //...
 //...
 QDomAttr a = e.attributeNode("href");
 cout << a.value() << endl;                // печатает "http://qt.nokia.com"
 a.setValue("http://qt.nokia.com/doc"); // изменяет атрибут узла
 QDomAttr a2 = e.attributeNode("href");
 cout << a2.value() << endl;               // печатает "http://qt.nokia.com/doc"

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

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

QString QDomAttr::value () const

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

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

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

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

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