wxPython StatusBar Widget

In this wxPython Tutorial, we will demonstrate how to use the StatusBar Widget, alongside it’s various styles, features and functions. A complete list of options will be included here, alongside several code examples for your convenience.

wxPython StatusBar Styles

A list of available Styles for the wxPython StatusBar widget.

wx.STB_SIZEGRIPDisplays a gripper at the right side of the status bar used to resize the parent window.
wx.STB_SHOW_TIPSDisplays tooltips for those panes whose status text has been ellipsized/truncated because the status text doesn’t fit the pane width. (Only available for GTK)
wx.STB_ELLIPSIZE_STARTIf the Text exceeds the size of the widget, this style replaces the beginning of the Text with Ellipsis (…).
wx.STB_ELLIPSIZE_MIDDLEIf the Text exceeds the size of the widget, this style replaces the middle of the Text with Ellipsis (…).
wx.STB_ELLIPSIZE_ENDIf the Text exceeds the size of the widget, this style replaces the end of the Text with Ellipsis (…).

wxPython StatusBar Methods

A list of useful methods for the wxPython StatusBar widget.

GetStatusText()Returns the Text currently being display on the StatusBar.
SetStatusText(string)Sets the Text to be display on the StatusBar.
SetMinHeight(int)Sets the minimum height for the StatusBar (actual size may vary due to font size)

Example Code

In this Example code, we’ll demonstrate how to create a StatusBar.

A fairly popular example/usage for the StatusBar is to display information for the widgets in the Window when a certain action is performed, such as hovering over it. In this example, we will make the wxPython StatusBar display the name of the Widget the mouse is currently hovering over.

First we created a bunch of standard widgets like the StaticText and Button, then bind them to the wx.EVT_ENTER_WINDOW event and the onHover() function. The wx.EVT_ENTER_WINDOW event triggers when you enter the space occupied by that specific widget.

The onHover() function, retrieves the Class Name of the widget that triggered the event and sets it as the text for the StatusBar.

import wx

class Window(wx.Frame):
    def __init__(self, title):
        super().__init__(parent = None, title = title)
        self.panel = wx.Panel(self)

        self.status = self.CreateStatusBar()

        text = wx.StaticText(self.panel, label= "Hello World", pos=(50, 50))
        button = wx.Button(self.panel, label = "Press Me", pos=(200, 50))
        rb = wx.RadioButton(self.panel, label = "Pizza", pos=(50, 120))
        cb = wx.ComboBox(self.panel, value = "Kittens", pos=(200, 120))

        self.panel.Bind(wx.EVT_ENTER_WINDOW, self.onHover)
        text.Bind(wx.EVT_ENTER_WINDOW, self.onHover)
        button.Bind(wx.EVT_ENTER_WINDOW, self.onHover)
        rb.Bind(wx.EVT_ENTER_WINDOW, self.onHover)
        cb.Bind(wx.EVT_ENTER_WINDOW, self.onHover)      


    def onHover(self, e):
        name = e.GetEventObject().GetClassName()
        self.status.SetStatusText(name + " Widget")
app = wx.App()
window = Window("WxPython Tutorial")

The output of the above code, while hovering over the Button.

wxPython StatusBar Example

self.CreateStatusBar() is a Frame method, used as an alternative way of creating the StatusBar. You can create it using the normal way as well, using wx.StatusBar().

This marks the end of the wxPython StatusBar Widget Tutorial. Any suggestions or contributions for CodersLegacy are more than welcome. Questions regarding the tutorial content can be asked in the comments section below.

Notify of
Inline Feedbacks
View all comments