Python實例講解——wxPython的基本控件實現


轉自:http://xjzhu123.blog.163.com/blog/static/1169361212012229102217352/

使用按鈕工作

 

在wxPython 中有很多不同類型的按鈕。這一節,我們將討論文本按鈕、位圖按鈕、開關按鈕(toggle buttons )和通用(generic )按鈕。

 

如何生成一個按鈕?

 

在第一部分(part 1)中,我們已經說明了幾個按鈕的例子,所以這里我們只簡短的涉及它的一些基本的東西。圖7.4顯示了一個簡單的按鈕。

 

7.4

 

 

使用按鈕是非常簡單的。例7.4顯示了該簡單按鈕的代碼。

 

Python代碼  

1 import wx  

2   

3 class ButtonFrame(wx.Frame):  

4     def __init__(self):  

5         wx.Frame.__init__(self, None, -1, 'Button Example',   

6                 size=(300, 100))  

7         panel = wx.Panel(self, -1)  

8         self.button = wx.Button(panel, -1, "Hello", pos=(50, 20))  

9         self.Bind(wx.EVT_BUTTON, self.OnClick, self.button)  

10         self.button.SetDefault()  

11   

12     def OnClick(self, event):  

13         self.button.SetLabel("Clicked")  

14           

15 if __name__ == '__main__':  

16     app = wx.PySimpleApp()  

17     frame = ButtonFrame()  

18     frame.Show()  

19     app.MainLoop()  

 

wx.Button 的構造函數類似於我們已經看到過的,如下所示:

wx.Button(parent , id , label , pos , size =wxDefaultSize , style =0, validator , name ="button ")

 

參數label 是顯示在按鈕上的文本。它可以在程序運行期間使用SetLabel() 來改變,並且使用GetLabel() 來獲取。另外兩個有用的方法是GetDefaultSize() 和SetDefault() 。GetDefaultSize() 返回系統默認按鈕的尺寸(對於框架間的一致性是有用的);SetDefault() 設置按鈕為對話框或框架的默認按鈕。默認按鈕的繪制不同於其它按鈕,它在對話框獲得焦點時,通常按下回車鍵被激活。

 

wx.Button 類有一個跨平台的樣式標記:wx.BU_EXACTFIT 。如果定義了這個標記,那么按鈕就不把系統默認的尺寸作為最小的尺寸,而是把能夠恰好填充標簽的尺寸作為最小尺寸。如果本地窗口部件支持的話,你可以使用標記wx.BU_LEFT , wx.BU_RIGHT , wx.BU_TOP , 和 wx.BU_BOTTOM 來改變按鈕中標簽的對齊方式。每個標記對齊標簽到邊,該邊你根據標記的名字可以知道。正如我們在第一部分中所討論過的,wx.Button 在被敲擊時觸發一個命令事件,事件類型是EVT_BUTTON 。

 

如何生成一個位圖按鈕?

 

有時候,你可能想在你的按鈕上顯示一個圖片,而非一個文本標簽,如圖7.5所示。

 

 

 

在wxPython 中,使用類wx.BitmapButton 來創建一個位圖按鈕。處理一個wx.BitmapButton 的代碼是與通用按鈕的代碼非常類似的,例7.5顯示了產生7.5的代碼。

 

7.5 創建一個位圖按鈕

 

 

Python代碼  

20 import wx  

21   

22 class BitmapButtonFrame(wx.Frame):  

23     def __init__(self):  

24         wx.Frame.__init__(self, None, -1, 'Bitmap Button Example',   

25                 size=(200, 150))  

26         panel = wx.Panel(self, -1)  

27         bmp = wx.Image("bitmap.bmp", wx.BITMAP_TYPE_BMP).ConvertToBitmap()  

28         self.button = wx.BitmapButton(panel, -1, bmp, pos=(10, 20))  

29         self.Bind(wx.EVT_BUTTON, self.OnClick, self.button)  

30         self.button.SetDefault()  

31         self.button2 = wx.BitmapButton(panel, -1, bmp, pos=(100, 20),   

32             style=0)  

33         self.Bind(wx.EVT_BUTTON, self.OnClick, self.button2)  

34   

35     def OnClick(self, event):  

36         self.Destroy()  

37           

38 if __name__ == '__main__':  

39     app = wx.PySimpleApp()  

40     frame = BitmapButtonFrame()  

41     frame.Show()  

42     app.MainLoop()  

 

與普通按鈕的主要的區別是你需要提供一個位圖,而非一個標簽。否則,構造器和大部分代碼是與文本按鈕的例子相同的。位圖按鈕在被敲擊時同樣產生EVT_BUTTON 事件。

 

關於位圖按鈕有幾個有趣的特性。首先,一個樣式標記wx.BU_AUTODRAW ,它是默認的。如果該標記是打開的,那么位圖將帶有一個3D的邊框,這使它看起來像一個文本按鈕(圖7.5中的左按鈕),並且按鈕比原位圖大幾個像素。如果該標記是關閉的,則位圖被簡單地繪制為按鈕而沒有邊框。通過設置style =0使圖7.5中右邊的按鈕關閉默認設置,它沒有了3D的效果。

 

默認情況下,給wxPython 傳遞單個位圖作為主顯示的位圖,在當按鈕被按下或獲得焦點或無效時,wxPython 自動創建一個標准的派生自主顯示的位圖的位圖作為此時顯示在按鈕上的位圖。如果自動創建的位圖不是你想要的,你可以使用下面的方法: SetBitmapDisabled() , SetBitmapFocus() ,SetBitmapLabel() , SetBitmap -Selected() 顯式地告訴wxPython 你要使用哪個位圖。這些方法都要求一個wx.Bitmap 對象作為參數,並且它們都有相應的get *()方法。

 

你不能通過使用標准的wxWidgets C++庫來合並一個位圖和文本。你可以創建一個包含文本的位圖。然而,正如我們將在通用按鈕問題討論中所看到的,wxPython 有額外的方法來實現這一合並行為。

 

 

=== 如何創建開關按鈕(toggle button )?===

 

你可以使用wx.ToggleButton 創建一個開關按鈕(toggle button )。開關按鈕(toggle button )看起來十分像文本按鈕,但它的行為更像復選框,它的選擇或非選擇狀態是可視化的。換句話說,當你按下一個開關按鈕(togglebutton )時,它將一直保持被按下的狀態直到你再次敲擊它。

 

在wx.ToggleButton 與父類wx.Button 之間只有丙個區別:

1、當被敲擊時,wx.ToggleButton 發送一個EVT_TOGGLEBUTTON 事件。

2wx.ToggleButton 有GetValue() 和SetValue() 方法,它們處理按鈕的二進制狀態。

 

開關按鈕(toggle button )是有用的,它相對於復選框是另一好的選擇,特別是在工具欄中。記住,你不能使用wxWidgets 提供的對象來將開關按鈕(toggle button )與位圖按鈕合並,但是wxPython 有一個通用按鈕類,它提供了這種行為,我們將在下一節對其作討論。

 

什么是通用按鈕,我為什么要使用它?

 

通用按鈕是一個完全用Python 重新實現的一個按鈕窗口部件,回避了本地系統窗口部件的用法。它的父類是wx.lib.buttons. GenButton 。通用按鈕有通用位圖和切換按鈕。

 

這兒有幾個使用通用按鈕的原因:

1、通用按鈕比本地按鈕具有更好的跨平台的外觀。另一方面,通用按鈕可能在具體的系統上看起來與本地按鈕有些微的不同。

2、使用通用按鈕,你對它的外觀有更多的控制權,並且能改變屬性,如3D斜面的寬度和顏色,而這對於本地控件可能是不允許的。

3、通用按鈕類允許特性的合並,而wxWidget 按鈕不行。比如GenBitmapTextButton 允許文本標簽和位圖的組合,GenBitmapToggleButton 實現一個位圖切換按鈕。

4、如果你正在創建一個按鈕類,使用通用按鈕是較容易的。由於其代碼和參數是用Python 寫的,所以當創建一個新的子類的時候,對於檢查和覆蓋,它們的可用性更好。

 

7.6顯示了實際的通用按鈕和常規按鈕的對照。

 

7.6

 

 

7.6顯示了產生圖7.6的代碼。第二個導入語句:import wx.lib.buttons as buttons ,是必須的,它使得通用按鈕類可用。

 

7.6 創建和使用wxPython 的通用按鈕

 

Python代碼  

43 import wx  

44 import wx.lib.buttons as buttons  

45   

46 class GenericButtonFrame(wx.Frame):  

47     def __init__(self):  

48         wx.Frame.__init__(self, None, -1, 'Generic Button Example',   

49                 size=(500, 350))  

50         panel = wx.Panel(self, -1)  

51   

52         sizer = wx.FlexGridSizer(1, 3, 20, 20)  

53         b = wx.Button(panel, -1, "A wx.Button")  

54         b.SetDefault()  

55         sizer.Add(b)  

56   

57         b = wx.Button(panel, -1, "non-default wx.Button")  

58         sizer.Add(b)  

59         sizer.Add((10,10))  

60   

61         b = buttons.GenButton(panel, -1, 'Genric Button')#基本的通用按鈕  

62         sizer.Add(b)  

63   

64         b = buttons.GenButton(panel, -1, 'disabled Generic')#無效的通用按鈕  

65         b.Enable(False)  

66         sizer.Add(b)  

67   

68         b = buttons.GenButton(panel, -1, 'bigger')#自定義尺寸和顏色的按鈕  

69         b.SetFont(wx.Font(20, wx.SWISS, wx.NORMAL, wx.BOLD, False))  

70         b.SetBezelWidth(5)  

71         b.SetBackgroundColour("Navy")  

72         b.SetForegroundColour("white")  

73         b.SetToolTipString("This is a BIG button...")  

74         sizer.Add(b)    

75   

76         bmp = wx.Image("bitmap.bmp", wx.BITMAP_TYPE_BMP).ConvertToBitmap()  

77         b = buttons.GenBitmapButton(panel, -1, bmp)#通用位圖按鈕  

78         sizer.Add(b)  

79   

80         b = buttons.GenBitmapToggleButton(panel, -1, bmp)#通用位圖開關按鈕  

81         sizer.Add(b)  

82           

83         b = buttons.GenBitmapTextButton(panel, -1, bmp, "Bitmapped Text",  

84                 size=(175, 75))#位圖文本按鈕  

85         b.SetUseFocusIndicator(False)  

86         sizer.Add(b)  

87   

88         b = buttons.GenToggleButton(panel, -1, "Toggle Button")#通用開關按鈕  

89         sizer.Add(b)  

90   

91         panel.SetSizer(sizer)  

92   

93 if __name__ == '__main__':  

94     app = wx.PySimpleApp()  

95     frame = GenericButtonFrame()  

96     frame.Show()  

97     app.MainLoop()    

 

在例7.6中,通用按鈕的用法非常類似於常規按鈕。通用按鈕產生與常規按鈕同樣的EVT_BUTTON 和 EVT_TOGGLEBUTTON事件。通用按鈕引入了GetBevelWidth() 和SetBevelWidth() 方法來改變3D斜面效果。它們用在了圖7.6中大按鈕上。

 

通用位圖按鈕類GenBitmapButton 工作的像標准的wxPython 版本。在構造器中。GenBitmapTextButton 要求先要一個位圖,然后是文本。通用類GenToggleButton ,GenBitmapToggleButton ,和 GenBitmapTextToggleButton 與非開關版的一樣,並且對於處理按鈕的開關狀態響應於GetToggle() 和 SetToggle() 。

 

在下一節,我們將討論關於使你的用戶能夠輸入或觀看一個數字值的方案。

 

輸入並顯示數字

 

有時你想要顯示圖形化的數字信息,或你想讓用戶不必使用鍵盤來輸入一個數字量。在這一節,我們將瀏覽wxPython中用於數字輸入和顯示的工具:滑塊(slider )、微調控制框和顯示量度的標尺。

 

如何生成一個滑塊?

 

滑塊是一個窗口部件,它允許用戶通過在該控件的尺度內拖動指示器來選擇一個數值。在wxPython 中,該控件類是wx.Slider ,它包括了滑塊的當前值的只讀文本的顯示。圖7.7顯示了水平和垂直滑塊的例子。

 

7.7

 

 

滑塊的基本使用是十分簡單的,但是你可以增加許多事件。

 

如何使用滑塊

 

7.7是產生圖7.7的例子。

 

7.7 水平和垂直滑塊的顯示代碼

 

 

Python代碼  

98 import wx   

99   

100 class SliderFrame(wx.Frame):  

101     def __init__(self):  

102         wx.Frame.__init__(self, None, -1, 'Slider Example',   

103                 size=(300, 350))  

104         panel = wx.Panel(self, -1)  

105         self.count = 0  

106         slider = wx.Slider(panel, 100, 25, 1, 100, pos=(10, 10),  

107                 size=(250, -1),  

108                 style=wx.SL_HORIZONTAL | wx.SL_AUTOTICKS | wx.SL_LABELS )  

109         slider.SetTickFreq(5, 1)  

110         slider = wx.Slider(panel, 100, 25, 1, 100, pos=(125, 70),  

111                 size=(-1, 250),  

112                 style=wx.SL_VERTICAL | wx.SL_AUTOTICKS | wx.SL_LABELS )  

113         slider.SetTickFreq(20, 1)  

114           

115 if __name__ == '__main__':  

116     app = wx.PySimpleApp()  

117     frame = SliderFrame()  

118     frame.Show()  

119     app.MainLoop()   

 

 

通常,當你使用wx.Slider 類時,所有你所需要的就是一個構造函數,它與別的調用不同,如下所示:

wx.Slider(parent , id , value , minValue , maxValue , pos =wxDefaultPosition , size =wx.DefaultSize , style=wx.SL_HORIZONTAL , validator =wx.DefaultValidator , name ="slider ")

value 是滑塊的初始值,而minValue 和maxValue 是兩端的值。

 

使用滑塊樣式工作

 

滑塊的樣式管理滑塊的位置和方向,如下表7.9所示。

 

7.9 wx.Slider 的樣式

 

wx.SL_AUTOTICKS :如果設置這個樣式,則滑塊將顯示刻度。刻度間的間隔通過SetTickFreq 方法來控制。

wx.SL_HORIZONTAL :水平滑塊。這是默認值。

wx.SL_LABELS :如果設置這個樣式,那么滑塊將顯示兩頭的值和滑塊的當前只讀值。有些平台可能不會顯示當前值。

wx.SL_LEFT :用於垂直滑塊,刻度位於滑塊的左邊。

wx.SL_RIGHT :用於垂直滑塊,刻度位於滑塊的右邊。

wx.SL_TOP :用於水平滑塊,刻度位於滑塊的上部。

wx.SL_VERTICAL :垂直滑塊。

 

如果你想通過改變滑塊中的值來影響你的應用程序中的其它的部分,那么這兒有幾個你可使用的事件。這些事件與窗口滾動條所發出的是相同的,詳細的說明參見第8章的滾動條部分。

 

7.10列出了你可用於滑塊的Set *()方法。每個Set *()方法都有一個對應的Get 方法——Get 方法的描述參考其對應的Set *()方法。

 

7.10

 

GetRange() SetRange(minValue , maxValue) :設置滑塊的兩端值。

GetTickFreq() SetTickFreq(n , pos) :使用參數n設置刻度的間隔。參數pos 沒有被使用,但是它仍然是必要的,將它設置為1

GetLineSize() SetLineSize(lineSize) :設置你每按一下方向鍵,滑塊所增加或減少的值。

GetPageSize() SetPageSize(pageSize) :設置你每按一下PgUp 或PgDn 鍵,滑塊所增加或減少的值。

GetValue() SetValue(value) :設置滑塊的值。

 

盡管滑塊提供了一個可能范圍內的值的快速的可視化的表示,但是它們也有兩個缺點。其一是它們占據了許多的空間,另外就是使用鼠標精確地設置滑塊是困難的。下面我們將討論的微調控制器解決了上面的這兩個問題。

 

如何得到那些靈巧的上下箭頭按鈕?

 

微調控制器是文本控件和一對箭頭按鈕的組合,它用於調整數字值,並且在你要求一個最小限度的屏幕空間的時候,它是替代滑塊的最好選擇。圖7.8顯示了wxPython 的微調控制器控件。

 

7.8

 

 

在wxPython 中,類wx.SpinCtrl 管理微調按鈕和相應的文本顯示。在接下來的部分,我們將創建一個微調控制器。

 

如何創建一個微調控制器

 

要使用wx.SpinCtrl 來改變值,可通過按箭頭按鈕或通過在文本控件中輸入。鍵入的非數字的文本將被忽略,盡管控件顯示的是鍵入的非數字的文本。一個超出范圍的值將被認作是相應的最大或最小值,盡管顯示的是你輸入的值。例7.8顯示了wx.SpinCtrl 的用法。

 

7.8 使用wx.SpinCtrl

 

Python代碼  

120 import wx  

121   

122 class SpinnerFrame(wx.Frame):  

123     def __init__(self):  

124         wx.Frame.__init__(self, None, -1, 'Spinner Example',   

125                 size=(100, 100))  

126         panel = wx.Panel(self, -1)  

127         sc = wx.SpinCtrl(panel, -1, "", (30, 20), (80, -1))  

128         sc.SetRange(1,100)  

129         sc.SetValue(5)  

130   

131 if __name__ == '__main__':  

132     app = wx.PySimpleApp()  

133     SpinnerFrame().Show()  

134     app.MainLoop()     

 

 

幾乎微調控件所有復雜的東西都是在其構造函數中,其構造函數如下:

 

Python代碼  

135 wx.SpinCtrl(parent, id=-1, value=wx.EmptyString, pos=wx.DefaultPosition, size=wx.DefaultSize, style=wx.SP_ARROW_KEYS, min=0, max=100, initial=0, name="wxSpinCtrl")   

 

 

參數value 是虛設的。使用initial 參數來設置該控件的值,並使用min 和max 來設置該控件的范圍。

對於wx.SpinCtrl 有兩個樣式標記。默認樣式是wx.SP_ARROW_KEYS ,它允許用戶通過鍵盤上的上下箭頭鍵來改變控件的值。樣式wx.SP_WRAP 使得控件中的值可以循環改變,也就是說你通過箭頭按鈕改變控件中的值到最大或最小值時,如果再繼續,值將變為最小或最大,從一個極端到另一個極端。

 

你也可以捕獲EVT_SPINCTRL 事件,它在當控件的值改變時產生(即使改變是直接由文本輸入引起的)。如果文本改變了,將引發一個EVT_TEXT 事件,就如同你使用一個單獨的文本控件時一樣。

 

如例7.8所示,你可以使用SetRange(minVal , maxVal) 和 SetValue(value) 方法來設置范圍和值。SetValue() 函數要求一個字符串或一個整數。要得到值,使用方法:GetValue() (它返回一個整數)GetMin() , 和 GetMax() 。

 

當你需要對微調控制器的行為有更多的控制時,如允許浮點數或一個字符串的列表,你可以把一個wx.SpinButton 和一個wx.TextCtrl 放到一起,並在它們之間建立一個聯系。然后捕獲來自wx.SpinButton 的事件,並更新wx.TextCtrl中的值。

 

如何生成一個進度條?

 

如果你只想圖形化地顯示一個數字值而不允許用戶改變它,那么使用相應的wxPython 窗口部件wx.Gauge 。 相關的例子就是圖7.9所顯示的進度條。

 

7.9

 

 

7.9顯示了產生圖7.9的代碼。與本章中許多別的例子不同的是,這里我們增加了一個事件處理器。下面的代碼在空閉時調整標尺的值,使得值周而復始的變化。

 

7.9 顯示並更新一個wx.Gauge

 

Python代碼  

136 import wx  

137   

138 class GaugeFrame(wx.Frame):  

139     def __init__(self):  

140         wx.Frame.__init__(self, None, -1, 'Gauge Example',   

141                 size=(350, 150))  

142         panel = wx.Panel(self, -1)  

143         self.count = 0  

144         self.gauge = wx.Gauge(panel, -1, 50, (20, 50), (250, 25))  

145         self.gauge.SetBezelFace(3)  

146         self.gauge.SetShadowWidth(3)  

147         self.Bind(wx.EVT_IDLE, self.OnIdle)  

148   

149     def OnIdle(self, event):  

150         self.count = self.count + 1  

151         if self.count  == 50:  

152             self.count = 0  

153         self.gauge.SetValue(self.count)  

154           

155 if __name__ == '__main__':  

156     app = wx.PySimpleApp()  

157     GaugeFrame().Show()  

158     app.MainLoop()    

 

wx.Gauge 的構造函數類似於其它的數字的窗口部件:

 

Python代碼  

159 wx.Gauge(parent, id, range, pos=wx.DefaultPosition, size=wx.DefaultSize, style=wx.GA_HORIZONTAL, validator=wx.DefaultValidator, name="gauge")   

 

 

當你使用參數range 來指定數字值時,該值代表標尺的上限,而下限總是0。默認樣式wx.GA_HORIZONTAL 提供了一個水平條。要將它旋轉90度,使用wx.GA_VERTICAL 樣式。如果你是在Windows 上,那么樣式wx.GA_PROGRESSBAR 給你的是來自Windows 工具包的本地化的進度條。

 

作為一個只讀控件,wx.Gauge 沒有事件。然而,它的屬性你可以設置。你可以使用GetValue() , Set -Value(pos) ,GetRange() , 和 SetRange(range) 來調整它的值和范圍。如果你是在Windows 上,並且沒有使用本地進度條樣式,那么你可以使用SetBezelFace(width) and SetShadowWidth() 來改變3D效果的寬度。

 

給用戶以選擇

 

幾乎每個應用程序都要求用戶在一套預先定義的選項間進行選擇。在wxPython 中,有多種窗口部件幫助用戶處理這種任務,包括復選框、單選按鈕、列表框和組合框。接下來的部分將介紹這些窗口部件。

 

如何創建一個復選框?

 

復選框是一個帶有文本標簽的開關按鈕。復選框通常成組的方式顯示,但是每個復選框的開關狀態是相互獨立的。當你有一個或多個需要明確的開關狀態的選項時,可以使用復選框。圖7.10顯示了一組復選框。

 

7.10

 

 

在wxPython 中復選框很容易使用。它們是wx.CheckBox 類的實例,並且通過把它們一起放入一個父容器中可以讓它們在一起顯示。例7.10提供了生成圖7.10的代碼。

 

7.10 插入三個復選框到一個框架中

 

Python代碼  

160 import wx  

161   

162 class CheckBoxFrame(wx.Frame):  

163     def __init__(self):  

164         wx.Frame.__init__(self, None, -1, 'Checkbox Example',   

165                 size=(150, 200))  

166         panel = wx.Panel(self, -1)  

167         wx.CheckBox(panel, -1, "Alpha", (35, 40), (150, 20))  

168         wx.CheckBox(panel, -1, "Beta", (35, 60), (150, 20))  

169         wx.CheckBox(panel, -1, "Gamma", (35, 80), (150, 20))  

170   

171 if __name__ == '__main__':  

172     app = wx.PySimpleApp()  

173     CheckBoxFrame().Show()  

174     app.MainLoop()    

 

wx.CheckBox 有一個典型的wxPython 構造函數:

 

Python代碼  

175 wx.CheckBox(parent, id, label, pos=wx.DefaultPosition, size=wx.DefaultSize, style=0, name="checkBox")   

 

 

label 參數是復選框的標簽文本。復選框沒有樣式標記,但是它們產生屬於自己的獨一無二的命令事件:EVT_CHECKBOX 。wx.CheckBox 的開關狀態可以使用GetValue() 和SetValue(state) 方法來訪問,並且其值是一個布爾值。IsChecked() 方法等同於GetValue() 方法,只是為了讓代碼看起來更易明白。

 

如何創建一組單選按鈕(radio button )?

單選按鈕是一種允許用戶從幾個選項中選擇其一的窗口部件。與復選框不同,單選按鈕是顯式地成組配置,並且只能選擇其中一個選項。當選擇了新的選項時,上次的選擇就關閉了。單選按鈕的使用比復選框復雜些,因為它需要被組織到一組中以便使用。radio button 的名字得自於老式轎車上有着同樣行為的成組的選擇按鈕。

 

在wxPython 中,有兩種方法可以創建一組單選按鈕。其一,wx.RadioButton ,它要求你一次創建一個按鈕,而wx.RadioBox 使你可以使用單一對象來配置完整的一組按鈕,這些按鈕顯示在一個矩形中。

 

wx.RadioButton 類更簡單些,在單選按鈕對其它窗口部件有直接影響或單選按鈕不是布置在一個單一的矩形中的情況下,它是首選。圖7.11顯示了一組wx.RadioButton 對象的列子。

 

7.11

 

 

我們在這個例子中使用wx.RadioButton 的原因是因為每個單選按鈕控制着一個關聯的文本控件。由於窗口部件是位於這組單選按鈕之外的,所以我們不能只用一個單選按鈕框。

 

如何創建單選按鈕

 

7.11顯示了圖7.11的代碼,它管理單選按鈕和文本控件之間的聯系。

 

7.11 使用wx.RadioButton 來控制另一個窗口部件

 

Python代碼  

176 import wx  

177   

178 class RadioButtonFrame(wx.Frame):  

179     def __init__(self):  

180         wx.Frame.__init__(self, None, -1, 'Radio Example',   

181                 size=(200, 200))  

182         panel = wx.Panel(self, -1)  

183   

184 #創建單選按鈕  

185         radio1 = wx.RadioButton(panel, -1, "Elmo", pos=(20, 50), style=wx.RB_GROUP)  

186         radio2 = wx.RadioButton(panel, -1, "Ernie", pos=(20, 80))  

187         radio3 = wx.RadioButton(panel, -1, "Bert", pos=(20, 110))  

188   

189 #創建文本控件  

190         text1 = wx.TextCtrl(panel, -1, "", pos=(80, 50))  

191         text2 = wx.TextCtrl(panel, -1, "", pos=(80, 80))  

192         text3 = wx.TextCtrl(panel, -1, "", pos=(80, 110))  

193         self.texts = {"Elmo": text1, "Ernie": text2, "Bert": text3}#連接按鈕和文本  

194         for eachText in [text2, text3]:  

195             eachText.Enable(False)  

196         for eachRadio in [radio1, radio2, radio3]:#綁定事件  

197             self.Bind(wx.EVT_RADIOBUTTON, self.OnRadio, eachRadio)  

198         self.selectedText = text1  

199   

200     def OnRadio(self, event):#事件處理器  

201         if self.selectedText:  

202             self.selectedText.Enable(False)  

203         radioSelected = event.GetEventObject()  

204         text = self.texts[radioSelected.GetLabel()]  

205         text.Enable(True)  

206         self.selectedText = text  

207   

208 if __name__ == '__main__':  

209     app = wx.PySimpleApp()  

210     RadioButtonFrame().Show()  

211     app.MainLoop()   

 

我們創建了單選按鈕和文本框,然后使用字典來建立它們間的連接。一個for 循環使得兩個文本框無效,另一個for 循環綁定單選按鈕命令事件。當事件發生的時候,當前活動的文本框變為無效,與被敲擊的按鈕相匹配的文本框變為有效。

wx.RadioButton 的使用類似於是wx.CheckBox 。它們的構造函數幾乎是相同的,如下所示:

 

Python代碼  

212 wx.RadioButton(parent, id, label, pos=wx.DefaultPosition, size=wx.DefaultSize, style=0, validator=wx.DefaultValidator, name="radioButton")   

 

 

在復選框中,label 是相應按鈕的顯示標簽。

 

wx.RB_GROUP 樣式聲明該按鈕位於一組單選按鈕開頭。一組單選按鈕的定義是很重要的,因為它控制開關行為。當組中的一個按鈕被選中時,先前被選中的按鈕被切換到未選中狀態。在一個單選按鈕使用wx.RB_GROUP 被創建后,所有后來的被添加到相同父窗口部件中的單選按鈕都被添加到同一組,直到另一單選按鈕使用wx.RB_GROUP 被創建,並開始下一個組。在例7.11中,第一個單選按鈕是使用wx.RB_GROUP 聲明的,而后來的沒有。結果導致所有的按鈕都被認為在同一組中,這樣一來,敲擊它們中的一個時,先前被選中按鈕將關閉。

 

使用單選框

 

通常,如果你想去顯示一組按鈕,分別聲明它們不是最好的方法。取而代之,wxPython 使用wx.RadioBox 類讓你能夠創建一個單一的對象,該對象包含了完整的組。如圖7.12所示,它看起來非常類似一組單選按鈕。

 

7.12

 

 

要使用wx.RadioBox 類,你所需要的全部就是構造函數。例7.12顯示了圖7.12的代碼。

 

7.12 建造單選框

 

Python代碼  

213 import wx  

214   

215 class RadioBoxFrame(wx.Frame):  

216     def __init__(self):  

217         wx.Frame.__init__(self, None, -1, 'Radio Box Example',   

218                 size=(350, 200))  

219         panel = wx.Panel(self, -1)  

220         sampleList = ['zero', 'one', 'two', 'three', 'four', 'five',  

221                       'six', 'seven', 'eight']  

222         wx.RadioBox(panel, -1, "A Radio Box", (10, 10), wx.DefaultSize,  

223                         sampleList, 2, wx.RA_SPECIFY_COLS)  

224   

225         wx.RadioBox(panel, -1, "", (150, 10), wx.DefaultSize,  

226                         sampleList, 3, wx.RA_SPECIFY_COLS | wx.NO_BORDER)  

227   

228 if __name__ == '__main__':  

229     app = wx.PySimpleApp()  

230     RadioBoxFrame().Show()  

231     app.MainLoop()   

 

wx.RadioBox 的構造函數比簡單的單選按鈕更復雜,因為你需要去一下子為所有的按鈕指定數據,如下所示:

 

Python代碼  

232 wx.RadioBox(parent, id, label, pos=wx.DefaultPosition,  

233         size=wxDefaultSize, choices=None, majorDimension=0,  

234         style=wx.RA_SPECIFY_COLS, validator=wx.DefaultValidator,  

235         name="radioBox")  

 

label 參數是靜態文本,它顯示在單選框的邊框上。這些按鈕使用choices 參數指定,它是一個Python 的字符串標簽的序列。

 

如同網格的sizer 一樣,你通過使用規定一個維數的尺寸來指定wx.RadioBox 的尺度,wxPython 在另一維度上自動填充。維度的主尺寸使用majorDimension 參數指定。哪一維是主要的由樣式標記決定。默認值是wx.RA_SPECIFY_COLS 。在本例中,左框的列數被設置為2,右框的列數被設置為3,行數由choices 列表中的元素數量動態的決定。如果你想得到相反的行為,你要將樣式設置為wx.RA_SPECIFY_ROWS 。如果你想在單選框被敲擊時響應命令事件,那么這個命令事件是EVT_RADIOBOX 。

 

wx.RadioBox 類有許多方法來管理框中的不同的單選按鈕。這些方法使你能夠處理一個特定的內部按鈕,傳遞該按鈕的索引。索引以0為開始,並按嚴格的順序展開,它的順序就是按鈕標簽傳遞給構造函數的順序。表7.11列出了這些方法。

 

7.11 wx.RadioBox 的方法

EnableItem(n , flag) :flag 參數是一個布爾值,它用於使索引為n的按鈕有效或無效。要使整個框立即有效,使用Enable() 。

FindString(string) :根據給定的標簽返回相關按鈕的整數索引值,如果標簽沒有發現則返回-1

GetCount() :返回框中按鈕的數量。

GetItemLabel(n) SetItemLabel(n , string) :返回或設置索引為n的按鈕的字符串標簽。

GetSelection() GetStringSelection() SetSelection(n) SetStringSelection( string) :GetSelection() 和SetSelection() 方法處理當前所選擇的單選按鈕的整數索引。GetStringSelection() 返回當前所選擇的按鈕的字符串標簽,SetStringSelection() 改變所選擇的按鈕的字符串標簽為給定值。沒有set *()產生EVT_RADIOBOX 事件。

ShowItem(item , show) :show 參數是一個布爾值,用於顯示或隱藏索引為item 的按鈕。

 

單選按鈕不是給用戶一系列選擇的唯一方法。列表框和組合框占用的空間也少,也可以被配置來讓用戶從同一組中作多個選擇。

 

如何創建一個列表框?

 

列表框是提供給用戶選擇的另一機制。選項被放置在一個矩形的窗口中,用戶可以選擇一個或多個。列表框比單選按鈕占據較少的空間,當選項的數目相對少的時候,列表框是一個好的選擇。然而,如果用戶必須將滾動條拉很遠才能看到所有的選項的話,那么它的效用就有所下降了。圖7.13顯示了一個wxPython 列表框。

 

 

 

在wxPython 中,列表框是類wx.ListBox 的元素。該類的方法使你能夠處理列表中的選擇。

 

如何創建一個列表框

 

7.13顯示了產生圖7.13的代碼

 

7.13 使用wx.ListBox

 

Python代碼  

236 import wx  

237   

238 class ListBoxFrame(wx.Frame):  

239     def __init__(self):  

240         wx.Frame.__init__(self, None, -1, 'List Box Example',   

241                 size=(250, 200))  

242         panel = wx.Panel(self, -1)  

243   

244         sampleList = ['zero', 'one', 'two', 'three', 'four', 'five',  

245                       'six', 'seven', 'eight', 'nine', 'ten', 'eleven',  

246                       'twelve', 'thirteen', 'fourteen']  

247   

248         listBox = wx.ListBox(panel, -1, (20, 20), (80, 120), sampleList,   

249                 wx.LB_SINGLE)  

250         listBox.SetSelection(3)  

251                   

252 if __name__ == '__main__':  

253     app = wx.PySimpleApp()  

254     ListBoxFrame().Show()  

255     app.MainLoop()    

 

wx.ListBox 的構造函數類似於單選框的,如下所示:

 

Python代碼  

256 wx.ListBox(parent, id, pos=wx.DefaultPosition, size=wx.DefaultSize, choices=None, style=0, validator=wx.DefaultValidator, name="listBox")   

 

單選框和列表框的主要區別是wx.ListBox 沒有label 屬性。顯示在列表中的元素放置在參數choices 中,它是一個字符串的序列。列表框有三種互斥的樣式,它決定用戶如何從列表框中選擇元素,說明在表7.12中。

 

用戶通常對於多選有一些問題,因為它們一般希望見到的是單選列表,對於多選來說可能是有挑戰性的(就像單選題和多選題一樣),尤其是對於那些易受困擾的用戶。如果你使用了一個多選的列表,我們建議你清楚地標明該列表。

 

7.12 列表框的選擇類型樣式

 

wx.LB_EXTENDED :用戶可以通過使用shift 並敲擊鼠標來選擇一定范圍內的連續的選項,或使用等同功能的按鍵。

wx.LB_MULTIPLE :用戶可以一次選擇多個選項(選項可以是不連續的)。實際上,在這種情況下,列表框的行為就像是一組復選框。

 

wx.LB_SINGLE :用戶一次只能選一個選項。實際上,在這種情況下,列表框的行為就像是一組單選按鈕。

 

有三種控制wx.ListBox 中滾動條的顯示的樣式,如表7.13所示。

 

7.13 列表框的滾動條類型樣式

wx.LB_ALWAYS_SB :列表框將始終顯示一個垂直的滾動條,不管有沒有必要。

wx.LB_HSCROLL :如果本地控支持,那么列表框在選擇項太多時,將創建一個水平滾動條。

wx.LB_HSCROLL :列表框只在需要的時候顯示一個垂直的滾動條。這是默認樣式。

 

還有一個樣式wx.LB_SORT ,它使得列表中的元素按字母順序排序。

 

有兩個專用於wx.ListBox 的命令事件。EVT_LISTBOX 事件在當列表中的一個元素被選擇時觸發(即使它是當前所選擇的元素)。如果列表被雙擊,EVT_LISTBOX_DCLICK 事件發生。

 

有一些專用於列表框的方法,你可以用來處理框中的項目。表7.14對許多的方法作了說明。列表框中的項目索引從0開始。

一旦你有了一個列表框,自然就想把它與其它的窗口部件結合起來使用,如下拉菜單,或復選框。在下一節,我們對此作討論。

 

7.14 列表框的方法

Append(item) :把字符串項目添加到列表框的尾部。

Clear() :清空列表框。

Delete(n) :刪除列表框中索引為n的項目。

Deselect(n) :在多重選擇列表框中,導致位於位置n的選項取消選中。在其它樣式中不起作用。

FindString(string) :返回給定字符串的整數位置,如果沒有發現則返回-1

GetCount() :返回列表中字符串的數量。

GetSelection() SetSelection(n , select) GetStringSelection() SetStringSelection(string , select)GetSelections() :GetSelection() 得到當前選擇項的整數索引(僅對於單選列表)。對於多選列表,使用GetSelections() 來返回包含所選項目的整數位置的元組。對於單選列表,GetStringSelection() 返回當前選擇的字符串。相應的set 方法使用布爾值參數select 設置指定字符串或索引選項的狀態。使用這種方法改變選擇不觸發EVT_LISTBOX 事件。

GetString(n) SetString(n , string) :得到或設置位置n處的字符串。

InsertItems(items , pos) :插入參數items 中的字符串列表到該列表框中pos 參數所指定的位置前。位置0表示把項目放在列表的開頭。

Selected(n) :返回對應於索引為n的項目的選擇狀態的布爾值。

Set(choices) :重新使用 choices 的內容設置列表框。

 

如何合並復選框和列表框?

 

你可以使用類wx.CheckListBox 來將復選框與列表框合並。圖7.14顯示了列表框和復選框在合並在一起的例子。

 

7.14

 

 

wx.CheckListBox 的構造函數和大多數方法與wx.ListBox 的相同。它有一個新的事件:wx.EVT_CHECKLISTBOX ,它在當列表中的一個復選框被敲擊時觸發。它有兩個管理復選框的新的方法:Check(n , check) 設置索引為n的項目的選擇狀態,IsChecked(item) 在給定的索引的項目是選中狀態時返回True 。

 

如果我想要下拉形式的選擇該怎么做?

 

下拉式選擇是一種僅當下拉箭頭被敲擊時才顯示選項的選擇機制。它是顯示所選元素的最簡潔的方法,當屏幕空間很有限的時候,它是最有用的。圖7.15顯示了一個關閉的下拉式選擇。圖7.16顯示了一個打開的下拉式選擇。

 

7.15

 

7.16

 

 

 

下拉式選擇的使用與標准的列表框是很相似的。例7.14顯示了如何創建一個下拉式選擇。

 

7.14

 

Python代碼  

257 import wx  

258   

259 class ChoiceFrame(wx.Frame):  

260     def __init__(self):  

261         wx.Frame.__init__(self, None, -1, 'Choice Example',   

262                 size=(250, 200))  

263         panel = wx.Panel(self, -1)  

264         sampleList = ['zero', 'one', 'two', 'three', 'four', 'five',  

265                       'six', 'seven', 'eight']  

266         wx.StaticText(panel, -1, "Select one:", (15, 20))  

267         wx.Choice(panel, -1, (85, 18), choices=sampleList)  

268   

269 if __name__ == '__main__':  

270     app = wx.PySimpleApp()  

271     ChoiceFrame().Show()  

272     app.MainLoop()   

 

wx.Choice 的構造函數與列表框的基本相同:

 

Python代碼  

273 wx.Choice(parent, id, pos=wx.DefaultPosition, size=wx.DefaultSize, choices=None, style=0, validator=wx.DefaultValidator, name="choice")   

 

 

wx.Choice 沒有專門的樣式,但是它有獨特的命令事件:EVT_CHOICE 。幾乎表7.14中所有適用於單選列表框的方法都適用於wx.Choice 對象。

 

我能夠將文本域與列表合並在一起嗎?

 

將文本域與列表合並在一起的窗口部件稱為組合框,其本質上是一個下拉選擇和文本框的組合。圖7.17顯示了一個組合框。

 

7.17 左邊是wx.CB_DropDOWN 樣式,右邊是wx.CB_SIMPLE 樣式

 

 

 

在Windows 上,你可以使用右邊的樣式,它是一個列表框和文本框的組合。

創建組合框的代碼與我們已經見過的選擇是類似的。該類是wx.ComboBox ,它是wx.Choice 的一個子類。例7.15顯示了圖7.17的代碼:

 

7.15

 

Python代碼  

274 import wx  

275   

276 class ComboBoxFrame(wx.Frame):  

277     def __init__(self):  

278         wx.Frame.__init__(self, None, -1, 'Combo Box Example',   

279                 size=(350, 300))  

280         panel = wx.Panel(self, -1)  

281         sampleList = ['zero', 'one', 'two', 'three', 'four', 'five',  

282                       'six', 'seven', 'eight']  

283         wx.StaticText(panel, -1, "Select one:", (15, 15))  

284         wx.ComboBox(panel, -1, "default value", (15, 30), wx.DefaultSize,  

285                     sampleList, wx.CB_DropDOWN)  

286         wx.ComboBox(panel, -1, "default value", (150, 30), wx.DefaultSize,  

287                         sampleList, wx.CB_SIMPLE)  

288                           

289 if __name__ == '__main__':  

290     app = wx.PySimpleApp()  

291     ComboBoxFrame().Show()  

292     app.MainLoop()          

 

wx.ComboBox 的構造函數如下所示:

 

 

Python代碼  

293 wx.ComboBox(parent, id, value="", pos=wx.DefaultPosition,  

294         size=wx.DefaultSize, choices, style=0,  

295         validator=wx.DefaultValidator, name="comboBox")  

 

對於wx.ComboBox 來說有4種樣式。其中的兩種決定了如何繪制組合框:wx.CB_DropDOWN 創建一個帶有下拉列表的組合框,wx.CB_SIMPLE 創建一個帶有列表框的組合框。在Windows 上你可以只使用wx.CB_SIMPLE 樣式。任何組合框都可以被指定為wx.CB_READONLY 樣式,它防止用戶在文本域中鍵入。當組合框被指定為只讀時,所做的選擇必須來自於選擇列表的元素之一,即使你用程序來設置它也不行。最后wx.CB_SORT 樣式導致選擇列表中的元素按字母順序顯示。

 

由於wx.ComboBox 是wx.Choice 的子類,所有的wx.Choice 的方法都能被組合框調用,如表7.14所示。另外,還有許多方法被定義來處理文本組件,它們的行為同wx.TextCtrl (參見表7.4),所定義的方法有Copy() , Cut() ,GetInsertionPoint() , GetValue() , Paste() , Replace(from ,to , text) , Remove(from , to) ,SetInsertionPoint(pos) , SetInsertionPointEnd() ,和 SetValue() 。

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM