QDomImplementation Class

成员函数文档

QDomImplementation::QDomImplementation()

构造一个 QDomImplementation 对象。

QDomImplementation::QDomImplementation(const QDomImplementation &implementation)

构造implementation 的副本。

[noexcept] QDomImplementation::~QDomImplementation()

销毁对象并释放其资源。

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

创建文档类型为doctype 的 DOM 文档。该函数还添加了一个根元素节点，其限定名称为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 还允许使用默认的空构造函数创建文档。生成的文档为空，但在调用工厂函数（如QDomDocument::createElement() ）时会变成非空文档。调用 setContent() 时，文档也会变为非空。

另请参阅 createDocument()。

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

如果 QDom 实现了feature 请求的version ，则函数返回true ；否则返回false 。

当前支持的功能及其版本：

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

返回无效数据策略，该策略规定了当QDomDocument 中的工厂函数传入无效数据时应采取的措施。

警告：此函数不可重入。

另请参阅 setInvalidDataPolicy() 和InvalidDataPolicy 。

bool QDomImplementation::isNull()

如果对象是由QDomDocument::implementation() 创建的，则返回false ；否则返回true 。

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

设置无效数据策略，规定当QDomDocument 中的工厂函数传入无效数据时应如何处理。

policy 将针对QDomDocument 已经存在和将来创建的所有实例进行设置。

void XML_snippet_main()
{
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::AcceptInvalidChars);
QDomElement elt1 = doc.createElement("foo~bar");

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

// This will create a null element.
impl.setInvalidDataPolicy(QDomImplementation::ReturnNullNode);
QDomElement elt3 = doc.createElement("foo~bar");
}

警告：此函数不可重入。

另请参阅 invalidDataPolicy() 和InvalidDataPolicy 。

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

如果other 和此 DOM 实现对象是从不同的 QDomDocuments 创建的，则返回true ；否则返回false 。

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

为该 DOM 实现指定other 。

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

如果other 和此 DOM 实现对象是从同一个QDomDocument 创建的，则返回true ；否则返回false 。