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

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

__NOTOC__

[править] Описание класса QDomImplementation
^{[модуль QtXml ]}

Класс QDomImplementation предоставляет информацию об особенностях DOM представления. Далее...

 #include <QDomImplementation>

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

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

[править] Открытые типы

• enum InvalidDataPolicy { AcceptInvalidChars, DropInvalidChars, ReturnNullNode }

[править] Открытые функции

• QDomImplementation ()
• QDomImplementation ( const QDomImplementation & x )
• ~QDomImplementation ()
• QDomDocument createDocument ( const QString & nsURI, const QString & qName, const QDomDocumentType & doctype )
• QDomDocumentType createDocumentType ( const QString & qName, const QString & publicId, const QString & systemId )
• bool hasFeature ( const QString & feature, const QString & version ) const
• bool isNull ()
• bool operator!= ( const QDomImplementation & x ) const
• QDomImplementation & operator= ( const QDomImplementation & x )
• bool operator== ( const QDomImplementation & x ) const

[править] Статические открытые члены

• InvalidDataPolicy invalidDataPolicy ()
• void setInvalidDataPolicy ( InvalidDataPolicy policy )

[править] Подробное описание

Класс QDomImplementation предоставляет информацию об особенностях DOM представления.

Данный класс описывает особенности, которые поддерживаются DOM представлением. В настоящее время XML подмножество DOM Level 1 и DOM Level 2 Core поддерживаются.

Как правило, вы будете пользоваться фукнцией QDomDocument::implementation() для получения объекта представления.

Вы можете создать новый тип документа с помощью createDocumentType() и новый документ посредством createDocument().

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

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

[править] Описание типов членов

[править]

enum QDomImplementation::InvalidDataPolicy

Данное перечисление определяет, что должно происходить, когда функция-фабрика в QDomDocument вызвана с некорректными данными.

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

[править] Описание функций-членов

[править]

QDomImplementation::QDomImplementation ()

Создает объект QDomImplementation.

[править]

QDomImplementation::QDomImplementation ( const QDomImplementation & x )

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

[править]

QDomImplementation::~QDomImplementation ()

Уничтожает объект и освобождает ресурсы.

[править]

QDomDocument QDomImplementation::createDocument ( const QString & nsURI, const QString & qName, const QDomDocumentType & doctype )

Создает DOM документ с типом документа doctype. Эта фукнция также добавляет корневой элемент с полным именем qName и URI пространства имен nsURI.

[править]

QDomDocumentType QDomImplementation::createDocumentType ( const QString & qName, const QString & publicId, const QString & systemId )

Создает узел типа документа с именем qName.

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

systemId определяет системный идентификатор внешнего подмножества. Если вы укажете пустую строку (QString()) в качестве systemId, это будет означать, что тип документа не будет иметь системного идентификатора.

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

DOM level 2 не поддерживает других особенностей типа документа.

Единственный путь использования типа документа состоит в создании с помощью фукнции createDocument() документа QDomDocument с определенным типом документа.

Спецификация DOM предусматривает только этот путь создания действительного документа. Из соображений будущего, Qt также позволяет создать документ, используя пустой конструктор по-умолчанию. Получившийся в результате документ не является действительным, но становится таковым, когда вызывается функция-фабрика, например, QDomDocument::createElement(). Документ также становится действительным, когда вызывается setContent().

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

[править]

bool QDomImplementation::hasFeature ( const QString & feature, const QString & version ) const

Функция возвращает true, если QDom представление требует version характеристики feature; в противном случае возвращает false.

Поддерживаемые на данный момент характеристики и их версии:

[править]

InvalidDataPolicy QDomImplementation::invalidDataPolicy () [static]

Returns the invalid data policy, which specifies what should be done when a factory function in QDomDocument is passed invalid data.

Эта фукнция была введене в Qt 4.1.

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

[править]

bool QDomImplementation::isNull ()

Возвращает false, если объект создан с помощью QDomDocument::implementation(); в противном случае возвращает true.

[править]

void QDomImplementation::setInvalidDataPolicy ( InvalidDataPolicy policy ) [static]

Устанавливает политику при некорректных данных, которая определяет, что должно происходить, когда в функцию-фабрику из QDomDocument переданы невалидные данные.

Политика policy устанавливается для всех представлений QDomDocument, которые уже существуют и которые будут созданы в будущем.

 QDomDocument doc;
 QDomImplementation impl;
 
 // Создается элемент, но результирующий XML документ будет
 // некорректным, так как '~' не является валидным символом имени тега.
 impl.setInvalidDataPolicy(QDomImplementation::AcceptInvalidData);
 QDomElement elt1 = doc.createElement("foo~bar");
 
 // Создается элемент с именем тега "foobar".
 impl.setInvalidDataPolicy(QDomImplementation::DropInvalidData);
 QDomElement elt2 = doc.createElement("foo~bar");
 
 // Создается нулевой элемент.
 impl.setInvalidDataPolicy(QDomImplementation::ReturnNullNode);
 QDomElement elt3 = doc.createElement("foo~bar");

Эта фукнция была введене в Qt 4.1.

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

[править]

bool QDomImplementation::operator!= ( const QDomImplementation & x ) const

Возвращает true, если x и объект текущего DOM представления были созданы из различных QDomDocuments; в противном случает возвращает false.

[править]

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

Прикрепляет x к данному DOM представлению.

[править]

bool QDomImplementation::operator== ( const QDomImplementation & x ) const

Возвращает true, если x и объект текущего DOM представления были созданы из одного QDomDocument; в противном случае возвращается false.