Материал из Wiki.crossplatform.ru

Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

[править] Описание класса 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 class представляет атрибут 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 может возвращать имя и значение атрибута. Изменить значение атрибута можно с помощью функции setValue(). Если функция specified() возвращает истину, значение атрибута было ранее установлено в документе или же с помощью функции 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

Возвращает тип узла.

[править]

QDomElement QDomAttr::ownerElement () const

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

[править]

void QDomAttr::setValue ( const QString & v )

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

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

[править]

bool QDomAttr::specified () const

Возвращает истину, если атрибут имеет ранее установленное значение - в XML документе или с помощью setValue(). Возвращает ложь, если значение не было установлено.

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

[править]

QString QDomAttr::value () const

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

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

[править]

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

Прикрепляет x к текущему DOM атрибуту.

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