Class: QgsStatusBar

class qgis.gui.QgsStatusBar(parent: QWidget = None)

Bases: PyQt5.QtWidgets.QWidget

Constructor for QgsStatusBar.

A proxy widget for QStatusBar.

Unlike QStatusBar, QgsStatusBar allows finer control of widget placement, including the option to locate permanent widgets on the left side of the bar.

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 QgsStatusBar.

New in version 3.0: Methods

actionEvent
addPermanentWidget Adds the given widget permanently to this status bar, reparenting the widget if it isn’t already a child of this object.
changeEvent
childEvent
clearMessage Removes any temporary message being shown.
closeEvent
connectNotify
contextMenuEvent
create
currentMessage Returns the current message shown in the status bar.
customEvent
destroy
disconnectNotify
dragEnterEvent
dragLeaveEvent
dragMoveEvent
dropEvent
enterEvent
event
focusInEvent
focusNextChild
focusNextPrevChild
focusOutEvent
focusPreviousChild
hideEvent
initPainter
inputMethodEvent
isSignalConnected
keyPressEvent
keyReleaseEvent
leaveEvent
metric
mouseDoubleClickEvent
mouseMoveEvent
mousePressEvent
mouseReleaseEvent
moveEvent
nativeEvent
paintEvent
receivers
removeWidget Removes a widget from the status bar.
resizeEvent
sender
senderSignalIndex
sharedPainter
showEvent
showMessage Displays the given message for the specified number of milli-seconds (timeout).
tabletEvent
timerEvent
updateMicroFocus
wheelEvent

Signals

Attributes

AnchorLeft
AnchorRight
class Anchor

Bases: int

AnchorLeft = 0
AnchorRight = 1
actionEvent()
addPermanentWidget(self, widget: QWidget, stretch: int = 0, anchor: QgsStatusBar.Anchor = QgsStatusBar.AnchorRight)

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.

changeEvent(self, event: QEvent)
childEvent()
clearMessage(self)

Removes any temporary message being shown.

See also

showMessage()

closeEvent()
connectNotify()
contextMenuEvent()
create()
currentMessage(self) → str

Returns the current message shown in the status bar.

See also

showMessage()

customEvent()
destroy()
disconnectNotify()
dragEnterEvent()
dragLeaveEvent()
dragMoveEvent()
dropEvent()
enterEvent()
event()
focusInEvent()
focusNextChild()
focusNextPrevChild()
focusOutEvent()
focusPreviousChild()
hideEvent()
initPainter()
inputMethodEvent()
isSignalConnected()
keyPressEvent()
keyReleaseEvent()
leaveEvent()
metric()
mouseDoubleClickEvent()
mouseMoveEvent()
mousePressEvent()
mouseReleaseEvent()
moveEvent()
nativeEvent()
paintEvent()
receivers()
removeWidget(self, widget: QWidget)

Removes a widget from the status bar. Ownership of the widget remains unchanged, and the widget itself is not deleted.

resizeEvent()
sender()
senderSignalIndex()
sharedPainter()
showEvent()
showMessage(self, message: str, timeout: int = 0)

Displays the given message for the specified number of milli-seconds (timeout). If timeout is 0 (default), the message remains displayed until the clearMessage() slot is called or until the showMessage() slot is called again to change the message.

See also

clearMessage()

See also

currentMessage()

tabletEvent()
timerEvent()
updateMicroFocus()
wheelEvent()