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
欢迎关注，评论，收藏，点赞，和转发。