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

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

一个简单的 wxPython 消息框

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
#!/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秒后会展示一个消息框。

1
wx.FutureCall(5000, self.ShowMessage)

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

1
2
3
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 类。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
#!/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 个不同的对话框窗口,这些窗口在创建时使用了不同的样式标记。

1
2
3
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+ 可以显示所有这些信息。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
#!/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 框会显示。

1
2
3
4
5
        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.
"""

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

1
info = wx.AboutDialogInfo()

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

1
2
3
4
5
6
7
8
9
10
11
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 调用所有的需要的方法来设置相关属性。

1
wx.AboutBox(info)

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

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

自定义对话框

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
#!/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()

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

1
2
3
4
class ChangeDepthDialog(wx.Dialog):

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

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

1
2
3
4
chgdep = ChangeDepthDialog(None, 
title='Change Color Depth')
chgdep.ShowModal()
chgdep.Destroy()

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

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