wxPython 教程(六) 对话框

转自：http://thisis.yorven.site/blog/index.php/2017/09/22/wxpython-jiaocheng-duihuakuang/

对话框即 Dialog 是多数 GUI 应用不可缺少的部分。“对话”是指两个或更多人之间的交谈。在电脑应用中，对话框是指一个可以和应用交流的窗口，可以用来输入数据、修改数据、修改应用设置等。因此，对话框是用户和电脑程序交流的重要手段。本节我们主要对 wxPython 对话框 进行讲解。

一个简单的 wxPython 消息框

消息框可以给用户提供简单的信息，一个较好的例子是 CD 的刻录应用，当 CD 刻录完毕后会弹出一个消息框。

#!/usr/bin/python
# -*- coding: utf-8 -*-
 
'''
Translated By Achen
2017/9
===
ZetCode wxPython tutorial
 
This example shows a simple 
message box.
 
author: Jan Bodnar
website: www.zetcode.com
last modified: October 2011
'''
 
import wx
 
class Example(wx.Frame):
     
    def __init__(self, *args, **kwargs):
        super(Example, self).__init__(*args, **kwargs) 
             
        self.InitUI()
         
    def InitUI(self):    
 
        wx.FutureCall(5000, self.ShowMessage)
 
        self.SetSize((300, 200))
        self.SetTitle('Message box')
        self.Centre()
        self.Show(True)
 
    def ShowMessage(self):
        wx.MessageBox('Download completed', 'Info', 
            wx.OK | wx.ICON_INFORMATION)
 
 
def main():
     
    ex = wx.App()
    Example(None)
    ex.MainLoop()    
 
 
if __name__ == '__main__':
    main()    

这个例子在5秒后会展示一个消息框。

wx.FutureCall(5000, self.ShowMessage)

wx.FutureCall 在5秒后会调用某个方法。第一个参数是时间值，单位是毫秒；第二个参数是被调用的方法。

def ShowMessage(self):
    wx.MessageBox('Download completed', 'Info', 
        wx.OK | wx.ICON_INFORMATION)

wx.MessageBox 展示了一个小的对话框，其中三个参数，第一个为消息内容，第二个是标题，第三个是一些标记，用来展示不同的按钮和图标。在这个例子中，我们展示了一个 OK 按键和一个 Information 图标。

预定义 wxPython 对话框

wxPython 有多个预定义的对话框，这些对话框可以完成一些通用功能，比如展示文本、获取输入、载入以及保存文件等。

消息对话框

消息对话框用来给用户展示消息，它们比上面见过的简单消息框 （message box）更加灵活，可定制更多特性，我们可以更改图标或者按钮等。

标记	作用
wx.OK	展示 OK 键
wx.CANCEL	展示 Cancel 键
wx.YES_NO	展示 Yes 和 No 键
wx.YES_DEFAULT	使用默认 Yes 键
wx.NO_DEFAULT	使用默认 No 键
wx.ICON_EXCLAMATION	展示一个 alert 图标
wx.ICON_ERROR	展示一个 error 图标
wx.ICON_HAND	与 wx.ICON_ERROR 一样
wx.ICON_INFORMATION	展示一个 info 图标
wx.ICON_QUESTION	展示一个 question 图标

上表的各类标记均可以应用于 wx.MessageDialog 类。

#!/usr/bin/python
# -*- coding: utf-8 -*-
 
'''
ZetCode wxPython tutorial
 
This example shows four types of
message dialogs.
 
author: Jan Bodnar
website: www.zetcode.com
last modified: October 2011
'''
 
import wx
 
class Example(wx.Frame):
     
    def __init__(self, *args, **kwargs):
        super(Example, self).__init__(*args, **kwargs) 
             
        self.InitUI()
         
    def InitUI(self):    
 
        panel = wx.Panel(self)
 
        hbox = wx.BoxSizer()
        sizer = wx.GridSizer(2, 2, 2, 2)
 
        btn1 = wx.Button(panel, label='Info')
        btn2 = wx.Button(panel, label='Error')
        btn3 = wx.Button(panel, label='Question')
        btn4 = wx.Button(panel, label='Alert')
 
        sizer.AddMany([btn1, btn2, btn3, btn4])
 
        hbox.Add(sizer, 0, wx.ALL, 15)
        panel.SetSizer(hbox)
 
        btn1.Bind(wx.EVT_BUTTON, self.ShowMessage1)
        btn2.Bind(wx.EVT_BUTTON, self.ShowMessage2)
        btn3.Bind(wx.EVT_BUTTON, self.ShowMessage3)
        btn4.Bind(wx.EVT_BUTTON, self.ShowMessage4)
 
        self.SetSize((300, 200))
        self.SetTitle('Messages')
        self.Centre()
        self.Show(True)
 
    def ShowMessage1(self, event):
        dial = wx.MessageDialog(None, 'Download completed', 'Info', wx.OK)
        dial.ShowModal()
 
    def ShowMessage2(self, event):
        dial = wx.MessageDialog(None, 'Error loading file', 'Error', 
            wx.OK | wx.ICON_ERROR)
        dial.ShowModal()
 
    def ShowMessage3(self, event):
        dial = wx.MessageDialog(None, 'Are you sure to quit?', 'Question', 
            wx.YES_NO | wx.NO_DEFAULT | wx.ICON_QUESTION)
        dial.ShowModal()
 
    def ShowMessage4(self, event):
        dial = wx.MessageDialog(None, 'Unallowed operation', 'Exclamation', 
            wx.OK | wx.ICON_EXCLAMATION)
        dial.ShowModal()
 
def main():
     
    ex = wx.App()
    Example(None)
    ex.MainLoop()    
 
 
if __name__ == '__main__':
    main()

在上面的例子中，我们创建了 4 个按钮并将之放置到一个 grid sizer 中。这些按钮将展示 4 个不同的对话框窗口，这些窗口在创建时使用了不同的样式标记。

def ShowMessage2(self, event):
    dial = wx.MessageDialog(None, 'Error loading file', 'Error', 
        wx.OK | wx.ICON_ERROR)
    dial.ShowModal()

创建消息对话框比较简单。通过将 parent 参数设置为 None，我们将对话框设置为顶层窗口。接着的两个字符串参数为消息内容和对话框的标题。我们展示了一个 OK 按钮和一个 error 图标。调用 ShowModal() 函数，可以将对话框显示在屏幕上。

About 对话框

几乎每个应用都会有一个典型的 about 对话框，即关于对话框，经常放置在 帮助 菜单中。这个对话框的目的在于给用户提供应用的基本信息和当前版本。在过去，这些对话框相当的简明。近些年，大多数这样的对话框会提供额外的作者信息、应用的许可信息、公司或者应用的 logo，有的甚至会展示动画。从 版本 2.8.x 系列开始，wxPython 也有了专门的 About 对话框。

为了创建一个 About 对话框，我们需要新建两个对象：一个是 wx.AboutDialogInfo，另一个是 wx.AboutBox。

wxPython 可以展示两种 About 框，取决于我们使用哪个平台以及调用哪个方法，可以是原生的对话框也可以是 wxPython 类的对话框。Windows 原生对话框无法展示自定义的图标、许可文字以及URL链接。如果我们忽略这三个参数， wxPython 将展示一个原生的对话框，否则它将展示一个 wxPython 对话框。如果想尽可能的保持原生的话，建议在一个单独的菜单项提供许可信息。GTK+ 可以显示所有这些信息。

#!/usr/bin/python
# -*- coding: utf-8 -*-
 
'''
Translated By Achen
@2017/9/22
===
ZetCode wxPython tutorial
 
In this example, we create an
about dialog box. 
 
author: Jan Bodnar
website: www.zetcode.com
last modified: October 2011
'''
 
import wx
 
 
class Example(wx.Frame):
     
    def __init__(self, *args, **kwargs):
        super(Example, self).__init__(*args, **kwargs) 
             
        self.InitUI()
         
    def InitUI(self):    
 
        menubar = wx.MenuBar()
        help = wx.Menu()
        help.Append(100, '&About')
        self.Bind(wx.EVT_MENU, self.OnAboutBox, id=100)
        menubar.Append(help, '&Help')
        self.SetMenuBar(menubar)
 
        self.SetSize((300, 200))
        self.SetTitle('About dialog box')
        self.Centre()
        self.Show(True)
 
    def OnAboutBox(self, e):
         
        description = """File Hunter is an advanced file manager for 
the Unix operating system. Features include powerful built-in editor, 
advanced search capabilities, powerful batch renaming, file comparison, 
extensive archive handling and more.
"""
 
        licence = """File Hunter is free software; you can redistribute 
it and/or modify it under the terms of the GNU General Public License as 
published by the Free Software Foundation; either version 2 of the License, 
or (at your option) any later version.
 
File Hunter is distributed in the hope that it will be useful, 
but WITHOUT ANY WARRANTY; without even the implied warranty of 
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  
See the GNU General Public License for more details. You should have 
received a copy of the GNU General Public License along with File Hunter; 
if not, write to the Free Software Foundation, Inc., 59 Temple Place, 
Suite 330, Boston, MA  02111-1307  USA"""
 
 
        info = wx.AboutDialogInfo()
 
        info.SetIcon(wx.Icon('hunter.png', wx.BITMAP_TYPE_PNG))
        info.SetName('File Hunter')
        info.SetVersion('1.0')
        info.SetDescription(description)
        info.SetCopyright('(C) 2007 - 2014 Jan Bodnar')
        info.SetWebSite('http://www.zetcode.com')
        info.SetLicence(licence)
        info.AddDeveloper('Jan Bodnar')
        info.AddDocWriter('Jan Bodnar')
        info.AddArtist('The Tango crew')
        info.AddTranslator('Jan Bodnar')
 
        wx.AboutBox(info)
 
 
def main():
     
    ex = wx.App()
    Example(None)
    ex.MainLoop()    
 
 
if __name__ == '__main__':
    main()

这个例子有一个 about 菜单项，选择该项以后，about 框会显示。

        description = """File Hunter is an advanced file manager for 
the Unix operating system. Features include powerful built-in editor, 
advanced search capabilities, powerful batch renaming, file comparison, 
extensive archive handling and more.
"""

把太多文字放入到应用代码中并不是最好的办法。我们为了不让例子太复杂，把文字都放入到代码中了。在现实的程序中，文本应该单独放置在一个文件中。这样才能更好的去维护应用，比如要翻译应用的时候就比较方便。

info = wx.AboutDialogInfo()

首先要做的事情就是新建一个 wx.AboutDialogInfo 对象，构造函数的参数为空。

info.SetIcon(wx.Icon('hunter.png', wx.BITMAP_TYPE_PNG))
info.SetName('File Hunter')
info.SetVersion('1.0')
info.SetDescription(description)
info.SetCopyright('(C) 2007 - 2014 Jan Bodnar')
info.SetWebSite('http://www.zetcode.com')
info.SetLicence(licence)
info.AddDeveloper('Jan Bodnar')
info.AddDocWriter('Jan Bodnar')
info.AddArtist('The Tango crew')
info.AddTranslator('Jan Bodnar')

接着是调用对 wx.AboutDialogInfo 调用所有的需要的方法来设置相关属性。

wx.AboutBox(info)

在最后，我们新建了 wx.AboutBox 部件，唯一的参数就是刚才设置好的 wx.AboutDialogInfo 对象。

当然，如果我们想有有动画或者其他好看的特性，必须自己手动扩展 dialog 类。

自定义对话框

在下面的例子中我们创建了一个自定义对话框。图片处理应用可以选择一个图片的颜色深度，我们为此新建合适的对话框。

#!/usr/bin/python
# -*- coding: utf-8 -*-
 
'''
ZetCode wxPython tutorial
 
In this code example, we create a
custom dialog.
 
author: Jan Bodnar
website: www.zetcode.com
last modified: July 2012
'''
 
import wx
 
class ChangeDepthDialog(wx.Dialog):
     
    def __init__(self, *args, **kw):
        super(ChangeDepthDialog, self).__init__(*args, **kw) 
             
        self.InitUI()
        self.SetSize((250, 200))
        self.SetTitle("Change Color Depth")
         
         
    def InitUI(self):
 
        pnl = wx.Panel(self)
        vbox = wx.BoxSizer(wx.VERTICAL)
 
        sb = wx.StaticBox(pnl, label='Colors')
        sbs = wx.StaticBoxSizer(sb, orient=wx.VERTICAL)        
        sbs.Add(wx.RadioButton(pnl, label='256 Colors', 
            style=wx.RB_GROUP))
        sbs.Add(wx.RadioButton(pnl, label='16 Colors'))
        sbs.Add(wx.RadioButton(pnl, label='2 Colors'))
         
        hbox1 = wx.BoxSizer(wx.HORIZONTAL)        
        hbox1.Add(wx.RadioButton(pnl, label='Custom'))
        hbox1.Add(wx.TextCtrl(pnl), flag=wx.LEFT, border=5)
        sbs.Add(hbox1)
         
        pnl.SetSizer(sbs)
        
        hbox2 = wx.BoxSizer(wx.HORIZONTAL)
        okButton = wx.Button(self, label='Ok')
        closeButton = wx.Button(self, label='Close')
        hbox2.Add(okButton)
        hbox2.Add(closeButton, flag=wx.LEFT, border=5)
 
        vbox.Add(pnl, proportion=1, 
            flag=wx.ALL|wx.EXPAND, border=5)
        vbox.Add(hbox2, 
            flag=wx.ALIGN_CENTER|wx.TOP|wx.BOTTOM, border=10)
 
        self.SetSizer(vbox)
         
        okButton.Bind(wx.EVT_BUTTON, self.OnClose)
        closeButton.Bind(wx.EVT_BUTTON, self.OnClose)
         
         
    def OnClose(self, e):
         
        self.Destroy()
         
         
class Example(wx.Frame):
     
    def __init__(self, *args, **kw):
        super(Example, self).__init__(*args, **kw) 
             
        self.InitUI()
         
         
    def InitUI(self):    
     
        ID_DEPTH = wx.NewId()
 
        tb = self.CreateToolBar()
        tb.AddLabelTool(id=ID_DEPTH, label='', 
            bitmap=wx.Bitmap('color.png'))
         
        tb.Realize()
 
        self.Bind(wx.EVT_TOOL, self.OnChangeDepth, 
            id=ID_DEPTH)
 
        self.SetSize((300, 200))
        self.SetTitle('Custom dialog')
        self.Centre()
        self.Show(True)
         
         
    def OnChangeDepth(self, e):
         
        chgdep = ChangeDepthDialog(None, 
            title='Change Color Depth')
        chgdep.ShowModal()
        chgdep.Destroy()        
 
 
def main():
     
    ex = wx.App()
    Example(None)
    ex.MainLoop()    
 
 
if __name__ == '__main__':
    main()

在上面的例子中，我们新建了一个自定义对话框。

class ChangeDepthDialog(wx.Dialog):
     
    def __init__(self, *args, **kw):
        super(ChangeDepthDialog, self).__init__(*args, **kw) 

我们新建了一个 ChangeDepthDialog 对话框，它是继承于 wx.Dialog 部件。

chgdep = ChangeDepthDialog(None, 
    title='Change Color Depth')
chgdep.ShowModal()
chgdep.Destroy()  

上面几行代码中，我们实例化了一个 ChangeDepthDialog 类，然后调用了 ShowModal() 函数。不要忘记销毁。下面的对话框显示后，应用的其他顶级窗口无法在操作，直到我们关闭对话框。注意到，对话框的标题栏明显不同于普通窗口。

在本节，我们主要讲解 wxPython 对话框 相关知识。