Class: QgsXmlUtils

Assorted helper methods for reading and writing chunks of XML.

Static Methods

readBox3D	Decodes a DOM element to a 3D box.
readMapUnits	Decodes a distance unit from a DOM element.
readRectangle
readVariant	Read a QVariant from a QDomElement.
writeBox3D	Encodes a 3D box to a DOM element.
writeMapUnits	Encodes a distance unit to a DOM element.
writeRectangle	Encodes a rectangle to a DOM element.
writeVariant	Write a QVariant to a QDomElement.

class qgis.core.QgsXmlUtils

Bases: object

static readBox3D(element: QDomElement) → QgsBox3D

Decodes a DOM element to a 3D box.

Parameters:

element (QDomElement) – DOM document

Return type:

QgsBox3D

Returns:

decoded 3D box

Added in version 3.36.

static readMapUnits(element: QDomElement) → Qgis.DistanceUnit

Decodes a distance unit from a DOM element.

Parameters:

element (QDomElement) – DOM element to decode

Return type:

Qgis.DistanceUnit

Returns:

distance units

See also

writeMapUnits()

static readRectangle(element: QDomElement) → QgsRectangle

Parameters:

element (QDomElement)

Return type:

QgsRectangle

static readVariant(element: QDomElement) → Any

Read a QVariant from a QDomElement.

Parameters:

element (QDomElement)

Return type:

Any

static writeBox3D(box: QgsBox3D, doc: QDomDocument, elementName: str | None = '') → QDomElement

Encodes a 3D box to a DOM element.

Parameters:

• box (QgsBox3D) – 3D box to encode

• doc (QDomDocument) – DOM document

• elementName (Optional[str] = '') – name of the DOM element

Return type:

QDomElement

Returns:

element containing encoded 3D box

Added in version 3.36.

static writeMapUnits(units: Qgis.DistanceUnit, doc: QDomDocument) → QDomElement

Encodes a distance unit to a DOM element.

Parameters:

• units (Qgis.DistanceUnit) – units to encode

• doc (QDomDocument) – DOM document

Return type:

QDomElement

Returns:

element containing encoded units

See also

readMapUnits()

static writeRectangle(rect: QgsRectangle, doc: QDomDocument, elementName: str | None = '') → QDomElement

Encodes a rectangle to a DOM element.

Parameters:

• rect (QgsRectangle) – rectangle to encode

• doc (QDomDocument) – DOM document

• elementName (Optional[str] = '') – name of the DOM element

Return type:

QDomElement

Returns:

element containing encoded rectangle

static writeVariant(value: Any, doc: QDomDocument) → QDomElement

Write a QVariant to a QDomElement.

Supported types are

• QVariant.Map

• QVariant.Int

• QVariant.Double

• QVariant.String

• QgsProperty (since QGIS 3.4)

• QgsCoordinateReferenceSystem (since QGIS 3.4)

Parameters:

• value (Any)

• doc (QDomDocument)

Return type:

QDomElement