Pygtk 简明教程

PyGTK - Dialog Class

Dialog 窗口小部件通常用作父窗口上方的弹出窗口。Dialog 的目的是从用户那里收集一些数据并将其发送到父窗口。Dialog 可以是模态的（它会阻止父帧）或无模态的（可以绕过 Dialog 帧）。

PyGTK 库的 Dialog 窗口小部件是一个垂直分割的窗口。在它的顶部部分，有一个 gtk.VBox，其中填充了 Label 或 Entry Widget。底部部分被称为 action_area，其中放置了一个或多个按钮。两个区域由 gtk.HSeparator 分隔。

gtk.Dialog 类具有以下构造函数 −

dlg = gtk.Dialog (Title = None, parent = None, flags = 0, buttons = None)

其中，

  1. Title − 这是出现在 Dialog 窗口小部件标题栏中的文本。

  2. Parent − 这是弹出 dialog 的顶级窗口的引用。

  3. Flag − 定义控制 Dialog 操作的常量。已定义的常量为 −

gtk.DIALOG_MODAL

如果设置，dialog 将截获所有键盘事件

gtk.DIALOG_DESTROY_WITH_PARENT

如果设置，则当其父元素被摧毁时，dialog 也会被摧毁。

gtk.DIALOG_NO_SEPARATOR

如果设置，则按钮上方没有分隔栏。

What is a Button?

按钮是包含 gtk.Button 及其 stock ID（或文本）与响应 ID 偶数元素元组对象。

响应 ID 可以是数字或预定义响应 ID 常量之一 -

  1. gtk.RESPONSE_NONE

  2. gtk.RESPONSE_REJECT

  3. gtk.RESPONSE_ACCEPT

  4. gtk.RESPONSE_DELETE_EVENT

  5. gtk.RESPONSE_OK

  6. gtk.RESPONSE_CANCEL

  7. gtk.RESPONSE_CLOSE

  8. gtk.RESPONSE_YES

  9. gtk.RESPONSE_NO

  10. gtk.RESPONSE_APPLY

  11. gtk.RESPONSE_HELP

gtk.Dialog 类的重要方法如下 -

  1. add_button() − 在 action_area 中添加具有 button_text 指定文本的按钮（或 stock 按钮，如果 button_text 为 stock ID）。

  2. response() − 发射具有在 response_id 中指定的值的“response”信号

  3. run() − 显示对话然后在发送 delete_event 时返回 response_id。

  4. set_default_response() − 设置对话 action 区域中的最后 widget，使用指定的 response_id 作为对话的默认 widget。

gtk.Dialog widget 发射以下信号 -

Close

当对话关闭时发射。

Response

当 action_area widget 激活时发射（按钮“点击”），对话收到 delete_event 或应用程序调用 response() 方法。

Dialog widget 的 action_area 中的两个按钮使用 Sock ID gtk.STOCK.CANCEL 和 gtk.STOCK_OK。它们分别与响应 ID gtk. RESPONSE_REJECT 和 gtk. RESPONSE_ACCEPT 关联。当按任何按钮时关闭 Dialog。run() 方法返回相应的响应 ID，可以用于进一步处理。

以下代码显示了其中包含按钮的顶级 gtk.Window。当点击按钮时，出现一个包含标签和两个按钮的 Dialog。

Example

观察以下代码 -

import gtk

class PyApp(gtk.Window):
   def __init__(self):
      super(PyApp, self).__init__()
      self.set_title("Dialog Demo")
      self.set_default_size(250, 200)
      fixed = gtk.Fixed()
      btn = gtk.Button("Show")
      btn.connect("clicked",self.show_sialog)
      fixed.put(btn,100,100)
      self.add(fixed)
      self.connect("destroy", gtk.main_quit)
      self.show_all()

   def show_sialog(self, widget, data=None):
      dialog = gtk.Dialog("My dialog",
         self,
         gtk.DIALOG_MODAL | gtk.DIALOG_DESTROY_WITH_PARENT,
         (gtk.STOCK_CANCEL, gtk.RESPONSE_REJECT,
         gtk.STOCK_OK, gtk.RESPONSE_ACCEPT))
      label = gtk.Label("Simple dialog")
      dialog.vbox.add(label)
      label.show()
      res = dialog.run()
      print res
      dialog.destroy()
if __name__ == '__main__':
   PyApp()
   gtk.main()

上述代码生成以下输出 -

dialog demo

Preconfigured Dialog Widgets

PyGTK API 具有多个预配置的 Dialog widget -

  1. MessageDialog

  2. AboutDialog

  3. ColorSelectionDialog

  4. FontSelectionDialog

  5. FileChooserDialog

为了演示 PyGTK 中上述标准对话的功能，在以下程序中将一个菜单（每个菜单项在点击时分别调用一个对话）放置在 gtk.Window 中。列出了响应以激活每个菜单项的信号的回调函数。您还可以理解为每种类型的对话 widget 提供的说明。

Example

观察以下代码 -

import gtk, pango

class PyApp(gtk.Window):
   def __init__(self):
      super(PyApp, self).__init__()
      self.set_title("Dialog Boxes")
      self.set_default_size(250, 200)
      self.set_position(gtk.WIN_POS_CENTER)

      mb = gtk.MenuBar()
      menu1 = gtk.Menu()
      file = gtk.MenuItem("_File")
      file.set_submenu(menu1)
      msg = gtk.MenuItem("MessageDialog")

      menu1.append(msg)
      abt = gtk.MenuItem("AboutDialog")
      menu1.append(abt)
      colo = gtk.MenuItem("colorDialog")
      menu1.append(colo)
      font = gtk.MenuItem("FontSelectionDialog")
      menu1.append(font)
      fl = gtk.MenuItem("FileChooserDialog")
      menu1.append(fl)
      mb.append(file)

      vbox = gtk.VBox(False, 2)
      vbox.pack_start(mb, False, False, 0)
      self.add(vbox)
      self.text = gtk.Label("TutorialsPoint")
      vbox.pack_start(self.text, True, True, 0)
      msg.connect("activate",self.on_msgdlg)
      abt.connect("activate",self.on_abtdlg)
      font.connect("activate",self.on_fntdlg)
      colo.connect("activate",self.on_color)

      fl.connect("activate", self.on_file)
      self.connect("destroy", gtk.main_quit)
      self.show_all()
   def on_msgdlg(self, widget):
      #MessageDialog usage code
   def on_abtdlg(self, widget):
      #AboutDialog usage code
   def on_fntdlg(self,widget):
      #FontSelectionDialog usage code
   def on_color(self, widget):
      #ColorChooserDialog usage cde
   Def on_file(self, widget):
      #FileChooserDialog usage code
if __name__ == '__main__':
   PyApp()
   gtk.main()

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

dialog boxes