QGIS API Documentation  3.9.0-Master (cebdc8dded)
Public Types | Public Member Functions | Static Public Member Functions | List of all members
QgsGui Class Reference

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

#include <qgsgui.h>

Inheritance diagram for QgsGui:
Inheritance graph
[legend]

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 ()
 
QgsGuioperator= (const QgsGui &other)=delete
 QgsGui cannot be copied. More...
 

Static Public Member Functions

static QgsDataItemGuiProviderRegistrydataItemGuiProviderRegistry ()
 Returns the global data item GUI provider registry, used for tracking providers which affect the browser GUI. More...
 
static QgsEditorWidgetRegistryeditorWidgetRegistry ()
 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 QgsGuiinstance ()
 Returns a pointer to the singleton instance. More...
 
static QgsLayerTreeEmbeddedWidgetRegistrylayerTreeEmbeddedWidgetRegistry ()
 Returns the global layer tree embedded widget registry, used for registering widgets that may be embedded into layer tree view. More...
 
static QgsLayoutItemGuiRegistrylayoutItemGuiRegistry ()
 Returns the global layout item GUI registry, used for registering the GUI behavior of layout items. More...
 
static QgsMapLayerActionRegistrymapLayerActionRegistry ()
 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 QgsProcessingGuiRegistryprocessingGuiRegistry ()
 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 QgsProjectStorageGuiRegistryprojectStorageGuiRegistry ()
 Returns the global GUI-related project storage registry. More...
 
static QgsProviderGuiRegistryproviderGuiRegistry ()
 Returns the registry of GUI-related components of data providers. More...
 
static void setWindowManager (QgsWindowManagerInterface *manager)
 Sets the global window manager. More...
 
static QgsShortcutsManagershortcutsManager ()
 Returns the global shortcuts manager, used for managing a QAction and QShortcut sequences. More...
 
static QgsSourceSelectProviderRegistrysourceSelectProviderRegistry ()
 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 47 of file qgsgui.h.

Member Enumeration Documentation

◆ 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 166 of file qgsgui.h.

◆ 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 56 of file qgsgui.h.

Constructor & Destructor Documentation

◆ QgsGui()

QgsGui::QgsGui ( const QgsGui other)
delete

QgsGui cannot be copied.

◆ ~QgsGui()

QgsGui::~QgsGui ( )

Definition at line 151 of file qgsgui.cpp.

Member Function Documentation

◆ dataItemGuiProviderRegistry()

QgsDataItemGuiProviderRegistry * QgsGui::dataItemGuiProviderRegistry ( )
static

Returns the global data item GUI provider registry, used for tracking providers which affect the browser GUI.

Since
QGIS 3.6

Definition at line 104 of file qgsgui.cpp.

◆ editorWidgetRegistry()

QgsEditorWidgetRegistry * QgsGui::editorWidgetRegistry ( )
static

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

Definition at line 64 of file qgsgui.cpp.

◆ enableAutoGeometryRestore()

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 119 of file qgsgui.cpp.

◆ higFlags()

QgsGui::HigFlags QgsGui::higFlags ( )
static

Returns the platform's HIG flags.

Since
QGIS 3.4

Definition at line 138 of file qgsgui.cpp.

◆ instance()

QgsGui * QgsGui::instance ( )
static

Returns a pointer to the singleton instance.

Definition at line 53 of file qgsgui.cpp.

◆ layerTreeEmbeddedWidgetRegistry()

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 79 of file qgsgui.cpp.

◆ layoutItemGuiRegistry()

QgsLayoutItemGuiRegistry * QgsGui::layoutItemGuiRegistry ( )
static

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

Definition at line 89 of file qgsgui.cpp.

◆ mapLayerActionRegistry()

QgsMapLayerActionRegistry * QgsGui::mapLayerActionRegistry ( )
static

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

Definition at line 84 of file qgsgui.cpp.

◆ nativePlatformInterface()

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 59 of file qgsgui.cpp.

◆ operator=()

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

QgsGui cannot be copied.

◆ processingGuiRegistry()

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 94 of file qgsgui.cpp.

◆ processingRecentAlgorithmLog()

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 99 of file qgsgui.cpp.

◆ projectStorageGuiRegistry()

QgsProjectStorageGuiRegistry * QgsGui::projectStorageGuiRegistry ( )
static

Returns the global GUI-related project storage registry.

Since
QGIS 3.10

Definition at line 109 of file qgsgui.cpp.

◆ providerGuiRegistry()

QgsProviderGuiRegistry * QgsGui::providerGuiRegistry ( )
static

Returns the registry of GUI-related components of data providers.

Since
QGIS 3.10

Definition at line 114 of file qgsgui.cpp.

◆ setWindowManager()

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 133 of file qgsgui.cpp.

◆ shortcutsManager()

QgsShortcutsManager * QgsGui::shortcutsManager ( )
static

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

Definition at line 74 of file qgsgui.cpp.

◆ sourceSelectProviderRegistry()

QgsSourceSelectProviderRegistry * QgsGui::sourceSelectProviderRegistry ( )
static

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

Definition at line 69 of file qgsgui.cpp.

◆ windowManager()

QgsWindowManagerInterface * QgsGui::windowManager ( )
static

Returns the global window manager, if set.

See also
setWindowManager()
Since
QGIS 3.4

Definition at line 128 of file qgsgui.cpp.


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