Class: QgsLayerPropertiesDialog

class qgis.gui.QgsLayerPropertiesDialog

Bases: QgsOptionsDialogBase

Base class for “layer properties” dialogs, containing common utilities for handling functionality in these dialog.

Warning

This is exposed to SIP bindings for legacy reasons only, and is NOT to be considered as stable API.

Added in version 3.34.

QgsLayerPropertiesDialog(layer: QgsMapLayer, canvas: QgsMapCanvas, settingsKey: str, parent: QWidget = None, fl: Union[Qt.WindowFlags, Qt.WindowType] = Qt.WindowFlags(), settings: QgsSettings = None) Constructor for QgsLayerPropertiesDialog.

Parameters:

• layer – associated map layer

• canvas – associated map canvas

• settingsKey – QgsSettings subgroup key for saving/restore ui states, e.g. “VectorLayerProperties”.

• parent – parent object (owner)

• fl – widget flags

• settings –

  custom QgsSettings pointer

  Methods

  addPropertiesPageFactory	Adds properties page from a factory.
  loadDefaultMetadata	Reloads the default layer metadata for the layer.
  loadDefaultStyle	Reloads the default style for the layer.
  loadMetadataFromFile	Allows the user to load layer metadata from a file.
  loadStyle	Triggers a dialog to load a saved style
  loadStyleFromFile	Allows the user to load layer style from a file.
  saveDefaultStyle	Saves the default style when appropriate button is pressed
  saveMetadataAsDefault	Saves the current layer metadata as the default for the layer.
  saveMetadataToFile	Allows the user to save the layer's metadata as a file.
  saveStyleAs	Saves a style when appriate button is pressed
  saveStyleAsDefault	Saves the current layer style as the default for the layer.
  saveStyleToFile	Allows the user to save the layer's style to a file.
  setMetadataWidget	Sets the metadata widget and page associated with the dialog.

addPropertiesPageFactory(self, factory: QgsMapLayerConfigWidgetFactory)

Adds properties page from a factory.

Parameters:

factory (QgsMapLayerConfigWidgetFactory)

loadDefaultMetadata(self)

Reloads the default layer metadata for the layer.

See also

saveMetadataAsDefault()

loadDefaultStyle(self)

Reloads the default style for the layer.

loadMetadataFromFile(self)

Allows the user to load layer metadata from a file.

See also

saveMetadataToFile()

loadStyle(self)

Triggers a dialog to load a saved style

Added in version 3.30.

loadStyleFromFile(self)

Allows the user to load layer style from a file.

See also

saveStyleToFile()

saveDefaultStyle(self)

Saves the default style when appropriate button is pressed

Added in version 3.30.

saveMetadataAsDefault(self)

Saves the current layer metadata as the default for the layer.

loadDefaultMetadata()

saveMetadataToFile(self)

Allows the user to save the layer’s metadata as a file.

See also

loadMetadataFromFile()

saveStyleAs(self)

Saves a style when appriate button is pressed

Added in version 3.30.

saveStyleAsDefault(self)

Saves the current layer style as the default for the layer.

loadDefaultStyle()

saveStyleToFile(self)

Allows the user to save the layer’s style to a file.

See also

loadStyleFromFile()

setMetadataWidget(self, widget: QgsMetadataWidget, page: QWidget)

Sets the metadata widget and page associated with the dialog.

This must be called in order for the standard metadata loading/saving functionality to be available.

Parameters:

• widget (QgsMetadataWidget)

• page (QWidget)