Редактирование: Qt:Документация 4.3.2/qdomelement

{{Qt4.3.2_header}}

=Описание класса QDomElement<br /><sup><sup>[модуль [[Qt:Документация 4.3.2/qtxml | QtXml]] ] </sup></sup>=

Класс QDomElement представляет один элемент в DOM дереве. [[#details | Далее...]]
<source lang="cpp-qt"> #include <QDomElement></source> 
Наследует [[Qt:Документация 4.3.2/qdomnode | QDomNode]].

'''Примечание:''' Все функции в классе [[Qt:Документация 4.3.2/threads#reentrant | реентерабельны]].

*[[Qt:Документация 4.3.2/qdomelement-members | Список всех членов включая унаследованные]]
<div id="public-functions"></div>
===Открытые функции===

*'''[[Qt:Документация 4.3.2/qdomelement#QDomElement | QDomElement]]''' ()
*'''[[Qt:Документация 4.3.2/qdomelement#QDomElement-2 | QDomElement]]''' ( const QDomElement &amp; ''x'' )
*QString '''[[Qt:Документация 4.3.2/qdomelement#attributex | attribute]]''' ( const QString &amp; ''name'', const QString &amp; ''defValue'' = QString() ) const
*QString '''[[Qt:Документация 4.3.2/qdomelement#attributeNS | attributeNS]]''' ( const QString ''nsURI'', const QString &amp; ''localName'', const QString &amp; ''defValue'' = QString() ) const
*QDomAttr '''[[Qt:Документация 4.3.2/qdomelement#attributeNode | attributeNode]]''' ( const QString &amp; ''name'' )
*QDomAttr '''[[Qt:Документация 4.3.2/qdomelement#attributeNodeNS | attributeNodeNS]]''' ( const QString &amp; ''nsURI'', const QString &amp; ''localName'' )
*QDomNamedNodeMap '''[[Qt:Документация 4.3.2/qdomelement#attributes | attributes]]''' () const
*QDomNodeList '''[[Qt:Документация 4.3.2/qdomelement#elementsByTagName | elementsByTagName]]''' ( const QString &amp; ''tagname'' ) const
*QDomNodeList '''[[Qt:Документация 4.3.2/qdomelement#elementsByTagNameNS | elementsByTagNameNS]]''' ( const QString &amp; ''nsURI'', const QString &amp; ''localName'' ) const
*bool '''[[Qt:Документация 4.3.2/qdomelement#hasAttribute | hasAttribute]]''' ( const QString &amp; ''name'' ) const
*bool '''[[Qt:Документация 4.3.2/qdomelement#hasAttributeNS | hasAttributeNS]]''' ( const QString &amp; ''nsURI'', const QString &amp; ''localName'' ) const
*QDomNode::NodeType '''[[Qt:Документация 4.3.2/qdomelement#nodeType | nodeType]]''' () const
*void '''[[Qt:Документация 4.3.2/qdomelement#removeAttribute | removeAttribute]]''' ( const QString &amp; ''name'' )
*void '''[[Qt:Документация 4.3.2/qdomelement#removeAttributeNS | removeAttributeNS]]''' ( const QString &amp; ''nsURI'', const QString &amp; ''localName'' )
*QDomAttr '''[[Qt:Документация 4.3.2/qdomelement#removeAttributeNode | removeAttributeNode]]''' ( const QDomAttr &amp; ''oldAttr'' )
*void '''[[Qt:Документация 4.3.2/qdomelement#setAttribute | setAttribute]]''' ( const QString &amp; ''name'', const QString &amp; ''value'' )
*void '''[[Qt:Документация 4.3.2/qdomelement#setAttribute-2 | setAttribute]]''' ( const QString &amp; ''name'', int ''value'' )
*void '''[[Qt:Документация 4.3.2/qdomelement#setAttribute-3 | setAttribute]]''' ( const QString &amp; ''name'', uint ''value'' )
*void '''[[Qt:Документация 4.3.2/qdomelement#setAttribute-4 | setAttribute]]''' ( const QString &amp; ''name'', qlonglong ''value'' )
*void '''[[Qt:Документация 4.3.2/qdomelement#setAttribute-5 | setAttribute]]''' ( const QString &amp; ''name'', qulonglong ''value'' )
*void '''[[Qt:Документация 4.3.2/qdomelement#setAttribute-6 | setAttribute]]''' ( const QString &amp; ''name'', float ''value'' )
*void '''[[Qt:Документация 4.3.2/qdomelement#setAttribute-7 | setAttribute]]''' ( const QString &amp; ''name'', double ''value'' )
*void '''[[Qt:Документация 4.3.2/qdomelement#setAttributeNS | setAttributeNS]]''' ( const QString ''nsURI'', const QString &amp; ''qName'', const QString &amp; ''value'' )
*void '''[[Qt:Документация 4.3.2/qdomelement#setAttributeNS-2 | setAttributeNS]]''' ( const QString ''nsURI'', const QString &amp; ''qName'', int ''value'' )
*void '''[[Qt:Документация 4.3.2/qdomelement#setAttributeNS-3 | setAttributeNS]]''' ( const QString ''nsURI'', const QString &amp; ''qName'', uint ''value'' )
*void '''[[Qt:Документация 4.3.2/qdomelement#setAttributeNS-4 | setAttributeNS]]''' ( const QString ''nsURI'', const QString &amp; ''qName'', qlonglong ''value'' )
*void '''[[Qt:Документация 4.3.2/qdomelement#setAttributeNS-5 | setAttributeNS]]''' ( const QString ''nsURI'', const QString &amp; ''qName'', qulonglong ''value'' )
*void '''[[Qt:Документация 4.3.2/qdomelement#setAttributeNS-6 | setAttributeNS]]''' ( const QString ''nsURI'', const QString &amp; ''qName'', double ''value'' )
*QDomAttr '''[[Qt:Документация 4.3.2/qdomelement#setAttributeNode | setAttributeNode]]''' ( const QDomAttr &amp; ''newAttr'' )
*QDomAttr '''[[Qt:Документация 4.3.2/qdomelement#setAttributeNodeNS | setAttributeNodeNS]]''' ( const QDomAttr &amp; ''newAttr'' )
*void '''[[Qt:Документация 4.3.2/qdomelement#setTagName | setTagName]]''' ( const QString &amp; ''name'' )
*QString '''[[Qt:Документация 4.3.2/qdomelement#tagName | tagName]]''' () const
*QString '''[[Qt:Документация 4.3.2/qdomelement#text | text]]''' () const
*QDomElement &amp; '''[[Qt:Документация 4.3.2/qdomelement#operator-eq | operator=]]''' ( const QDomElement &amp; ''x'' )

*66 открытых функций унаследованных от [[Qt:Документация 4.3.2/qdomnode#public-functions | QDomNode]]
<div id="details"></div><hr />
==Подробное описание==

Класс QDomElement служит для представления одного элемента DOM дерева.

Элементы имеют имя тега [[Qt:Документация 4.3.2/qdomelement#tagName | tagName]]() и ноль или более атрибутов, связанных с ним. Имя тега может быть изменено посредством функции [[Qt:Документация 4.3.2/qdomelement#setTagName | setTagName]]().

Атрибуты элемента представляются в виде объектов [[Qt:Документация 4.3.2/qdomattr | QDomAttr]] и могут быть получены с помощью функций [[Qt:Документация 4.3.2/qdomelement#attributex | attribute]]() и [[Qt:Документация 4.3.2/qdomelement#attributeNode | attributeNode]](). Вы можете задать атрибуты функциями [[Qt:Документация 4.3.2/qdomelement#setAttribute | setAttribute]]() и [[Qt:Документация 4.3.2/qdomelement#setAttributeNode | setAttributeNode]](). Атрибуты могут быть удалены посредством [[Qt:Документация 4.3.2/qdomelement#removeAttribute | removeAttribute]](). Аналоги вышеназванных фукнций с учетом пространств имен: [[Qt:Документация 4.3.2/qdomelement#setAttributeNS | setAttributeNS]](), [[Qt:Документация 4.3.2/qdomelement#setAttributeNodeNS | setAttributeNodeNS]]() и [[Qt:Документация 4.3.2/qdomelement#removeAttributeNS | removeAttributeNS]]().

Если вы хотите получить доступ к тексту узла, воспользуйтесь [[Qt:Документация 4.3.2/qdomelement#text | text]](),т.е
<source lang="cpp-qt"> QDomElement e = //...
 //...
 QString s = e.text()</source> 
Фукнция [[Qt:Документация 4.3.2/qdomelement#text | text]]() работает рекурсивно, возвращая текст (поскольку не все элементы его содержат). Если вы хотите получить весь текст, содержащийся в детях, перебирайте их всех в поиске узлов [[Qt:Документация 4.3.2/qdomtext | QDomText]], т.е.
<source lang="cpp-qt"> QString text;
 QDomElement element = doc.documentElement();
 for(QDomNode n = element.firstChild(); !n.isNull(); n = n.nextSibling())
 {
     QDomText t = n.toText();
     if (!t.isNull())
         text += t.data();
 }</source> 
Помните, что мы пытаемся преобразовать каждый узел в текстовый, используя [[Qt:Документация 4.3.2/qdomelement#text | text]](), а не [[Qt:Документация 4.3.2/qdomnode#firstChild | firstChild]]().[[Qt:Документация 4.3.2/qdomnode#toText | toText]]().data() или n.[[Qt:Документация 4.3.2/qdomnode#toText | toText]]().data() непосредственно у узла, потому что он может оказаться не текстовым элементом.

Вы можете получить список всех потомков элемента, которые имеют определенное имя тега, с помощью  [[Qt:Документация 4.3.2/qdomelement#elementsByTagName | elementsByTagName]]() или [[Qt:Документация 4.3.2/qdomelement#elementsByTagNameNS | elementsByTagNameNS]]().

Для навигации по элементам dom документа используйте [[Qt:Документация 4.3.2/qdomnode#firstChildElement | firstChildElement]](), [[Qt:Документация 4.3.2/qdomnode#lastChildElement | lastChildElement]](), [[Qt:Документация 4.3.2/qdomnode#nextSiblingElement | nextSiblingElement]]() и [[Qt:Документация 4.3.2/qdomnode#previousSiblingElement | previousSiblingElement]](). Например, для итеративного просмотра всех потомков, имя которых "entry", у элемента с именем "database", вы можете использовать слещующий код:
<source lang="cpp-qt"> QDomDocument doc = // ...
 QDomElement root = doc.firstChildElement("database");
 QDomElement elt = root.firstChildElement("entry");
 for (; !elt.isNull(); elt = elt.nextSiblingElelement("entry")) {
     // ...
 }</source> 
Для получения дополнительной информации о Document Object Model смотрите [http://www.w3.org/TR/REC-DOM-Level-1/ Level 1] и [http://www.w3.org/TR/DOM-Level-2-Core/ Level 2 Core]. Если хотите узнать подробнее о представлении DOM документа, смотрите документацию [[Qt:Документация 4.3.2/qdomdocument | QDomDocument]].
<hr />
==Описание функций-членов==

===<div id="QDomElement"></div>QDomElement::QDomElement ()===

Создает пустой элемент. Используйте фукнцию [[Qt:Документация 4.3.2/qdomdocument#createElement | QDomDocument::createElement]](), если хотите создать элемент с содержимым.

===<div id="QDomElement-2"></div>QDomElement::QDomElement ( const QDomElement &amp; ''x'' )===

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

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

===<div id="attributex"></div>[[Qt:Документация 4.3.2/qstring | QString]] QDomElement::attribute ( const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''name'', const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''defValue'' = QString() ) const===

Возвращает атрибут с именем ''name''. Если такого атрибута не существует, возвращается ''defValue''.

Смотрите также [[Qt:Документация 4.3.2/qdomelement#setAttribute | setAttribute]](), [[Qt:Документация 4.3.2/qdomelement#attributeNode | attributeNode]](), [[Qt:Документация 4.3.2/qdomelement#setAttributeNode | setAttributeNode]]() и [[Qt:Документация 4.3.2/qdomelement#attributeNS | attributeNS]]().

===<div id="attributeNS"></div>[[Qt:Документация 4.3.2/qstring | QString]] QDomElement::attributeNS ( const [[Qt:Документация 4.3.2/qstring | QString]] ''nsURI'', const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''localName'', const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''defValue'' = QString() ) const===

Возвращает атрибут с локальным именем ''localName'' и URI пространства имен ''nsURI''. Если такого атрибута не существует, возвращается ''defValue''.

Смотрите также [[Qt:Документация 4.3.2/qdomelement#setAttributeNS | setAttributeNS]](), [[Qt:Документация 4.3.2/qdomelement#attributeNodeNS | attributeNodeNS]](), [[Qt:Документация 4.3.2/qdomelement#setAttributeNodeNS | setAttributeNodeNS]]() и [[Qt:Документация 4.3.2/qdomelement#attributex | attribute]]().

===<div id="attributeNode"></div>[[Qt:Документация 4.3.2/qdomattr | QDomAttr]] QDomElement::attributeNode ( const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''name'' )===

Возвращает объект [[Qt:Документация 4.3.2/qdomattr | QDomAttr]], который соответствует атрибуту с именем ''name''. Если такой атрибут не существует, возвращается [[Qt:Документация 4.3.2/qdomnode#isNull | нулевой атрибут]].

Смотрите также [[Qt:Документация 4.3.2/qdomelement#setAttributeNode | setAttributeNode]](), [[Qt:Документация 4.3.2/qdomelement#attributex | attribute]](), [[Qt:Документация 4.3.2/qdomelement#setAttribute | setAttribute]]() и [[Qt:Документация 4.3.2/qdomelement#attributeNodeNS | attributeNodeNS]]().

===<div id="attributeNodeNS"></div>[[Qt:Документация 4.3.2/qdomattr | QDomAttr]] QDomElement::attributeNodeNS ( const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''nsURI'', const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''localName'' )===

Возвращает объект [[Qt:Документация 4.3.2/qdomattr | QDomAttr]], который соответствует атрибуту с локальным именем ''localName'' и URI пространства имен ''nsURI''. Если такой атрибут не существует, возвращается [[Qt:Документация 4.3.2/qdomnode#isNull | нулевой атрибут]].

Смотрите также [[Qt:Документация 4.3.2/qdomelement#setAttributeNodeNS | setAttributeNodeNS]](), [[Qt:Документация 4.3.2/qdomelement#setAttributeNode | setAttributeNode]](), [[Qt:Документация 4.3.2/qdomelement#attributex | attribute]]() и [[Qt:Документация 4.3.2/qdomelement#setAttribute | setAttribute]]().

===<div id="attributes"></div>[[Qt:Документация 4.3.2/qdomnamednodemap | QDomNamedNodeMap]] QDomElement::attributes () const===

Возвращает [[Qt:Документация 4.3.2/qdomnamednodemap | QDomNamedNodeMap]], содержащий все атрибуты элемента.

Смотрите также [[Qt:Документация 4.3.2/qdomelement#attributex | attribute]](), [[Qt:Документация 4.3.2/qdomelement#setAttribute | setAttribute]](), [[Qt:Документация 4.3.2/qdomelement#attributeNode | attributeNode]]() и [[Qt:Документация 4.3.2/qdomelement#setAttributeNode | setAttributeNode]]().

===<div id="elementsByTagName"></div>[[Qt:Документация 4.3.2/qdomnodelist | QDomNodeList]] QDomElement::elementsByTagName ( const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''tagname'' ) const===

Возвращает [[Qt:Документация 4.3.2/qdomnodelist | QDomNodeList]], содержащий всех потомков данного элемента, имеющих имя ''tagname''. Порядок найденных узлов в списке определяется тем, как они встречались при просмотре поддерева данного элемента.

Смотрите также [[Qt:Документация 4.3.2/qdomelement#elementsByTagNameNS | elementsByTagNameNS]]() и [[Qt:Документация 4.3.2/qdomdocument#elementsByTagName | QDomDocument::elementsByTagName]]().

===<div id="elementsByTagNameNS"></div>[[Qt:Документация 4.3.2/qdomnodelist | QDomNodeList]] QDomElement::elementsByTagNameNS ( const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''nsURI'', const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''localName'' ) const===

Возвращает [[Qt:Документация 4.3.2/qdomnodelist | QDomNodeList]], содержащий всех потомков данного элемента, имеющих локальное имя ''localName'' и URI пространства имен ''nsURI''. Порядок найденных узлов в списке определяется тем, как они встречались при просмотре поддерева данного элемента.

Смотрите также [[Qt:Документация 4.3.2/qdomelement#elementsByTagName | elementsByTagName]]() и [[Qt:Документация 4.3.2/qdomdocument#elementsByTagNameNS | QDomDocument::elementsByTagNameNS]]().

===<div id="hasAttribute"></div>bool QDomElement::hasAttribute ( const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''name'' ) const===

Возвращает true, если данный элемент имеет атрибут с именем ''name''; в противном случае возвращает false.

'''Примечание:''' Функция не учитывает пространств имен. В результате указанное имя будет проверяться во всех атрибутах, имеющих всевозможные префиксы пространств имен.

Используйте [[Qt:Документация 4.3.2/qdomelement#hasAttributeNS | hasAttributeNS]]() для проверки атрибутов с учетом определенных пространств имен.

===<div id="hasAttributeNS"></div>bool QDomElement::hasAttributeNS ( const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''nsURI'', const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''localName'' ) const===

Возвращает true, если у данного элемента есть атрибут с локальным именем ''localName'' и URI пространства имен ''nsURI''; в противном случае возвращает false.

===<div id="nodeType"></div>[[Qt:Документация 4.3.2/qdomnode#NodeType-enum | QDomNode::NodeType]] QDomElement::nodeType () const===

Возвращает <tt>ElementNode</tt>.

===<div id="removeAttribute"></div>void QDomElement::removeAttribute ( const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''name'' )===

Удаляет атрибут с именем ''name'' из данного элемента.

Смотрите также [[Qt:Документация 4.3.2/qdomelement#setAttribute | setAttribute]](), [[Qt:Документация 4.3.2/qdomelement#attributex | attribute]]() и [[Qt:Документация 4.3.2/qdomelement#removeAttributeNS | removeAttributeNS]]().

===<div id="removeAttributeNS"></div>void QDomElement::removeAttributeNS ( const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''nsURI'', const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''localName'' )===

Удаляет атрибут с локальным именем ''localName'' и URI пространства имен ''nsURI'' из данного элемента.

Смотрите также [[Qt:Документация 4.3.2/qdomelement#setAttributeNS | setAttributeNS]](), [[Qt:Документация 4.3.2/qdomelement#attributeNS | attributeNS]]() и [[Qt:Документация 4.3.2/qdomelement#removeAttribute | removeAttribute]]().

===<div id="removeAttributeNode"></div>[[Qt:Документация 4.3.2/qdomattr | QDomAttr]] QDomElement::removeAttributeNode ( const [[Qt:Документация 4.3.2/qdomattr | QDomAttr]] &amp; ''oldAttr'' )===

Удаляет атрибут ''oldAttr'' из данного элемента и возвращает удаленный атрибут.

Смотрите также [[Qt:Документация 4.3.2/qdomelement#attributeNode | attributeNode]]() и [[Qt:Документация 4.3.2/qdomelement#setAttributeNode | setAttributeNode]]().

===<div id="setAttribute"></div>void QDomElement::setAttribute ( const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''name'', const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''value'' )===

Добавляет атрибут с именем ''name'' и значением ''value''. Если атрибут с таким именем уже существует, его значение заменяется на ''value''.

Смотрите также [[Qt:Документация 4.3.2/qdomelement#attributex | attribute]](), [[Qt:Документация 4.3.2/qdomelement#setAttributeNode | setAttributeNode]]() и [[Qt:Документация 4.3.2/qdomelement#setAttributeNS | setAttributeNS]]().

===<div id="setAttribute-2"></div>void QDomElement::setAttribute ( const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''name'', int ''value'' )===

Это перегруженная фукнция, созданная для удобства.

===<div id="setAttribute-3"></div>void QDomElement::setAttribute ( const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''name'', [[Qt:Документация 4.3.2/qtglobal#uint-typedef | uint]] ''value'' )===

Это перегруженная фукнция, созданная для удобства.

===<div id="setAttribute-4"></div>void QDomElement::setAttribute ( const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''name'', [[Qt:Документация 4.3.2/qtglobal#qlonglong-typedef | qlonglong]] ''value'' )===

Это перегруженная фукнция, созданная для удобства.

===<div id="setAttribute-5"></div>void QDomElement::setAttribute ( const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''name'', [[Qt:Документация 4.3.2/qtglobal#qulonglong-typedef | qulonglong]] ''value'' )===

Это перегруженная фукнция, созданная для удобства.

===<div id="setAttribute-6"></div>void QDomElement::setAttribute ( const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''name'', float ''value'' )===

Это перегруженная фукнция, созданная для удобства.

===<div id="setAttribute-7"></div>void QDomElement::setAttribute ( const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''name'', double ''value'' )===

Это перегруженная фукнция, созданная для удобства.

===<div id="setAttributeNS"></div>void QDomElement::setAttributeNS ( const [[Qt:Документация 4.3.2/qstring | QString]] ''nsURI'', const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''qName'', const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''value'' )===

Добавляет атрибут с полным именем ''qName'' и URI пространства имен ''nsURI'' со значением ''value''. Если атрибут с такими локальным именем и URI пространства имен уже существует, его префикс заменяется на ''qName'' и его значение изменяется на ''value''.

Хотя ''qName'' и является полным именем, локальное имя используется для того, чтобы определить, значение какого атрибута должно быть заменено.

Смотрите также [[Qt:Документация 4.3.2/qdomelement#attributeNS | attributeNS]](), [[Qt:Документация 4.3.2/qdomelement#setAttributeNodeNS | setAttributeNodeNS]]() и [[Qt:Документация 4.3.2/qdomelement#setAttribute | setAttribute]]().

===<div id="setAttributeNS-2"></div>void QDomElement::setAttributeNS ( const [[Qt:Документация 4.3.2/qstring | QString]] ''nsURI'', const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''qName'', int ''value'' )===

Это перегруженная фукнция, созданная для удобства.

===<div id="setAttributeNS-3"></div>void QDomElement::setAttributeNS ( const [[Qt:Документация 4.3.2/qstring | QString]] ''nsURI'', const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''qName'', [[Qt:Документация 4.3.2/qtglobal#uint-typedef | uint]] ''value'' )===

Это перегруженная фукнция, созданная для удобства.

===<div id="setAttributeNS-4"></div>void QDomElement::setAttributeNS ( const [[Qt:Документация 4.3.2/qstring | QString]] ''nsURI'', const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''qName'', [[Qt:Документация 4.3.2/qtglobal#qlonglong-typedef | qlonglong]] ''value'' )===

Это перегруженная фукнция, созданная для удобства.

===<div id="setAttributeNS-5"></div>void QDomElement::setAttributeNS ( const [[Qt:Документация 4.3.2/qstring | QString]] ''nsURI'', const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''qName'', [[Qt:Документация 4.3.2/qtglobal#qulonglong-typedef | qulonglong]] ''value'' )===

Это перегруженная фукнция, созданная для удобства.

===<div id="setAttributeNS-6"></div>void QDomElement::setAttributeNS ( const [[Qt:Документация 4.3.2/qstring | QString]] ''nsURI'', const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''qName'', double ''value'' )===

Это перегруженная фукнция, созданная для удобства.

===<div id="setAttributeNode"></div>[[Qt:Документация 4.3.2/qdomattr | QDomAttr]] QDomElement::setAttributeNode ( const [[Qt:Документация 4.3.2/qdomattr | QDomAttr]] &amp; ''newAttr'' )===

Добавляет атрибут ''newAttr'' к текущему элементу.

Если элемент уже имеет другой атрибут с тем же именем (''newAttr''), фукнция заменит имеющийся атрибут и вернет его; в противном случае функция вернет [[Qt:Документация 4.3.2/qdomnode#isNull | нулевой атрибут]].

Смотрите также [[Qt:Документация 4.3.2/qdomelement#attributeNode | attributeNode]](), [[Qt:Документация 4.3.2/qdomelement#setAttribute | setAttribute]]() и [[Qt:Документация 4.3.2/qdomelement#setAttributeNodeNS | setAttributeNodeNS]]().

===<div id="setAttributeNodeNS"></div>[[Qt:Документация 4.3.2/qdomattr | QDomAttr]] QDomElement::setAttributeNodeNS ( const [[Qt:Документация 4.3.2/qdomattr | QDomAttr]] &amp; ''newAttr'' )===

Добавляет атрибут ''newAttr'' к данному элементу.

Если элемент уже содержит другой атрибут с теми же локальным именем и URI пространства имен, как и ''newAttr'', фукнция замещает этот атрибут и возвращает его; в противном случае фукнция возвращает [[Qt:Документация 4.3.2/qdomnode#isNull | нулевой атрибут]].

Смотрите также [[Qt:Документация 4.3.2/qdomelement#attributeNodeNS | attributeNodeNS]](), [[Qt:Документация 4.3.2/qdomelement#setAttributeNS | setAttributeNS]]() и [[Qt:Документация 4.3.2/qdomelement#setAttributeNode | setAttributeNode]]().

===<div id="setTagName"></div>void QDomElement::setTagName ( const [[Qt:Документация 4.3.2/qstring | QString]] &amp; ''name'' )===

Устанавливает имя тега элемента в ''name''.

Смотрите также [[Qt:Документация 4.3.2/qdomelement#tagName | tagName]]().

===<div id="tagName"></div>[[Qt:Документация 4.3.2/qstring | QString]] QDomElement::tagName () const===

Возвращает имя тега данного элемента. Для следующего XML элемента:
<source lang="cpp-qt"> <img src="myimg.png"></source> 
функция вернет "img".

Смотрите также [[Qt:Документация 4.3.2/qdomelement#setTagName | setTagName]]().

===<div id="text"></div>[[Qt:Документация 4.3.2/qstring | QString]] QDomElement::text () const===

Возвращает тескт элемента или пустую строку.

Пример:
<source lang="cpp-qt"> <h1>Hello <b>Qt</b> <![CDATA[<xml is cool>]]></h1></source> 
Функция text() класса [[Qt:Документация 4.3.2/qdomelement | QDomElement]] для тега <tt><h1></tt> вернет следующий текст:
<source lang="cpp-qt"> Hello Qt &amp;lt;xml is cool&amp;gt;</source> 
В этой функции комментарии игнорируются. Она учитывает только [[Qt:Документация 4.3.2/qdomtext | QDomText]] и [[Qt:Документация 4.3.2/qdomcdatasection | QDomCDATASection]] объекты.

===<div id="operator-eq"></div>QDomElement &amp; QDomElement::operator= ( const QDomElement &amp; ''x'' )===

Прикрепляет ''x'' к данному DOM элементу.

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

{{Qt4.3.2_footer}}