Class: QgsLayoutDesignerInterface

class qgis.gui.QgsLayoutDesignerInterface

Bases: PyQt5.QtCore.QObject

A common interface for layout designer dialogs and widgets.

Provides a common interface and stable API for layout designer dialogs and widgets. This interface can be used by plugins and scripts to interact with open layout designer dialogs.

Note

Layout designer dialogs are transitory. They are created only on demand (when a user opens the dialog) and are deleted as soon as the user closes the dialog. There can be multiple designer dialogs open at any one time, and each is a separate instance of the dialog and QgsLayoutDesignerInterface. Accordingly, plugins must take care to react to newly created designer dialogs and apply their customizations to all newly created dialogs. This can be done by listening for the QgisInterface.layoutDesignerOpened signal. Plugins must also listen for the QgisInterface.layoutDesignerWillBeClosed signal and gracefully cleanup any customizations before the designer dialog is deleted.

New in version 3.0.

QgsLayoutDesignerInterface(parent: QObject = None) Constructor for QgsLayoutDesignerInterface.

Methods

actionsToolbar

Returns a reference to the designer's "Actions" toolbar.

activateTool

Activates a standard layout designer tool.

addDockWidget

Adds a dock widget to the layout designer, in the specified dock area.

atlasMenu

Returns a reference to the designer's "Atlas" menu.

atlasPreviewEnabled

Returns whether the atlas preview mode is enabled in the designer.

atlasToolbar

Returns a reference to the designer's "Atlas" toolbar.

childEvent

close

Closes the layout designer.

connectNotify

customEvent

disconnectNotify

editMenu

Returns a reference to the designer's "Edit" menu.

isSignalConnected

itemsMenu

Returns a reference to the designer's "Items" menu.

lastExportResults

Returns the results of the last export operation performed in the designer.

layout

Returns the current layout displayed in the designer.

layoutMenu

Returns a reference to the designer's "Layout" menu.

layoutToolbar

Returns a reference to the designer's "Layout" toolbar.

masterLayout

Returns the master layout displayed in the designer.

messageBar

Returns the designer's message bar.

navigationToolbar

Returns a reference to the designer's "Navigation" toolbar.

receivers

removeDockWidget

Removes the specified dock widget from layout designer (without deleting it).

reportMenu

Returns a reference to the designer's "Report" menu.

selectItems

Selects the specified items.

sender

senderSignalIndex

setAtlasFeature

Sets the specified feature as the current atlas feature

setAtlasPreviewEnabled

Toggles whether the atlas preview mode should be enabled in the designer.

settingsMenu

Returns a reference to the designer's "Settings" menu.

showItemOptions

Shows the configuration widget for the specified layout item.

showRulers

Toggles whether or not the rulers should be visible in the designer.

timerEvent

view

Returns the layout view utilized by the designer.

viewMenu

Returns a reference to the designer's "View" menu.

window

Returns a pointer to the designer window.

Signals

layoutExported

pyqtSignal(*types, name: str = ..., revision: int = ..., arguments: Sequence = ...) -> PYQT_SIGNAL

mapPreviewRefreshed

pyqtSignal(*types, name: str = ..., revision: int = ..., arguments: Sequence = ...) -> PYQT_SIGNAL

Attributes

ToolMoveItemContent

ToolMoveItemNodes

class ExportResults

Bases: sip.wrapper

Encapsulates the results of an export operation performed in the designer.

New in version 3.20.

labelingResults
result
class StandardTool

Bases: int

ToolMoveItemContent = 0
ToolMoveItemNodes = 1
actionsToolbar(self) QToolBar

Returns a reference to the designer’s “Actions” toolbar.

Note

See class documentation for notes regarding handling customization of designer dialogs.

See also

layoutToolbar()

See also

atlasToolbar()

New in version 3.4.

Return type:

QToolBar

activateTool(self, tool: QgsLayoutDesignerInterface.StandardTool)

Activates a standard layout designer tool.

New in version 3.6.

Parameters:

tool (QgsLayoutDesignerInterface.StandardTool) –

addDockWidget(self, area: Qt.DockWidgetArea, dock: QDockWidget)

Adds a dock widget to the layout designer, in the specified dock area.

Note

See class documentation for notes regarding handling customization of designer dialogs.

New in version 3.4.

Parameters:
  • area (Qt.DockWidgetArea) –

  • dock (QDockWidget) –

atlasMenu(self) QMenu

Returns a reference to the designer’s “Atlas” menu.

Note that this may not exist or may be hidden if the designer is in report mode.

Note

See class documentation for notes regarding handling customization of designer dialogs.

See also

layoutMenu()

See also

editMenu()

See also

viewMenu()

See also

itemsMenu()

See also

reportMenu()

See also

settingsMenu()

New in version 3.4.

Return type:

QMenu

atlasPreviewEnabled(self) bool

Returns whether the atlas preview mode is enabled in the designer.

New in version 3.4.

Return type:

bool

atlasToolbar(self) QToolBar

Returns a reference to the designer’s “Atlas” toolbar.

Note that this toolbar may not exist or may be hidden if the designer is in report mode.

Note

See class documentation for notes regarding handling customization of designer dialogs.

See also

layoutToolbar()

See also

actionsToolbar()

New in version 3.4.

Return type:

QToolBar

childEvent(self, QChildEvent)
close(self)

Closes the layout designer.

connectNotify(self, QMetaMethod)
customEvent(self, QEvent)
disconnectNotify(self, QMetaMethod)
editMenu(self) QMenu

Returns a reference to the designer’s “Edit” menu.

Note

See class documentation for notes regarding handling customization of designer dialogs.

See also

layoutMenu()

See also

viewMenu()

See also

itemsMenu()

See also

atlasMenu()

See also

reportMenu()

See also

settingsMenu()

New in version 3.4.

Return type:

QMenu

isSignalConnected(self, QMetaMethod) bool
itemsMenu(self) QMenu

Returns a reference to the designer’s “Items” menu.

Note

See class documentation for notes regarding handling customization of designer dialogs.

See also

layoutMenu()

See also

editMenu()

See also

viewMenu()

See also

atlasMenu()

See also

reportMenu()

See also

settingsMenu()

New in version 3.4.

Return type:

QMenu

lastExportResults(self) QgsLayoutDesignerInterface.ExportResults

Returns the results of the last export operation performed in the designer.

May be None if no export has been performed in the designer.

New in version 3.20.

Return type:

QgsLayoutDesignerInterface.ExportResults

layout(self) QgsLayout

Returns the current layout displayed in the designer.

See also

view()

Return type:

QgsLayout

layoutExported

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

Parameters:
  • name (str = ...) –

  • revision (int = ...) –

  • arguments (Sequence = ...) –

Return type:

PYQT_SIGNAL

layoutMenu(self) QMenu

Returns a reference to the designer’s “Layout” menu.

Note

See class documentation for notes regarding handling customization of designer dialogs.

See also

editMenu()

See also

viewMenu()

See also

itemsMenu()

See also

atlasMenu()

See also

reportMenu()

See also

settingsMenu()

New in version 3.4.

Return type:

QMenu

layoutToolbar(self) QToolBar

Returns a reference to the designer’s “Layout” toolbar.

Note

See class documentation for notes regarding handling customization of designer dialogs.

See also

actionsToolbar()

See also

atlasToolbar()

New in version 3.4.

Return type:

QToolBar

mapPreviewRefreshed

pyqtSignal(*types, name: str = …, revision: int = …, arguments: Sequence = …) -> PYQT_SIGNAL

types is normally a sequence of individual types. Each type is either a type object or a string that is the name of a C++ type. Alternatively each type could itself be a sequence of types each describing a different overloaded signal. name is the optional C++ name of the signal. If it is not specified then the name of the class attribute that is bound to the signal is used. revision is the optional revision of the signal that is exported to QML. If it is not specified then 0 is used. arguments is the optional sequence of the names of the signal’s arguments.

Parameters:
  • name (str = ...) –

  • revision (int = ...) –

  • arguments (Sequence = ...) –

Return type:

PYQT_SIGNAL

masterLayout(self) QgsMasterLayoutInterface

Returns the master layout displayed in the designer.

See also

layout()

Return type:

QgsMasterLayoutInterface

messageBar(self) QgsMessageBar

Returns the designer’s message bar.

Return type:

QgsMessageBar

navigationToolbar(self) QToolBar

Returns a reference to the designer’s “Navigation” toolbar.

Note

See class documentation for notes regarding handling customization of designer dialogs.

See also

layoutToolbar()

See also

actionsToolbar()

See also

atlasToolbar()

New in version 3.4.

Return type:

QToolBar

receivers(self, PYQT_SIGNAL) int
removeDockWidget(self, dock: QDockWidget)

Removes the specified dock widget from layout designer (without deleting it).

Note

See class documentation for notes regarding handling customization of designer dialogs.

See also

addDockWidget()

New in version 3.4.

Parameters:

dock (QDockWidget) –

reportMenu(self) QMenu

Returns a reference to the designer’s “Report” menu.

Note that this may not exist or may be hidden if the designer is not in report mode.

Note

See class documentation for notes regarding handling customization of designer dialogs.

See also

layoutMenu()

See also

editMenu()

See also

viewMenu()

See also

itemsMenu()

See also

atlasMenu()

See also

settingsMenu()

New in version 3.4.

Return type:

QMenu

selectItems(self, items: Iterable[QgsLayoutItem])

Selects the specified items.

Parameters:

items (Iterable[QgsLayoutItem]) –

sender(self) QObject
senderSignalIndex(self) int
setAtlasFeature(self, feature: QgsFeature)

Sets the specified feature as the current atlas feature

Warning

it is the caller’s responsibility to ensure that feature is a feature from the layout’s current atlas coverage layer.

New in version 3.14.

Parameters:

feature (QgsFeature) –

setAtlasPreviewEnabled(self, enabled: bool)

Toggles whether the atlas preview mode should be enabled in the designer.

New in version 3.4.

Parameters:

enabled (bool) –

settingsMenu(self) QMenu

Returns a reference to the designer’s “Settings” menu.

Note

See class documentation for notes regarding handling customization of designer dialogs.

See also

layoutMenu()

See also

editMenu()

See also

viewMenu()

See also

itemsMenu()

See also

atlasMenu()

See also

reportMenu()

New in version 3.4.

Return type:

QMenu

showItemOptions(self, item: QgsLayoutItem, bringPanelToFront: bool = True)

Shows the configuration widget for the specified layout item.

If bringPanelToFront is True, then the item properties panel will be automatically shown and raised to the top of the interface.

New in version 3.4.

Parameters:
showRulers(self, visible: bool)

Toggles whether or not the rulers should be visible in the designer.

New in version 3.4.

Parameters:

visible (bool) –

timerEvent(self, QTimerEvent)
view(self) QgsLayoutView

Returns the layout view utilized by the designer.

See also

layout()

Return type:

QgsLayoutView

viewMenu(self) QMenu

Returns a reference to the designer’s “View” menu.

Note

See class documentation for notes regarding handling customization of designer dialogs.

See also

layoutMenu()

See also

editMenu()

See also

itemsMenu()

See also

atlasMenu()

See also

reportMenu()

See also

settingsMenu()

New in version 3.4.

Return type:

QMenu

window(self) QWidget

Returns a pointer to the designer window.

New in version 3.4.

Return type:

QWidget