Class: QgsOptionsDialogBase

class qgis.gui.QgsOptionsDialogBase(settingsKey: str, parent: QWidget = None, fl: Union[Qt.WindowFlags, Qt.WindowType] = 0, settings: QgsSettings = None)

Bases: PyQt5.QtWidgets.QDialog

Constructor

Parameters
  • settingsKey (str) – QgsSettings subgroup key for saving/restore ui states, e.g. “ProjectProperties”.

  • parent (QWidget = None) – parent object (owner)

  • fl (Union[Qt.WindowFlags) – widget flags

  • settings (QgsSettings = None) – custom QgsSettings pointer

A base dialog for options and properties dialogs that offers vertical tabs. It handles saving/restoring of geometry, splitter and current tab states, switching vertical tabs between icon/text to icon-only modes (splitter collapsed to left), and connecting QDialogButtonBox’s accepted/rejected signals to dialog’s accept/reject slots

To use: 1) Start with copy of qgsoptionsdialog_template.ui and build options/properties dialog. 2) In source file for dialog, inherit this class instead of QDialog, then in constructor: … setupUi( this ); // set up .ui file objects initOptionsBase( False ); // set up this class to use .ui objects, optionally restoring base ui … restoreOptionsBaseUi(); // restore the base ui with initOptionsBase or use this later on

Methods

actionEvent

changeEvent

childEvent

closeEvent

connectNotify

contextMenuEvent

create

customEvent

destroy

disconnectNotify

dragEnterEvent

dragLeaveEvent

dragMoveEvent

dropEvent

enterEvent

event

eventFilter

focusInEvent

focusNextChild

focusNextPrevChild

focusOutEvent

focusPreviousChild

hideEvent

iconOnly

Determine if the options list is in icon only mode

initOptionsBase

Set up the base ui connections for vertical tabs.

initPainter

inputMethodEvent

isSignalConnected

keyPressEvent

keyReleaseEvent

leaveEvent

metric

mouseDoubleClickEvent

mouseMoveEvent

mousePressEvent

mouseReleaseEvent

moveEvent

nativeEvent

optionsStackedWidget_CurrentChanged

Select relevant tab on current page change

optionsStackedWidget_WidgetRemoved

Remove tab and unregister widgets on page remove

paintEvent

param e

receivers

registerTextSearchWidgets

register widgets in the dialog to search for text in it it is automatically called if a line edit has “mSearchLineEdit” as object name.

resizeAlltabs

Resizes all tabs when the dialog is resized

resizeEvent

restoreOptionsBaseUi

Restore the base ui.

searchText

searchText searches for a text in all the pages of the stacked widget and highlight the results

sender

senderSignalIndex

setSettings

param settings

sharedPainter

showEvent

param e

tabletEvent

timerEvent

updateMicroFocus

updateOptionsListVerticalTabs

Update tabs on the splitter move

updateWindowTitle

warnAboutMissingObjects

wheelEvent

actionEvent()
changeEvent()
childEvent()
closeEvent()
connectNotify()
contextMenuEvent()
create()
customEvent()
destroy()
disconnectNotify()
dragEnterEvent()
dragLeaveEvent()
dragMoveEvent()
dropEvent()
enterEvent()
event()
eventFilter()
focusInEvent()
focusNextChild()
focusNextPrevChild()
focusOutEvent()
focusPreviousChild()
hideEvent()
iconOnly(self) → bool

Determine if the options list is in icon only mode

Return type

bool

initOptionsBase(self, restoreUi: bool = True, title: str = '')

Set up the base ui connections for vertical tabs.

Parameters
  • restoreUi (bool = True) – Whether to restore the base ui at this time.

  • title (str = '') – the window title

initPainter()
inputMethodEvent()
isSignalConnected()
keyPressEvent()
keyReleaseEvent()
leaveEvent()
metric()
mouseDoubleClickEvent()
mouseMoveEvent()
mousePressEvent()
mouseReleaseEvent()
moveEvent()
nativeEvent()
optionsStackedWidget_CurrentChanged(self, index: int)

Select relevant tab on current page change

Parameters

index (int) –

optionsStackedWidget_WidgetRemoved(self, index: int)

Remove tab and unregister widgets on page remove

Parameters

index (int) –

paintEvent(self, e: QPaintEvent)
Parameters

e (QPaintEvent) –

receivers()
registerTextSearchWidgets(self)

register widgets in the dialog to search for text in it it is automatically called if a line edit has “mSearchLineEdit” as object name.

New in version 3.0.

resizeAlltabs(self, index: int)

Resizes all tabs when the dialog is resized

Parameters

index (int) – current tab index

New in version 3.10.

resizeEvent()
restoreOptionsBaseUi(self, title: str = '')

Restore the base ui. Sometimes useful to do at end of subclass’s constructor.

Parameters

title (str = '') – the window title (it does not need to be defined if previously given to initOptionsBase();

searchText(self, text: str)

searchText searches for a text in all the pages of the stacked widget and highlight the results

Parameters

text (str) – the text to search

New in version 3.0.

sender()
senderSignalIndex()
setSettings(self, settings: QgsSettings)
Parameters

settings (QgsSettings) –

sharedPainter()
showEvent(self, e: QShowEvent)
Parameters

e (QShowEvent) –

tabletEvent()
timerEvent()
updateMicroFocus()
updateOptionsListVerticalTabs(self)

Update tabs on the splitter move

updateWindowTitle(self)
warnAboutMissingObjects(self)
wheelEvent()