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

117 lines
3.6 KiB
Plaintext

/************************************************************************
* This file has been generated automatically from *
* *
* src/gui/qgsstatusbar.h *
* *
* Do not edit manually ! Edit header and run scripts/sipify.py again *
************************************************************************/
class QgsStatusBar : QWidget
{
%Docstring(signature="appended")
A proxy widget for QStatusBar.
Unlike QStatusBar, :py:class:`QgsStatusBar` allows finer control of
widget placement, including the option to locate permanent widgets on
the left side of the bar.
:py:class:`QgsStatusBar` is designed to be embedded into an existing
window's QStatusBar, as a permanent widget. This allows reuse of the
special QStatusBar handling for resize grips and other platform specific
status bar tweaks.
Instead of adding child widgets and showing messages directly in the
window's status bar, these widgets (and messages) should instead be
added into the embedded :py:class:`QgsStatusBar`.
%End
%TypeHeaderCode
#include "qgsstatusbar.h"
%End
public:
enum Anchor
{
AnchorLeft,
AnchorRight,
};
QgsStatusBar( QWidget *parent /TransferThis/ = 0 );
%Docstring
Constructor for QgsStatusBar.
%End
void addPermanentWidget( QWidget *widget /Transfer/, int stretch = 0, Anchor anchor = AnchorRight );
%Docstring
Adds the given ``widget`` permanently to this status bar, reparenting
the widget if it isn't already a child of this object.
The ``stretch`` parameter is used to compute a suitable size for the
given widget as the status bar grows and shrinks. The default stretch
factor is 0, i.e giving the widget a minimum of space.
The ``anchor`` parameter controls which side of the status bar the
widget should be anchored to.
%End
void removeWidget( QWidget *widget );
%Docstring
Removes a ``widget`` from the status bar. Ownership of the widget
remains unchanged, and the widget itself is not deleted.
%End
QString currentMessage() const;
%Docstring
Returns the current message shown in the status bar.
.. seealso:: :py:func:`showMessage`
%End
public slots:
void showMessage( const QString &message, int timeout = 0 );
%Docstring
Displays the given ``message`` for the specified number of milli-seconds
(``timeout``). If ``timeout`` is 0 (default), the message remains
displayed until the :py:func:`~QgsStatusBar.clearMessage` slot is called
or until the :py:func:`~QgsStatusBar.showMessage` slot is called again
to change the message.
.. seealso:: :py:func:`clearMessage`
.. seealso:: :py:func:`currentMessage`
%End
void clearMessage();
%Docstring
Removes any temporary message being shown.
.. seealso:: :py:func:`showMessage`
%End
void setParentStatusBar( QStatusBar *statusBar );
%Docstring
Sets the parent status bar. Messages that are shown on the parent status
bar will be intercepted and shown on this status bar too.
.. versionadded:: 3.8
%End
protected:
virtual void changeEvent( QEvent *event );
};
/************************************************************************
* This file has been generated automatically from *
* *
* src/gui/qgsstatusbar.h *
* *
* Do not edit manually ! Edit header and run scripts/sipify.py again *
************************************************************************/