Класс QDomImplementation

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

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

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

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

Типы

Открытые функции

Статические открытые члены

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

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

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

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

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

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

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

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

Перечисление QDomImplementation::InvalidDataPolicy

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

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

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

QDomImplementation::QDomImplementation(const QDomImplementation &x)

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

QDomImplementation::QDomImplementation()

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

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

Присваивает x этой реализации DOM.

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, но становится не null, когда вызывается функция-фабрика, например QDomDocument::createElement(). Документ также становится непустым, когда вызывается setContent().

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

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

Функция возвращает true если QDom реализует запрошенную version функции feature; в противном случае возвращает 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.

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

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