QgsGui is a singleton class containing various registry and other global members related to GUI classes. More...

#include <qgsgui.h>

Inheritance diagram for QgsGui:

Public Types
enum	HigFlag { HigMenuTextIsTitleCase = 1 << 0, HigDialogTitleIsTitleCase = 1 << 1 }
	HIG flags, which indicate the Human Interface Guidelines for the current platform. More...

enum	ProjectCrsBehavior { UseCrsOfFirstLayerAdded = 1, UsePresetCrs = 2 }
	Defines the behavior to use when setting the CRS for a newly created project. More...

Public Member Functions
	QgsGui (const QgsGui &other)=delete
	QgsGui cannot be copied. More...

	~QgsGui ()

QgsGui &	operator= (const QgsGui &other)=delete
	QgsGui cannot be copied. More...

Static Public Member Functions
static QgsEditorWidgetRegistry *	editorWidgetRegistry ()
	Returns the global editor widget registry, used for managing all known edit widget factories. More...

static void	enableAutoGeometryRestore (QWidget *widget, const QString &key=QString())
	Register the widget to allow its position to be automatically saved and restored when open and closed. More...

static QgsGui::HigFlags	higFlags ()
	Returns the platform's HIG flags. More...

static QgsGui *	instance ()
	Returns a pointer to the singleton instance. More...

static QgsLayerTreeEmbeddedWidgetRegistry *	layerTreeEmbeddedWidgetRegistry ()
	Returns the global layer tree embedded widget registry, used for registering widgets that may be embedded into layer tree view. More...

static QgsLayoutItemGuiRegistry *	layoutItemGuiRegistry ()
	Returns the global layout item GUI registry, used for registering the GUI behavior of layout items. More...

static QgsMapLayerActionRegistry *	mapLayerActionRegistry ()
	Returns the global map layer action registry, used for registering map layer actions. More...

static QgsNative *	nativePlatformInterface ()
	Returns the global native interface, which offers abstraction to the host OS's underlying public interfaces. More...

static QgsProcessingGuiRegistry *	processingGuiRegistry ()
	Returns the global processing gui registry, used for registering the GUI behavior of processing algorithms. More...

static QgsProcessingRecentAlgorithmLog *	processingRecentAlgorithmLog ()
	Returns the global processing recent algorithm log, used for tracking recently used processing algorithms. More...

static void	setWindowManager (QgsWindowManagerInterface *manager)
	Sets the global window manager. More...

static QgsShortcutsManager *	shortcutsManager ()
	Returns the global shortcuts manager, used for managing a QAction and QShortcut sequences. More...

static QgsSourceSelectProviderRegistry *	sourceSelectProviderRegistry ()
	Returns the global source select provider registry, used for managing all known source select widget factories. More...

static QgsWindowManagerInterface *	windowManager ()
	Returns the global window manager, if set. More...

Detailed Description

QgsGui is a singleton class containing various registry and other global members related to GUI classes.

Since: QGIS 3.0

Definition at line 44 of file qgsgui.h.

Member Enumeration Documentation

enum QgsGui::HigFlag

HIG flags, which indicate the Human Interface Guidelines for the current platform.

Since: QGIS 3.4

Enumerator
HigMenuTextIsTitleCase	Menu action texts should be title case.
HigDialogTitleIsTitleCase	Dialog titles should be title case.

Definition at line 144 of file qgsgui.h.

enum QgsGui::ProjectCrsBehavior

Defines the behavior to use when setting the CRS for a newly created project.

Enumerator
UseCrsOfFirstLayerAdded	Set the project CRS to the CRS of the first layer added to a new project.
UsePresetCrs	Always set new projects to use a preset default CRS.

Definition at line 53 of file qgsgui.h.

Constructor & Destructor Documentation

QgsGui::QgsGui ( const QgsGui & other )

delete

QgsGui cannot be copied.

QgsGui::~QgsGui ( )

Definition at line 130 of file qgsgui.cpp.

Member Function Documentation

QgsEditorWidgetRegistry * QgsGui::editorWidgetRegistry ( )

static

Returns the global editor widget registry, used for managing all known edit widget factories.

Definition at line 58 of file qgsgui.cpp.

void QgsGui::enableAutoGeometryRestore	(	QWidget *	widget,
		const QString &	key = `QString()`
	)

static

Register the widget to allow its position to be automatically saved and restored when open and closed.

Use this to avoid needing to call saveGeometry() and restoreGeometry() on your widget.

Definition at line 98 of file qgsgui.cpp.

QgsGui::HigFlags QgsGui::higFlags ( )

static

Returns the platform's HIG flags.

Since: QGIS 3.4

Definition at line 117 of file qgsgui.cpp.

QgsGui * QgsGui::instance ( )

static

Returns a pointer to the singleton instance.

Definition at line 47 of file qgsgui.cpp.

QgsLayerTreeEmbeddedWidgetRegistry * QgsGui::layerTreeEmbeddedWidgetRegistry ( )

static

Returns the global layer tree embedded widget registry, used for registering widgets that may be embedded into layer tree view.

Definition at line 73 of file qgsgui.cpp.

QgsLayoutItemGuiRegistry * QgsGui::layoutItemGuiRegistry ( )

static

Returns the global layout item GUI registry, used for registering the GUI behavior of layout items.

Definition at line 83 of file qgsgui.cpp.

QgsMapLayerActionRegistry * QgsGui::mapLayerActionRegistry ( )

static

Returns the global map layer action registry, used for registering map layer actions.

Definition at line 78 of file qgsgui.cpp.

QgsNative * QgsGui::nativePlatformInterface ( )

static

Returns the global native interface, which offers abstraction to the host OS's underlying public interfaces.

Note: Not available in Python bindings

Definition at line 53 of file qgsgui.cpp.

QgsGui& QgsGui::operator= ( const QgsGui & other )

delete

QgsGui cannot be copied.

QgsProcessingGuiRegistry * QgsGui::processingGuiRegistry ( )

static

Returns the global processing gui registry, used for registering the GUI behavior of processing algorithms.

Since: QGIS 3.2

Definition at line 88 of file qgsgui.cpp.

QgsProcessingRecentAlgorithmLog * QgsGui::processingRecentAlgorithmLog ( )

static

Returns the global processing recent algorithm log, used for tracking recently used processing algorithms.

Since: QGIS 3.4

Definition at line 93 of file qgsgui.cpp.

void QgsGui::setWindowManager ( QgsWindowManagerInterface * manager )

static

Sets the global window manager.

Ownership is transferred to the QgsGui instance.

See also: windowManager()

Since: QGIS 3.4

Definition at line 112 of file qgsgui.cpp.

QgsShortcutsManager * QgsGui::shortcutsManager ( )

static

Returns the global shortcuts manager, used for managing a QAction and QShortcut sequences.

Definition at line 68 of file qgsgui.cpp.

QgsSourceSelectProviderRegistry * QgsGui::sourceSelectProviderRegistry ( )

static

Returns the global source select provider registry, used for managing all known source select widget factories.

Definition at line 63 of file qgsgui.cpp.

QgsWindowManagerInterface * QgsGui::windowManager ( )

static

Returns the global window manager, if set.

See also: setWindowManager()

Since: QGIS 3.4

Definition at line 107 of file qgsgui.cpp.

The documentation for this class was generated from the following files:

/build/qgis-3.4.15+24xenial/src/gui/qgsgui.h
/build/qgis-3.4.15+24xenial/src/gui/qgsgui.cpp

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation