wxPython - 状态栏StatusBar

实战wxPython系列-038

状态栏是一个狭窄的窗口，可以沿着框架的底部放置，以提供少量的状态信息。它可以包含一个或多个字段，其中一个或多个字段的长度可以根据窗口的大小而变化。在wxPython中控件wx.StatusBar提供了状态栏的功能。

一、wx.StatusBar简介

wx.StatusBar控件用于显示应用程序状态信息。它可以分为几个部分来展示不同的信息。可以将其他控件插入到wx.StatusBar中，有两种方法可以为主窗口创建一个状态栏，一种是手动创建自己的wx.StatusBar并调用SetStatusBar()方法，另一种方法是调用CreateStatusBar()方法创建(默认创建方法)。

wx.StatusBar支持的窗口样式:

• wx.STB_SIZEGRIP：在状态栏的右侧显示一个可用于调整父窗口大小的抓手。
• wx.STB_SHOW_TIPS：要显示状态文本因该状态文本不适合窗格宽度而被省略/截断时给出提示。
• wx.STB_ELLIPSIZE_START：当状态文本宽度超过状态栏窗格的宽度时，将状态文本的开头替换为省略号(使用wx.Control.Ellipsize)。
• wx.STB_ELLIPSIZE_MIDDLE：当状态文本宽度超过状态栏窗格的宽度时，将状态文本的中间替换为省略号(使用wx.Control.Ellipsize)。
• wx.STB_ELLIPSIZE_END：当状态文本宽度超过状态栏窗格的宽度时，将状态文本的结尾替换为省略号(使用wx.Control.Ellipsize)。
• wx.STB_DEFAULT_STYLE：默认样式：包括wx.STB_SIZEGRIP|wx.STB_SHOW_TIPS| wx.STB_ELLIPSIZE_END|wx.FULL_REPAINT_ON_RESIZE。

wx.StatusBar常用方法：

• GetBorders(self)：返回在字段区域内呈现字段文本时使用的水平和垂直边框尺寸。
• GetField(self, n)：返回表示第n个字段的wx.StatusBarPane。
• GetFieldRect(self, i)：返回字段内部边界矩形的大小和位置。
• GetFieldsCount(self)：返回状态栏中的字段数。
• GetStatusStyle(self, n)：返回第n个字段的样式。
• GetStatusText(self, i=0)：返回与状态栏字段关联的字符串。如果字段有效，则为状态字段字符串，否则为空字符串。
• GetStatusWidth(self, n)：返回第n个字段的宽度。
• PopStatusText(self, field=0)：将文本恢复到最后一次调用PushStatusText之前的值。注意，如果SetStatusText同时被调用，PopStatusText将不会改变文本，也就是说，它不会覆盖对状态文本的显式更改，而只是恢复保存的文本。
• PushStatusText(self, string, field=0)：在每个字段堆栈中保存当前字段文本，并将字段文本设置为作为参数传递的字符串。
• SetFieldsCount(self, number=1, widths=None)：设置字段的数量，可选的字段宽度。
• SetMinHeight(self, height)：设置状态栏的最小可能高度。实际高度可能大于此处指定的高度，这取决于状态栏使用的字体大小。
• SetStatusStyles(self, styles)：设置状态行中字段的样式，可以使字段显示为平的或凸起的，而不是标准的下沉式3D边框。
• SetStatusText(self, text, i=0)：设置第i个字段的状态文本。给定的文本将替换当前文本。状态栏的显示将立即更新，因此在调用此函数后不需要调用wx.Window.Update。
• SetStatusWidths(self, widths)：设置状态行中字段的宽度。有两种类型的字段:固定宽度和可变宽度字段。对于固定宽度的字段，应该以像素为单位指定它们的(常量)宽度。对于可变宽度字段，指定一个负数，指示字段应该如何展开:所有可变宽度字段的剩余空间根据这个数字的绝对值在它们之间进行划分。宽度为-2的可变宽度字段的值是宽度为-1的字段的两倍，以此类推。例如，要在状态栏的右侧创建一个宽度为100的固定字段，另外两个字段分别占剩余空间的66%和33%，您应该使用包含-2、-1和100的数组。

图1：wx.StatusBar类继承关系

二、wx.StatusBar演示

#状态栏(wx.StatusBar)

import wx

class SampleStatusBar(wx.Frame):

    def __init__(self, *args, **kw):
        super(SampleStatusBar, self).__init__(*args, **kw)

        self.InitUi()

    def InitUi(self):
        #设置标题
        self.SetTitle("实战wxPython: 状态栏演示")
        #设置窗口尺寸
        self.SetSize(360, 240)

        panel = wx.Panel(self)

        button = wx.Button(panel, label="按钮", pos = (20, 20))
        chkBox = wx.CheckBox(panel, label="复选框", pos = (20, 90))
        cmbBox = wx.ComboBox(panel, pos = (120, 22), choices=["Python", "Ruby"])
        slider = wx.Slider(panel, 5, 6, 1, 10, (120, 90), (110, -1))

        panel.Bind(wx.EVT_ENTER_WINDOW, self.OnWidgetEnter)
        button.Bind(wx.EVT_ENTER_WINDOW, self.OnWidgetEnter)
        chkBox.Bind(wx.EVT_ENTER_WINDOW, self.OnWidgetEnter)
        cmbBox.Bind(wx.EVT_ENTER_WINDOW, self.OnWidgetEnter)
        slider.Bind(wx.EVT_ENTER_WINDOW, self.OnWidgetEnter)

        self.sb = self.CreateStatusBar()

        self.Centre()

    def OnWidgetEnter(self, e):
        name = e.GetEventObject().GetClassName()
        self.sb.SetStatusText(name + "控件")
    
def main():
    app = wx.App()
    sample = SampleStatusBar(None)
    sample.Show()
    app.MainLoop()

if __name__ == "__main__":
    main()

在上面的例子中，在一个wx.Frame控件中放置了五个控件。如果将鼠标指针悬停在这些控件上，它的名称将显示在wx.StatusBar中。

panel.Bind(wx.EVT_ENTER_WINDOW, self.OnWidgetEnter)

如果我们进入一个控件的区域，就会生成EVT_ENTER_WINDOW事件。

self.sb = self.CreateStatusBar()

使用CreateStatusBar()方法创建状态栏。

def OnWidgetEnter(self, e):
        name = e.GetEventObject().GetClassName()
        self.sb.SetStatusText(name + "控件")

在OnWidgetEnter()方法中，根据鼠标输入得到控件的名称。然后使用SetStatusText()方法将控件的名称显示出来。

图2：wx.StatusBar演示

三、本文知识点

• 使用wx.StatusBar显示状态信息。

前一篇：wxPython - 基本控件之滚动条ScrollBar