Pygtk 简明教程

PyGTK - Toolbar Class

Toolbar 类从 gtk.Container 类继承。它保存和管理一组按钮和其他窗口小部件。通常在顶层窗口的菜单栏正下方看到一个或多条水平按钮条。工具栏也可以放在称为 HandleBox 的可拆卸窗口中。默认情况下,gtk.Toolbar 窗口小部件中的按钮水平排列。可以通过将方向属性设置为 gtk.ORIENTATION_VERTICAL 来设置垂直工具栏。

可以将工具栏配置为显示带图标、文本或两者兼有的按钮。样式枚举器为 -

gtk.TOOLBAR_ICONS

这些按钮仅在工具栏中显示图标。

gtk.TOOLBAR_TEXT

这些按钮在工具栏中只显示文本标签。

gtk.TOOLBAR_BOTH

这些按钮在工具栏中显示文本和图标。

gtk.TOOLBAR_BOTH_HORIZ

这些按钮将图标和文本并排显示,而不是垂直堆叠。

Toolbar 窗口小部件使用以下构造函数进行设置 −

bar = gtk.Toolbar()

Toolbar 的组成部分是 gtk.ToolItem 的实例。这些项目可以是 ToolButton、RadioToolButton、ToggleToolButton 或 SeparatorToolItem。为了给 ToolItem 对象分配图标,可以使用具有预定义 stock_ID 的图像,也可以通过 set_image() 方法分配自定义图像。

以下示例显示了如何构建不同的 ToolItem −

ToolButton

newbtn = gtk.ToolButton(gtk.STOCK_NEW)

RadioToolButton

rb1 = gtk.RadioToolButton(None,gtk.STOCK_JUSTIFY_LEFT)
rb2 = gtk.RadioToolButton(rb1,gtk.STOCK_JUSTIFY_RIGHT)

请注意,多个单选按钮被放入同一组中。

SeparatorToolItem

sep = gtk.SeparatorToolItem()

通过调用该 insert 方法,将这些项目放入工具栏中。

gtk.Toolbar.insert(item, index)

例如,

bar.insert(new,0)

您还可以使用 set_tooltip_text() 模块将工具提示分配给 ToolButton。例如, New 工具提示被分配给新的 ToolButton。

newbtn.set_tooltip_text("New")

Example

以下代码显示了一个顶级窗口,其中包含一个工具栏,用于包含常规工具项目、单选按钮和分隔项目。

import gtk

class PyApp(gtk.Window):

   def __init__(self):
      super(PyApp, self).__init__()
      self.set_title("Toolbar Demo")
      self.set_default_size(250, 200)
      self.set_position(gtk.WIN_POS_CENTER)

      toolbar = gtk.Toolbar()
      toolbar.set_style(gtk.TOOLBAR_ICONS)
      toolbar.set_orientation(gtk.ORIENTATION_HORIZONTAL)

      newbtn = gtk.ToolButton(gtk.STOCK_NEW)
      newbtn.set_tooltip_text("New")
      openbtn = gtk.ToolButton(gtk.STOCK_OPEN)
      savebtn = gtk.ToolButton(gtk.STOCK_SAVE)
      sep = gtk.SeparatorToolItem()

      rb1 = gtk.RadioToolButton(None,gtk.STOCK_JUSTIFY_LEFT)
      53
      rb2 = gtk.RadioToolButton(rb1,gtk.STOCK_JUSTIFY_RIGHT)

      prv = gtk.ToggleToolButton(gtk.STOCK_PRINT_PREVIEW)
      quitbtn = gtk.ToolButton(gtk.STOCK_QUIT)

      toolbar.insert(newbtn, 0)
      toolbar.insert(openbtn, 1)
      toolbar.insert(savebtn, 2)
      toolbar.insert(sep, 3)
      toolbar.insert(rb1,4)
      toolbar.insert(rb2,5)
      toolbar.insert(prv,6)
      toolbar.insert(quitbtn, 7)

      quitbtn.connect("clicked", gtk.main_quit)
      vbox = gtk.VBox(False, 2)
      vbox.pack_start(toolbar, False, False, 0)

      self.add(vbox)
      self.connect("destroy", gtk.main_quit)
      self.show_all()

   def on_checked(self, widget, data = None):
      state = "Button1 : "+str(self.btn1.get_active())+"
         Button2 : "+str(self.btn2.get_active())
      self.lbl.set_text(state)
if __name__ == '__main__':
   PyApp()
   gtk.main()

上述代码将生成以下输出 −

toolbar demo