Class: QgsProjectProperty¶
-
class
qgis.core.
QgsProjectProperty
¶ Bases:
sip.wrapper
An Abstract Base Class for QGIS project property hierarchys.
Each sub-class is either a QgsProjectPropertyKey or QgsProjectPropertyValue. QgsProjectPropertyKey can contain either QgsProjectPropertyKey or QgsProjectPropertyValues, thus describing an hierarchy. QgsProjectPropertyValues are always graph leaves.
Note
This class is used internally by QgsProject. It’s generally recommended that the methods in QgsProject are used to modify project properties rather than using these low-level classes.
New in version 3.0: Enums
Methods
Dumps out the keys and values
Returns
True
if the property is a QgsProjectPropertyKey.Returns
True
if property is a leaf node.Returns
True
if the property is a QgsProjectPropertyValue.Restores the property hierarchy from a specified DOM node.
Returns the node’s value.
Writes the property hierarchy to a specified DOM element.
Signals
Attributes
-
dump
(self, tabs: int = 0)¶ Dumps out the keys and values
- Parameters
tabs – is number of tabs to print; used for pretty-printing hierarchy
-
isKey
(self) → bool¶ Returns
True
if the property is a QgsProjectPropertyKey.See also
See also
-
isLeaf
(self) → bool¶ Returns
True
if property is a leaf node.A leaf node is a key node that has either no value or only a single value. A non-leaf node would be a key node with key sub-nodes.
This is used for entryList() and subkeyList() implementation.
-
isValue
(self) → bool¶ Returns
True
if the property is a QgsProjectPropertyValue.See also
See also
-
readXml
(self, keyNode: QDomNode) → bool¶ Restores the property hierarchy from a specified DOM node.
Used for restoring properties from project file
-
value
(self) → Any¶ Returns the node’s value.
For QgsProjectPropertyValue nodes, this is straightforward – just return the embedded QVariant, _value. For QgsProjectPropertyKey, this means returning the QgsProjectPropertyValue _value that is keyed by its name, if it exists; i.e., QgsProjectPropertyKey “foo” will return the property value mapped to its name, “foo”, in its QHash of QProperties.
-
writeXml
(self, nodeName: str, element: QDomElement, document: QDomDocument) → bool¶ Writes the property hierarchy to a specified DOM element.
Used for saving properties to project file.
- Parameters
nodeName – the tag name associated with this element
element – the parent (or encompassing) property element
document – the overall project file Dom document
-