Class: QgsPanelWidget¶
-
class
qgis.gui.
QgsPanelWidget
(parent: QWidget = None)¶ Bases:
PyQt5.QtWidgets.QWidget
Base class for any widget that can be shown as a inline panel
- Parameters
parent (QWidget = None) – Parent widget.
Base class for any widget that can be shown as a inline panel
Methods
Accept the panel.
The the auto delete property on the widget.
Connect the given sub panel widgets showPanel signals to this current panels main showPanel event to bubble up to the user.
Connect the given sub panel widgets showPanel signals to this current panels main showPanel event to bubble up to the user.
Returns the dock mode state.
Traces through the parents of a widget to find if it is contained within a QgsPanelWidget widget.
Overridden key press event to handle the esc event on the widget.
Returns the menu to use for the menu button for this panel, or
None
if no menu button is required.Returns the (translated) tooltip text to use for the menu button for this panel.
Open a panel or dialog depending on dock mode setting If dock mode is
True
this method will emit the showPanel signal for connected slots to handle the open event.The title of the panel.
The the auto delete property on the widget.
Set the widget in dock mode which tells the widget to emit panel widgets and not open dialogs
Set the title of the panel when shown in the interface.
Signals
Emitted when the panel is accepted by the user.
Emit when you require a panel to be show in the interface.
Emitted when the widget state changes.
-
acceptPanel
(self)¶ Accept the panel. Causes panelAccepted to be emitted. Widgets are normally removed form the interface using the panel manager or the caller.
-
actionEvent
(self, QActionEvent)¶
-
autoDelete
(self) → bool¶ The the auto delete property on the widget.
True
by default. When auto delete is enabled when a panel is removed from the stack it will be deleted.- Return type
bool
- Returns
The auto delete value for the widget.
-
changeEvent
(self, QEvent)¶
-
childEvent
(self, QChildEvent)¶
-
closeEvent
(self, QCloseEvent)¶
-
connectChildPanel
(self, panel: QgsPanelWidget)¶ Connect the given sub panel widgets showPanel signals to this current panels main showPanel event to bubble up to the user.
Use this method if you have children widgets that need to show a panel to the user.
- Parameters
panel (QgsPanelWidget) – The panel to connect.
-
connectChildPanels
(self, panels: Iterable[QgsPanelWidget])¶ Connect the given sub panel widgets showPanel signals to this current panels main showPanel event to bubble up to the user.
Use this method if you have children widgets that need to show a panel to the user.
- Parameters
panels (Iterable[QgsPanelWidget]) – A list of panel widgets to connect.
-
connectNotify
(self, QMetaMethod)¶
-
contextMenuEvent
(self, QContextMenuEvent)¶
-
create
(self, window: sip.voidptr = 0, initializeWindow: bool = True, destroyOldWindow: bool = True)¶
-
customEvent
(self, QEvent)¶
-
destroy
(self, destroyWindow: bool = True, destroySubWindows: bool = True)¶
-
disconnectNotify
(self, QMetaMethod)¶
-
dockMode
(self) → bool¶ Returns the dock mode state.
- Return type
bool
- Returns
True
if in dock mode. If in dock mode the widget will emit the showPanel signal to handle panel opening IfFalse
it will open dialogs when openPanel is called.
-
dragEnterEvent
(self, QDragEnterEvent)¶
-
dragLeaveEvent
(self, QDragLeaveEvent)¶
-
dragMoveEvent
(self, QDragMoveEvent)¶
-
dropEvent
(self, QDropEvent)¶
-
enterEvent
(self, QEvent)¶
-
event
(self, QEvent) → bool¶
-
findParentPanel
(widget: QWidget) → QgsPanelWidget¶ Traces through the parents of a widget to find if it is contained within a QgsPanelWidget widget.
- Parameters
widget (QWidget) – widget which may be contained within a panel widget
- Return type
- Returns
parent panel widget if found, otherwise
None
New in version 3.0.
-
focusInEvent
(self, QFocusEvent)¶
-
focusNextChild
(self) → bool¶
-
focusNextPrevChild
(self, bool) → bool¶
-
focusOutEvent
(self, QFocusEvent)¶
-
focusPreviousChild
(self) → bool¶
-
hideEvent
(self, QHideEvent)¶
-
initPainter
(self, QPainter)¶
-
inputMethodEvent
(self, QInputMethodEvent)¶
-
isSignalConnected
(self, QMetaMethod) → bool¶
-
keyPressEvent
(self, event: QKeyEvent)¶ Overridden key press event to handle the esc event on the widget.
- Parameters
event (QKeyEvent) – The key event
-
keyReleaseEvent
(self, QKeyEvent)¶
-
leaveEvent
(self, QEvent)¶
Returns the menu to use for the menu button for this panel, or
None
if no menu button is required.New in version 3.12.
- Return type
QMenu
Returns the (translated) tooltip text to use for the menu button for this panel.
This is only used when the panel returns a menuButtonMenu().
New in version 3.12.
- Return type
str
-
metric
(self, QPaintDevice.PaintDeviceMetric) → int¶
-
mouseDoubleClickEvent
(self, QMouseEvent)¶
-
mouseMoveEvent
(self, QMouseEvent)¶
-
mousePressEvent
(self, QMouseEvent)¶
-
mouseReleaseEvent
(self, QMouseEvent)¶
-
moveEvent
(self, QMoveEvent)¶
-
nativeEvent
(self, Union[QByteArray, bytes, bytearray], sip.voidptr) → Tuple[bool, int]¶
-
openPanel
(self, panel: QgsPanelWidget)¶ Open a panel or dialog depending on dock mode setting If dock mode is
True
this method will emit the showPanel signal for connected slots to handle the open event.If dock mode is
False
this method will open a dialog and block the user.- Parameters
panel (QgsPanelWidget) – The panel widget to open.
-
paintEvent
(self, QPaintEvent)¶
-
panelAccepted
¶ Emitted when the panel is accepted by the user.
- Parameters
panel (QgsPanelWidget) – The panel widget that was accepted.
Note
This argument is normally raised with emit panelAccepted(this) so that callers can retrieve the widget easier in calling code.
Note
this is emitted only when this panel is accepted, and is not emitted for child panels. For example, if this panel opens a second stacked panel, then this panel will not emit panelAccepted when the second panel is accepted. [signal]
-
panelTitle
(self) → str¶ The title of the panel.
- Return type
str
- Returns
The title pf the panel.
-
receivers
(self, PYQT_SIGNAL) → int¶
-
resizeEvent
(self, QResizeEvent)¶
-
sender
(self) → QObject¶
-
senderSignalIndex
(self) → int¶
-
setAutoDelete
(self, autoDelete: bool)¶ The the auto delete property on the widget.
True
by default. When auto delete is enabled when a panel is removed from the stack it will be deleted.- Parameters
autoDelete (bool) – Enable or disable auto delete on the panel.
-
setDockMode
(self, dockMode: bool)¶ Set the widget in dock mode which tells the widget to emit panel widgets and not open dialogs
- Parameters
dockMode (bool) –
True
to enable dock mode.
-
setPanelTitle
(self, panelTitle: str)¶ Set the title of the panel when shown in the interface.
- Parameters
panelTitle (str) – The panel title.
-
showEvent
(self, QShowEvent)¶
-
showPanel
¶ Emit when you require a panel to be show in the interface.
- Parameters
panel (QgsPanelWidget) – The panel widget to show.
Note
If you are connected to this signal you should also connect given panels showPanel signal as they can be nested. [signal]
-
tabletEvent
(self, QTabletEvent)¶
-
timerEvent
(self, QTimerEvent)¶
-
updateMicroFocus
(self)¶
-
wheelEvent
(self, QWheelEvent)¶
-
widgetChanged
¶ Emitted when the widget state changes. Connect to this to pull any changes off the widget when needed. As panels are non blocking “dialogs” you should listen to this signal to give the user feedback when something changes. [signal]