wxPython - 基本控件之滚动条ScrollBar

实战wxPython系列-037

wx.ScrollBar是一个表示水平或垂直滚动条的控件。这个滚动条和某些窗口自动增加的两个滚动条是有区别的，但是它们处理事件的方式是一样的。

一、wx.ScrollBar简介

滚动条主要有下面四个属性：范围(range),滑块大小，页大小和当前位置。范围的含义指的是和这个滚动条绑定的窗口的逻辑单位的大小。比如一个表格有20行，那么和这个表格绑定的滚动条的范围就可以设置为20。滑块大小通常用来反映当前可视部分的大小，还用表格来作为例子，如果因为窗口大小的原因表格只能显示5行，那么滚动条的滑块大小就可以设置成5。如果滑块大小大于或者等于范围，在多数平台上，这个滚动条将自动隐藏。页大小指的是当滚动条执行翻页命令时需要滚动的单位数目。当前位置指的是滑块当前所处的位置。

wx.ScrollBar支持的窗口样式：

• wx.SB_HORIZONTAL：设置为水平滚动条。
• wx.SB_VERTICAL：设置为垂直滚动条。

wx.ScrollBar可发出的事件：

• EVT_SCROLL：处理所有滚动事件。
• EVT_SCROLL_TOP：处理wx.EVT_SCROLL_TOP滚动到顶部或最左侧(最小)位置事件。
• EVT_SCROLL_BOTTOM：处理wx.EVT_SCROLL_BOTTOM滚动到底部或最右边(最大)位置事件。
• EVT_SCROLL_LINEUP：处理wx.EVT_SCROLL_LINEUP滚动到顶部或者左侧事件。
• EVT_SCROLL_LINEDOWN：处理wx.EVT_SCROLL_LINEDOW滚动到底部或者右侧事件。
• EVT_SCROLL_PAGEUP：按页步长值处理wx.EVT_SCROLL_PAGEUP滚动到顶部或者左侧事件。
• EVT_SCROLL_PAGEDOWN：按页步长值处理wx.EVT_SCROLL_PAGEDOWN滚动到底部或者右侧事件。
• EVT_SCROLL_THUMBTRACK：处理wx.EVT_SCROLL_THUMBTRACK thumbtrack事件(当用户拖动thumbtrack时发送的频繁事件)。
• EVT_SCROLL_THUMBRELEASE：处理wxEVT_SCROLL_THUMBRELEASE thumb释放事件。
• EVT_SCROLL_CHANGED：处理wx.EVT_SCROLL_CHANGED滚动结束事件(仅MSW)。
• EVT_COMMAND_SCROLL：同EVT_SCROLL。
• EVT_COMMAND_SCROLL_TOP： 同EVT_SCROLL_TOP。
• EVT_COMMAND_SCROLL_BOTTOM：同EVT_SCROLL_BOTTOM。
• EVT_COMMAND_SCROLL_LINEUP：同EVT_SCROLL_LINEUP。
• EVT_COMMAND_SCROLL_LINEDOWN：同EVT_SCROLL_LINEDOWN。
• EVT_COMMAND_SCROLL_PAGEUP：同 EVT_SCROLL_PAGEUP。
• EVT_COMMAND_SCROLL_PAGEDOWN：同EVT_SCROLL_PAGEDOWN。
• EVT_COMMAND_SCROLL_THUMBTRACK：同EVT_SCROLL_THUMBTRACK。
• EVT_COMMAND_SCROLL_THUMBRELEASE：同EVT_SCROLL_THUMBRELEASE。
• EVT_COMMAND_SCROLL_CHANGED：同EVT_SCROLL_THUMBRELEASE。

wx.ScrollBar常用方法：

• GetPageSize(self)：获得页大小，通常这个大小和滑块大小相同。
• GetRange(self)：获得滚动条值的范围。
• GetThumbPosition(self)：获得滑块当前的位置。
• GetThumbSize(self)：获得滑块的尺寸。
• IsVertical(self)：对于设置了垂直样式的滚动条返回True。
• SetScrollbar(self, position, thumbSize, range, pageSize, refresh=True)：用来设置滚动条的所有属性。比如滑块位置（逻辑单位）,滑块大小，范围，页大小以及一个可选的bool参数refresh用来指示是否立即更新滚动条的显示。
• SetThumbPosition(self, viewStart)：设置滑块当前的位置。

二、wx.ScrollBar演示

#滚动条(wx.ScrollBar)

import wx

class SampleScrollBar(wx.Frame):

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

        self.InitUi()

    def InitUi(self):
        #设置标题
        self.SetTitle("实战wxPython: ScrollBar演示")
        #设置窗口尺寸
        self.SetSize(400, 300)

        panel = wx.Panel(self)
        panel.SetBackgroundColour(wx.Colour(192, 192, 192))
        
        sb_v = wx.ScrollBar(panel, pos=(20, 20), size=(-1,200), style=wx.SB_VERTICAL)
        sb_v.SetScrollbar(0, 0, 200, 10)
        sb_v.Bind(wx.EVT_SCROLL_THUMBTRACK, self.OnScrollV)
        sb_v.Bind(wx.EVT_SCROLL_LINEUP, self.OnScrollV)
        sb_v.Bind(wx.EVT_SCROLL_LINEDOWN, self.OnScrollV)
        sb_v.Bind(wx.EVT_SCROLL_PAGEUP, self.OnScrollV)
        sb_v.Bind(wx.EVT_SCROLL_PAGEDOWN, self.OnScrollV)

        self.info_v = wx.StaticText(panel, pos = (20, 220), size=(100, -1))
        self.info_v.SetLabel(str(sb_v.GetThumbPosition()))

        sb_h = wx.ScrollBar(panel, pos = (100, 40), size=(200, -1))
        sb_h.SetScrollbar(100, 10, 200, 10)
        sb_h.Bind(wx.EVT_SCROLL_THUMBTRACK, self.OnScrollH)
        sb_h.Bind(wx.EVT_SCROLL_LINEUP, self.OnScrollH)
        sb_h.Bind(wx.EVT_SCROLL_LINEDOWN, self.OnScrollH)
        sb_h.Bind(wx.EVT_SCROLL_PAGEUP, self.OnScrollH)
        sb_h.Bind(wx.EVT_SCROLL_PAGEDOWN, self.OnScrollH)

        self.info_h = wx.StaticText(panel, pos = (300, 40), size=(100,-1))
        self.info_h.SetLabel(str(sb_h.GetThumbPosition()))

        self.Centre()

    def OnScrollV(self, e):
        sb = e.GetEventObject()
        pos = sb.GetThumbPosition()
        self.info_v.SetLabel(str(pos))

    def OnScrollH(self, e):
        sb = e.GetEventObject()
        pos = sb.GetThumbPosition()
        self.info_h.SetLabel(str(pos))

def main():
    app = wx.App()
    sample = SampleScrollBar(None)
    sample.Show()
    app.MainLoop()

if __name__ == "__main__":
    main()

在上面的代码中，我们创建了一个垂直滚动条和一个水平滚动条，当我们拖动滑块，点击两端的箭头，或者操作键盘上的左右键， PageUp, PageDown键，滚动条的数值会发生改变。将这些操作所产生的事件绑定到OnScroll方法上，在该方法中获得滚动条的值，并将其在wx.StaticText控件上显示出来。

三、本文知识点

• 了解和使用wx.ScrollBar。

前一篇：wxPython - 基本控件之数据调节框SpinCtrl

欢迎关注，评论，收藏，点赞，和转发。