Класс QDomImplementation

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

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

Примечание: Все функции в этом классе являются повторно входящими за исключением следующих:

• invalidDataPolicy()
• setInvalidDataPolicy(QDomImplementation::InvalidDataPolicy policy)

Типы public

Функции public

Статические члены public

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

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

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

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

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

Дополнительную информацию об объектной модели документов см. на уровне 1 и уровне 2 Core. Более общее введение в реализацию DOM см. в документации QDomDocument.

Классы QDom имеют несколько проблем несоответствия спецификациям XML, которые нельзя исправить в Qt 4 без нарушения обратной совместимости. Модуль XML-шаблонов Qt и классы QXmlStreamReader и QXmlStreamWriter обладают большей степенью соответствия.

См. также hasFeature().

Документация по типам членов

перечисление 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 указывает системный идентификатор внешнего подмножества. Если вы указываете пустую строку в качестве systemId, это означает, что тип документа не имеет системного идентификатора.

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

DOM-уровень 2 не поддерживает других функций объявления типов документов.

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

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

См. также createDocument().

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

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

В настоящее время поддерживаются следующие функции и их версии:

[static] QDomImplementation::InvalidDataPolicy QDomImplementation::invalidDataPolicy()

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

Предупреждение: Эта функция не является повторно входящей.

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

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

bool QDomImplementation::isNull()

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

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

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

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

QDomDocument doc;
QDomImplementation impl;

// This will create the element, but the resulting XML document will
// be invalid, because '~' is not a valid character in a tag name.
impl.setInvalidDataPolicy(QDomImplementation::AcceptInvalidData);
QDomElement elt1 = doc.createElement("foo~bar");

// This will create an element with the tag name "foobar".
impl.setInvalidDataPolicy(QDomImplementation::DropInvalidData);
QDomElement elt2 = doc.createElement("foo~bar");

// This will create a null element.
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 были созданы из разных QDomDocument; в противном случае возвращает false.

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

Присваивает x этому объекту реализации DOM.

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

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