Class: QgsSettingsTreeNode¶
- class qgis.core.QgsSettingsTreeNode¶
Bases:
sip.wrapper
QgsSettingsTreeNode
is a tree node for the settings tree to help organizing and introspecting the tree. It is either a root node, a normal node or a named list (to store a group of settings under a dynamic named key). to automatically register a settings entry on its creation when a parent is provided.See also
See also
New in version 3.30:
Methods
Returns the existing child node if it exists at the given
key
Returns the existing child settings if it exists at the given
key
Returns the children nodes
Returns the children settings
Returns the complete key of the node (including its parents)
Creates a normal tree node It will return the existing child node if it exists at the given key
Creates a named list tree node.
Returns the key of the node (without its parents)
Returns the number of named nodes in the complete key
Returns the parent of the node or None if it does not exists
Registers a child setting
Returns the type of node
Unregisters the child tree
node
Unregisters the child setting
Attributes
- childNode(self, key: str) QgsSettingsTreeNode ¶
Returns the existing child node if it exists at the given
key
- Parameters:
key (str) –
- Return type:
- childSetting(self, key: str) QgsSettingsEntryBase ¶
Returns the existing child settings if it exists at the given
key
- Parameters:
key (str) –
- Return type:
- childrenNodes(self) List[QgsSettingsTreeNode] ¶
Returns the children nodes
- Return type:
List[QgsSettingsTreeNode]
- childrenSettings(self) List[QgsSettingsEntryBase] ¶
Returns the children settings
- Return type:
List[QgsSettingsEntryBase]
- completeKey(self) str ¶
Returns the complete key of the node (including its parents)
- Return type:
str
- createChildNode(self, key: str) QgsSettingsTreeNode ¶
Creates a normal tree node It will return the existing child node if it exists at the given key
- Raises:
QgsSettingsException – if a setting exists with the same key
- Parameters:
key (str) –
- Return type:
- createNamedListNode(self, key: str, options: Qgis.SettingsTreeNodeOptions | Qgis.SettingsTreeNodeOption = Qgis.SettingsTreeNodeOptions()) QgsSettingsTreeNamedListNode ¶
Creates a named list tree node. This is useful to register groups of settings for several named items (for instance credentials for several named services)
- Parameters:
key (str) –
options (Union[Qgis.SettingsTreeNodeOptions) –
- Return type:
- key(self) str ¶
Returns the key of the node (without its parents)
- Return type:
str
- namedNodesCount(self) int ¶
Returns the number of named nodes in the complete key
- Return type:
int
- parent(self) QgsSettingsTreeNode ¶
Returns the parent of the node or None if it does not exists
- Return type:
- registerChildSetting(self, setting: QgsSettingsEntryBase, key: str)¶
Registers a child setting
- Parameters:
setting (QgsSettingsEntryBase) – the setting to register
key (str) – the key of the setting (not the complete key from its parents)
Note
Ownership of the setting is transferred
Note
The registration is automatically done when calling the setting’s constructor with the parent argument signature
- Raises:
QgsSettingsException – if a setting exists with the same key
- staticMetaObject = <PyQt5.QtCore.QMetaObject object>¶
- type(self) Qgis.SettingsTreeNodeType ¶
Returns the type of node
- Return type:
- unregisterChildNode(self, node: QgsSettingsTreeNode)¶
Unregisters the child tree
node
- Parameters:
node (QgsSettingsTreeNode) –
- unregisterChildSetting(self, setting: QgsSettingsEntryBase, deleteSettingValues: bool = False, parentsNamedItems: Iterable[str] = [])¶
Unregisters the child setting
- Parameters:
setting (QgsSettingsEntryBase) – the setting to unregister
deleteSettingValues (bool = False) – if
True
, the values of the settings will also be deletedparentsNamedItems (Iterable[str] = []) – the list of named items in the parent named list (if any)