QDomImplementation Class

Documentation des fonctions membres

QDomImplementation::QDomImplementation()

Crée un objet QDomImplementation.

QDomImplementation::QDomImplementation(const QDomImplementation &implementation)

Crée une copie de implementation.

[noexcept] QDomImplementation::~QDomImplementation()

Détruit l'objet et libère ses ressources.

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

Crée un document DOM de type doctype. Cette fonction ajoute également un nœud d'élément racine portant le nom qualifié qName et l'URI d'espace de noms nsURI.

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

Crée un nœud de type de document pour le nom « qName ».

publicId Spécifie l'identificateur public du sous-ensemble externe. Si vous spécifiez une chaîne vide (QString()) comme publicId, cela signifie que le type de document n'a pas d'identificateur public.

systemId Spécifie l’identifiant système du sous-ensemble externe. Si vous spécifiez une chaîne vide comme systemId, cela signifie que le type de document n’a pas d’identifiant système.

Comme il est impossible d’avoir un identifiant public sans identifiant système, l’identifiant public est défini sur une chaîne vide s’il n’y a pas d’identifiant système.

Le DOM niveau 2 ne prend en charge aucune autre fonctionnalité de déclaration de type de document.

La seule façon d’utiliser un type de document créé de cette manière est de le combiner avec la fonction ` createDocument()` pour créer un ` QDomDocument ` de ce type.

Dans la spécification DOM, c’est la seule façon de créer un document non nul. Pour des raisons historiques, Qt permet également de créer le document à l’aide du constructeur vide par défaut. Le document résultant est nul, mais devient non nul lorsqu’une fonction de fabrication, par exemple QDomDocument::createElement(), est appelée. Le document devient également non nul lorsque la méthode `setContent()` est appelée.

Voir également createDocument().

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

La fonction renvoie « true » si QDom implémente l'version demandée d'un feature; sinon, elle renvoie « false ».

Les fonctionnalités actuellement prises en charge et leurs versions :

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

Renvoie la politique relative aux données non valides, qui spécifie la marche à suivre lorsqu'une fonction de création de l'QDomDocument reçoit des données non valides.

Avertissement : cette fonction n'est pas réentrante.

Voir également setInvalidDataPolicy() et InvalidDataPolicy.

bool QDomImplementation::isNull()

Renvoie « false » si l'objet a été créé par « QDomDocument::implementation() » ; sinon, renvoie « true ».

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

Définit la politique relative aux données non valides, qui précise la marche à suivre lorsqu’une fonction de création de l’ QDomDocument reçoit des données non valides.

L’ policy est définie pour toutes les instances de QDomDocument qui existent déjà et qui seront créées à l’avenir.

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");
}

Avertissement : cette fonction n’est pas réentrante.

Voir également invalidDataPolicy() et InvalidDataPolicy.

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

Renvoie ` true ` si ` other ` et cet objet d'implémentation DOM ont été créés à partir de `QDomDocument` différents ; sinon, renvoie ` false`.

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

Attribue « other » à cette implémentation DOM.

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

Renvoie « true » si « other » et cet objet d'implémentation DOM ont été créés à partir de la même instance « QDomDocument » ; sinon, renvoie « false ».