QGIS/python/gui/auto_generated/qgspanelwidgetstack.sip.in
Nyall Dawson 3f6b490218 Sipify
2025-04-02 11:11:10 +10:00

151 lines
4.1 KiB
Plaintext

/************************************************************************
* This file has been generated automatically from *
* *
* src/gui/qgspanelwidgetstack.h *
* *
* Do not edit manually ! Edit header and run scripts/sipify.py again *
************************************************************************/
class QgsPanelWidgetStack : QWidget
{
%Docstring(signature="appended")
A stack widget to manage multiple overlapping stacked panels.
Handles the open and close events for added panels.
Any widgets that want to have a non blocking panel based interface
should use this class to manage the panels.
%End
%TypeHeaderCode
#include "qgspanelwidgetstack.h"
%End
public:
QgsPanelWidgetStack( QWidget *parent = 0 );
%Docstring
A stack widget to manage panels in the interface. Handles the open and
close events for added panels.
:param parent:
%End
void setMainPanel( QgsPanelWidget *panel /Transfer/ );
%Docstring
Sets the main ``panel`` widget for the stack and selects it for the
user.
The main widget cannot be closed and only the showPanel signal is
attached to handle children widget opening panels.
Ownership of ``panel`` is transferred to the stack.
.. note::
a stack can have only one main panel. Any existing main panel
should be removed by first calling :py:func:`~QgsPanelWidgetStack.takeMainPanel`.
.. seealso:: :py:func:`mainPanel`
.. seealso:: :py:func:`takeMainPanel`
%End
QgsPanelWidget *mainPanel();
%Docstring
The main panel widget that is set in the stack. The main widget can not
be closed and doesn't display a back button.
:return: The main :py:class:`QgsPanelWidget` that is active in the
stack.
.. seealso:: :py:func:`setMainPanel`
%End
QgsPanelWidget *takeMainPanel() /TransferBack/;
%Docstring
Removes the main panel widget from the stack and transfers ownsership to
the caller.
:return: The main widget that is set in the stack.
.. note::
Calling this will clear out any current stacked panels by accepting
each panel in turn.
.. seealso:: :py:func:`mainPanel`
.. seealso:: :py:func:`setMainPanel`
%End
void clear();
%Docstring
Clear the stack of all widgets. Unless the panels autoDelete is set to
``False`` the widget will be deleted.
%End
QgsPanelWidget *currentPanel();
%Docstring
Returns the panel currently shown in the stack.
%End
virtual QSize sizeHint() const;
virtual QSize minimumSizeHint() const;
public slots:
void acceptCurrentPanel();
%Docstring
Accept the current active widget in the stack.
Calls the panelAccepeted signal on the active widget.
.. seealso:: :py:func:`acceptAllPanels`
%End
void acceptAllPanels();
%Docstring
Accepts all panel widgets open in the stack in turn until only the
:py:func:`~QgsPanelWidgetStack.mainPanel` remains.
.. seealso:: :py:func:`acceptCurrentPanel`
%End
void showPanel( QgsPanelWidget *panel );
%Docstring
Show a panel in the stack widget. Will connect to the panels showPanel
event to handle nested panels. Auto switches the the given panel for the
user.
:param panel: The panel to show.
%End
void closePanel( QgsPanelWidget *panel );
%Docstring
Closes the panel in the widget. Will also delete the widget. This slot
is normally auto connected to panelAccepted when a panel is shown.
:param panel: The panel to close.
%End
protected:
virtual void mouseReleaseEvent( QMouseEvent *e );
virtual void keyPressEvent( QKeyEvent *e );
};
/************************************************************************
* This file has been generated automatically from *
* *
* src/gui/qgspanelwidgetstack.h *
* *
* Do not edit manually ! Edit header and run scripts/sipify.py again *
************************************************************************/