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

Описание класса 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 смотрите Level 1 и 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]

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

Эта функция была введена в 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.