wxPython ToolBar類

工具欄包括文本文字說明或圖示按鈕的一個或多個水準條,通常被放置在MenuBar頂層幀的正下方。

如果wx.Toolbar對象的style參數設置為wx.TB_DOCKABLE,它成為可停靠。浮動工具欄還可以用wxPython中的AUIToolBar類來構造。

構造函數不帶任何參數則使用工具欄默認參數。附加參數可以傳遞給wx.ToolBar類構造如下 -

Wx.ToolBar(parent, id, pos, size, style)
對於wx.ToolBar定義的樣式參數包括常數 -
S.N.
參數和說明
1

wx.TB_FLAT

提供該工具欄平面效果
2

wx.TB_HORIZONTAL

指定水準佈局(默認)
3

wxTB_VERTICAL

指定垂直佈局
4

wx.TB_DEFAULT_STYLE

結合wxTB_FLAT和wxTB_HORIZONTAL
5

wx.TB_DOCKABLE

使工具欄浮動和可停靠
6

wx.TB_NO_TOOLTIPS

當滑鼠懸停在工具欄不顯示簡短幫助工具提示,
7

wx.TB_NOICONS

指定工具欄按鈕沒有圖示;默認它們是顯示的
8

wx.TB_TEXT

顯示在工具欄按鈕上的文本;默認情況下,只有圖示顯示
不同特徵的工具按鈕可以添加到工具欄。 Wx.ToolBar類具有以下有用的方法 -
S.N.
方法和說明
1

AddTool()

添加工具按鈕到工具欄。工具的類型是由各種參數指定的
2

AddRadioTool()

添加屬於按鈕的互斥組按鈕
3

AddCheckTool()

添加一個切換按鈕到工具欄
4

AddLabelTool()

使用圖示和標籤來添加工具
5

AddSeparator()

添加一個分隔符號來表示工具按鈕組
6

AddControl()

添加任何控制工具欄。 例如,wx.Button,wx.Combobox等。
7

ClearTools()

刪除所有在工具欄的按鈕
8

RemoveTool()

從給出工具按鈕移除工具欄
9

Realize()

工具按鈕增加調用
AddTool()方法至少需要三個參數 -
AddTool(parent, id, bitmap) 

父參數是在按鈕被添加到工具欄。通過位圖bitmap參數所指定圖像圖示。

工具按鈕發出EVT_TOOL事件。如果添加到工具欄其他控制必須由各自CommandEvent綁定器到事件處理程式約束。

實例

在下面的例子中,工具欄上顯示兩個正常的工具按鈕,三個單選工具按鈕和一個組合框。
首先,工具欄對象被啟動。
tb = wx.ToolBar( self, -1 )
self.ToolBar = tb
使用AddTool()方法,兩個工具的圖示為“新建”,“保存”被添加。
tb.AddTool( 101, wx.Bitmap("new.png") )
tb.AddTool(102,wx.Bitmap("save.png"))
一組RadioTools,然後添加到工具欄,其中只有一個是可選擇在同一時間。
right = tb.AddRadioTool(222,wx.Bitmap("right.png"))
center = tb.AddRadioTool(333,wx.Bitmap("center.png"))
justify = tb.AddRadioTool(444,wx.Bitmap("justify.png"))
使用wx.ComboBox控件的AddControl()方法添加到工具欄。組合框列表中包含的字體的名稱。
self.combo = wx.ComboBox(tb, 555, value = "Times", choices = ["Arial","Times","Courier"])
Realize() 方法需要被調用,以最終確定工具欄創建。
tb.Realize()
最後,事件綁定器工具欄和組合框被註冊。
tb.Bind(wx.EVT_TOOL, self.Onright)
tb.Bind(wx.EVT_COMBOBOX,self.OnCombo) 

相應的事件處理程式以追加方式處理該事件源。雖然EVT_TOOL事件的ID會顯示在工具欄下方的文本框中,選中的字體名稱添加到它的時候,EVT_COMBOBOX事件觸發。

def Onright(self, event):
   self.text.AppendText(str(event.GetId())+"\n")

def OnCombo(self,event):
   self.text.AppendText( self.combo.GetValue()+"\n")
整個代碼如下 -
import wx

class Mywin(wx.Frame):

   def __init__(self, parent, title):
      super(Mywin, self).__init__(parent, title = title)
      self.InitUI()

   def InitUI(self):
      menubar = wx.MenuBar()
      menu = wx.Menu()
      menubar.Append(menu,"File")
      self.SetMenuBar(menubar)

      tb = wx.ToolBar( self, -1 )
      self.ToolBar = tb

      tb.AddTool( 101, wx.Bitmap("new.png") )
      tb.AddTool(102,wx.Bitmap("save.png"))

      right = tb.AddRadioTool(222,wx.Bitmap("right.png"))
      center = tb.AddRadioTool(333,wx.Bitmap("center.png"))
      justify = tb.AddRadioTool(444,wx.Bitmap("justify.png"))

      tb.Bind(wx.EVT_TOOL, self.Onright)
      tb.Bind(wx.EVT_COMBOBOX,self.OnCombo)
      self.combo = wx.ComboBox( tb, 555, value = "Times", choices = ["Arial","Times","Courier"])

      tb.AddControl(self.combo )
      tb.Realize()
      self.SetSize((350, 250))

      self.text = wx.TextCtrl(self,-1, style = wx.EXPAND|wx.TE_MULTILINE)
      self.Centre()
      self.Show(True)

   def Onright(self, event):
      self.text.AppendText(str(event.GetId())+"\n")

   def OnCombo(self,event):
      self.text.AppendText( self.combo.GetValue()+"\n")

ex = wx.App()
Mywin(None,'ToolBar Demo - www.xuhuhu.com')
ex.MainLoop()
上面的代碼產生下麵的輸出 -



上一篇: Menu Item, Menu & MenuBar類 下一篇: wxPython Dialog類