翻譯改編自官方文檔：http://easygui.sourceforge.net/tutorial/index.html

翻譯改編者：小甲魚篷角，本文歡迎轉(zhuǎn)載记舆，轉(zhuǎn)載請(qǐng)保證原文的完整性！
演示使用 Python 3.3.3 版本

1. 安裝 EasyGui

官網(wǎng)：http://easygui.sourceforge.net

最新版： easygui-0.96.zip

使用標(biāo)準(zhǔn)方法安裝：

使用命令窗口切換到easygui-docs-0.96的目錄下
【W(wǎng)indows下】執(zhí)行C:\Python33\python.exe setup.py install
【Linux或Mac下】sudo /usr/bin/python33 setup.py install

1. 建議不要在 IDLE 上運(yùn)行 EasyGui

EasyGui 是運(yùn)行在 Tkinter 上并擁有自身的事件循環(huán)芯肤，而 IDLE 也是 Tkinter 寫的一個(gè)應(yīng)用程序并也擁有自身的事件循環(huán)。因此當(dāng)兩者同時(shí)運(yùn)行的時(shí)候，有可能會(huì)發(fā)生沖突娄徊，且?guī)聿豢深A(yù)測(cè)的結(jié)果。因此如果你發(fā)現(xiàn)你的 EasyGui 程序有這樣的問題盾戴，請(qǐng)嘗試在 IDLE 外去運(yùn)行你的程序寄锐。

2. 一個(gè)簡(jiǎn)單的例子

在 EasyGui 中，所有的 GUI 互動(dòng)均是通過簡(jiǎn)單的函數(shù)調(diào)用尖啡，下邊一個(gè)簡(jiǎn)單的例子告訴你 EasyGui 確實(shí)很 Easy橄仆！

import easygui as g
import sys

while 1:
g.msgbox("嗨，歡迎進(jìn)入第一個(gè)界面小游戲")
msg = "請(qǐng)問你希望在魚C工作室學(xué)習(xí)到什么知識(shí)呢"
title="小游戲互動(dòng)"
choices=["談戀愛","編程","OOXX","琴棋書畫"]
choice=g.choicebox(msg,title,choices)

#note that we convert choice to string,in case
#the user cancelled the choice,and we got None
g.msgbox("你的選擇是:"+str(choice),"結(jié)果")
msg="你希望重新開始小游戲嗎?"
title=" 請(qǐng)選擇"
if g.ccbox(msg,title):  #show a Contiue/Cancel dialog
    pass #user chose Contonue
else:
    sys.exit(0)  #user chose Cancel

3. EasyGui 的各種功能演示

要運(yùn)行 EasyGui 的演示程序可婶，在命令行調(diào)用 EasyGui 是這樣的：

C:\Python33\python.exe easygui.py
或者你可以從 IDE（例如 IDLE, PythonWin, Wing, 等等）上來調(diào)用：

import easygui as g
g.egdemo()
成功調(diào)用后你將可以嘗試 EasyGui 擁有的各種功能沿癞，并將你選擇的結(jié)果打印至控制臺(tái)。

4. 導(dǎo)入 EasyGui

為了使用 EasyGui 這個(gè)模塊矛渴，你應(yīng)該先導(dǎo)入它椎扬。最簡(jiǎn)單的導(dǎo)入語句是：

import easygui

如果你使用上面這種形式導(dǎo)入的話，那么你使用 EasyGui 的函數(shù)的時(shí)候具温，必須在函數(shù)的前面加上前綴 easygui蚕涤，像這樣：

easygui.msgbox(...)

另一種選擇是導(dǎo)入整個(gè) EasyGui 包：

from easygui import *

這使得我們更容易調(diào)用 EasyGui 的函數(shù)，你可以直接這樣編寫代碼：

msgbox(...)

第三種方案是使用類似下邊的 import 語句：

import easygui as g

這樣可以讓你保持 EasyGui 的命名空間铣猩，同時(shí)減少你的打字?jǐn)?shù)量揖铜。導(dǎo)入之后你就可以這么調(diào)用 EasyGui 的函數(shù)：

g.msgbox(...)

5. 使用 EasyGui

一旦你的模塊導(dǎo)入 EasyGui，GUI 操作就是一個(gè)簡(jiǎn)單的調(diào)用 EasyGui 函數(shù)的幾個(gè)參數(shù)的問題了达皿。

例如天吓，使用 EasyGui 來實(shí)現(xiàn)著名的“你好贿肩，世界！”程序是這樣的：

import easygui as g
g.msgbox("Hello, world!")

6. EasyGui 函數(shù)的默認(rèn)參數(shù)

對(duì)于所有函數(shù)而言龄寞，前兩個(gè)參數(shù)是消息和標(biāo)題汰规。按照這個(gè)規(guī)律，在某種情況下物邑，這可能不是最有利于用戶的安排（例如溜哮，對(duì)話框在獲取目錄和文件名的時(shí)候忽略消息參數(shù)），但我覺得保持這種一致性貫穿于所有的窗口部件是一種更為重要的考慮色解！

絕大部分的 EasyGui 函數(shù)都有默認(rèn)參數(shù)茂嗓，幾乎所有的組件都會(huì)顯示一個(gè)消息和標(biāo)題。標(biāo)題默認(rèn)是空字符串科阎，信息通常有一個(gè)簡(jiǎn)單的默認(rèn)值述吸。

這使得你可以盡量少的去設(shè)置參數(shù)，比如 msgbox() 函數(shù)標(biāo)題部分的參數(shù)就是可選的萧恕，所以你調(diào)用 msgbox() 的時(shí)候可以只指定一個(gè)消息參數(shù)刚梭，例如：

msgbox('我愛小甲魚^_')

當(dāng)然你也可以指定標(biāo)題參數(shù)和消息參數(shù)，例如：

msgbox('我愛小甲魚^_', '魚油心聲')

在各類按鈕組件里票唆，默認(rèn)的消息是"Shall I continue?"朴读，所以你可以不帶任何參數(shù)地去調(diào)用它們。這里我們演示不帶任何參數(shù)地去調(diào)用 ccbox()走趋，當(dāng)選擇"cancel"或關(guān)閉窗口的時(shí)候返回一個(gè)布爾類型的值：

if ccbox():
pass # user chose to continue
else:
return # user chose to cancel

7. 使用關(guān)鍵字參數(shù)調(diào)用 EasyGui 的函數(shù)

調(diào)用 EasyGui 函數(shù)還可以使用關(guān)鍵字參數(shù)哦衅金。（如忘了的童鞋翻出《零基礎(chǔ)入門學(xué)習(xí)Python》第18講自行腦補(bǔ)）

現(xiàn)在假設(shè)你需要使用一個(gè)按鈕組件，但你不想指定標(biāo)題參數(shù)（第二個(gè)參數(shù)）簿煌，你仍可以使用關(guān)鍵字參數(shù)的方法指定 choices 參數(shù)（第三個(gè)參數(shù)）氮唯，像這樣：

choices = ['愿意', '不愿意', '有錢的時(shí)候愿意']
reply = choicebox('你愿意購買資源打包支持小甲魚嗎？', choices = choices)

8. 使用按鈕組件

根據(jù)需求姨伟，EasyGui 在 buttonbox() 上建立了一系列的函數(shù)供調(diào)用惩琉。

8.1 msgbox()

msgbox(msg='(Your message goes here)', title=' ', ok_button='OK', image=None, root=None)

msgbox() 顯示一個(gè)消息和提供一個(gè)"OK"按鈕，你可以指定任意的消息和標(biāo)題夺荒，你甚至可以重寫"OK"按鈕的內(nèi)容瞒渠。
以下是 msgbox() 的實(shí)例函數(shù)：

def msgbox(msg="(Your message goes here)", title="", ok_button="OK"):
....

重寫"OK"按鈕最簡(jiǎn)單的方法是使用關(guān)鍵字參數(shù)：

msgbox("我一定要學(xué)會(huì)編程!", ok_button="加油!")

8.2 ccbox()

ccbox(msg='Shall I continue?', title=' ', choices=('Continue', 'Cancel'), image=None)

ccbox() 提供一個(gè)選擇：Continue 或者 Cancel，并相應(yīng)的返回 1（選中Continue）或者 0（選中Cancel）技扼。

注意 ccbox() 是返回整型的 1 或 0伍玖，不是布爾類型的 True 或 False。但你仍然可以這么寫：

if ccbox('要再來一次嗎剿吻？', choices=('要啊要啊^_', '算了吧T_T')):
msgbox('不給玩了窍箍，再玩就玩壞了......')
else:
sys.exit(0) # 記得先 import sys 哈

8.3 ynbox()

ynbox(msg='Shall I continue?', title=' ', choices=('Yes', 'No'), image=None)

同上，都不知作者設(shè)計(jì)這兩玩意兒搞啥......

8.4 buttonbox()

buttonbox(msg='', title=' ', choices=('Button1', 'Button2', 'Button3'), image=None, root=None)

可以使用 buttonbox() 定義自己的一組按鈕，buttonbox() 會(huì)顯示一組你定義好的按鈕椰棘。

當(dāng)用戶點(diǎn)擊任意一個(gè)按鈕的時(shí)候纺棺，buttonbox() 返回按鈕的文本內(nèi)容。如果用戶取消取消或者關(guān)閉窗口晰搀，那么會(huì)返回默認(rèn)選項(xiàng)（第一個(gè)選項(xiàng)）五辽。請(qǐng)看例子：

8.5 indexbox()

indexbox(msg='Shall I continue?', title=' ', choices=('Yes', 'No'), image=None)

基本跟上邊一樣，區(qū)別就是當(dāng)用戶選擇第一個(gè)按鈕的時(shí)候返回序號(hào) 0外恕， 選擇第二個(gè)按鈕的時(shí)候返回序號(hào) 1。

8.6 boolbox()

boolbox(msg='Shall I continue?', title=' ', choices=('Yes', 'No'), image=None)

如果第一個(gè)按鈕被選中則返回 1乡翅，否則返回 0鳞疲。

9. 如何在 buttonbox 里邊顯示圖片

當(dāng)你調(diào)用一個(gè) buttonbox 函數(shù)（例如 msgbox(), ynbox(), indexbox() 等等）的時(shí)候，你還可以為關(guān)鍵字參數(shù) image 賦值蠕蚜，這是設(shè)置一個(gè) .gif 格式的圖像（注意僅支持 GIF 格式哦）

10. 為用戶提供一系列選項(xiàng)

10.1 choicebox()

choicebox(msg='Pick something.', title=' ', choices=())

按鈕組件方便提供用戶一個(gè)簡(jiǎn)單的按鈕選項(xiàng)尚洽，但如果有很多選項(xiàng)，或者選項(xiàng)的內(nèi)容特別長(zhǎng)的話靶累，更好的策略是為它們提供一個(gè)可選擇的列表腺毫。

choicebox() 為用戶提供了一個(gè)可選擇的列表，使用序列（元祖或列表）作為選項(xiàng)挣柬，這些選項(xiàng)顯示前會(huì)按照不區(qū)分大小寫的方法排好序潮酒。

另外還可以使用鍵盤來選擇其中一個(gè)選項(xiàng)（比較糾結(jié)，但一點(diǎn)兒都不重要）：

例如當(dāng)按下鍵盤上的"g"鍵邪蛔，將會(huì)選中的第一個(gè)以"g"開頭的選項(xiàng)急黎。再次按下"g"鍵，則會(huì)選中下一個(gè)以"g"開頭的選項(xiàng)侧到。在選中最后一個(gè)以"g"開頭的選項(xiàng)的時(shí)候勃教，再次按下"g"鍵將重新回到在列表的開頭的第一個(gè)以"g"開頭的選項(xiàng)。
如果選項(xiàng)中沒有以"g"開頭的匠抗，則會(huì)選中字符排序在"g"之前（"f"）的那個(gè)字符開頭的選項(xiàng)
如果選項(xiàng)中沒有字符的排序在"g"之前的故源，那么在列表中第一個(gè)元素將會(huì)被選中。

綜合我們之前學(xué)習(xí)的文件功能汞贸，舉個(gè)高達(dá)上的例子（源代碼在第35講的課后作業(yè)中^_）：

10.2 multchoicebox()

multchoicebox(msg='Pick as many items as you like.', title=' ', choices=(), **kwargs)

multchoicebox() 函數(shù)也是提供一個(gè)可選擇的列表绳军，與 choicebox() 不同的是，multchoicebox() 支持用戶選擇 0 個(gè)著蛙，1 個(gè)或者同時(shí)選擇多個(gè)選項(xiàng)删铃。

multchoicebox() 函數(shù)也是使用序列（元祖或列表）作為選項(xiàng)，這些選項(xiàng)顯示前會(huì)按照不區(qū)分大小寫的方法排好序踏堡。

11. 讓用戶輸入消息

11.1 enterbox()

enterbox(msg='Enter something.', title=' ', default='', strip=True, image=None, root=None)

enterbox() 為用戶提供一個(gè)最簡(jiǎn)單的輸入框猎唁，返回值為用戶輸入的字符串。默認(rèn)返回的值會(huì)自動(dòng)去除首尾的空格，如果需要保留首尾空格的話請(qǐng)?jiān)O(shè)置參數(shù) strip=False诫隅。

11.2 integerbox()

integerbox(msg='', title=' ', default='', lowerbound=0, upperbound=99, image=None, root=None, **invalidKeywordArguments)

integerbox() 為用戶提供一個(gè)簡(jiǎn)單的輸入框腐魂，用戶只能輸入范圍內(nèi)（lowerbound參數(shù)設(shè)置最小值，upperbound參數(shù)設(shè)置最大值）的整型數(shù)值逐纬，否則會(huì)要求用戶重新輸入蛔屹。

11.3 multenterbox()

multenterbox(msg='Fill in values for the fields.', title=' ', fields=(), values=())

multenterbox() 為用戶提供多個(gè)簡(jiǎn)單的輸入框，要注意以下幾點(diǎn)：

如果用戶輸入的值比選項(xiàng)少的話豁生，則返回列表中的值用空字符串填充用戶為輸入的選項(xiàng)兔毒。
如果用戶輸入的值比選項(xiàng)多的話，則返回的列表中的值將截?cái)酁檫x項(xiàng)的數(shù)量甸箱。
如果用戶取消操作育叁，則返回域中的列表的值或者None值。

實(shí)現(xiàn)如下圖（源代碼在第35講的課后作業(yè)中^_）：

12. 讓用戶輸入密碼

有時(shí)候我們需要讓用戶輸入密碼芍殖，就是用戶輸入的東西看上去都是"*******"豪嗽。

12.1 passwordbox()

passwordbox(msg='Enter your password.', title=' ', default='', image=None, root=None)

passwordbox() 跟 enterbox() 樣式一樣，不同的是用戶輸入的內(nèi)容用"*"顯示出來豌骏，返回用戶輸入的字符串：

12.2 multpasswordbox()

multpasswordbox(msg='Fill in values for the fields.', title=' ', fields=(), values=())

multpasswordbox() 跟 multenterbox() 使用相同的接口龟梦，但當(dāng)它顯示的時(shí)候，最后一個(gè)輸入框顯示為密碼的形式（"*"）：

13. 顯示文本

EasyGui 還提供函數(shù)用于顯示文本窃躲。

13.1 textbox()

textbox(msg='', title=' ', text='', codebox=0)

textbox() 函數(shù)默認(rèn)會(huì)以比例字體（參數(shù) codebox=1 設(shè)置為等寬字體）來顯示文本內(nèi)容（會(huì)自動(dòng)換行哦）计贰，這個(gè)函數(shù)適合用于顯示一般的書面文字。

注：text 參數(shù)（第三個(gè)參數(shù)）可以是字符串類型框舔，列表類型蹦玫，或者元祖類型。

13.2 codebox()

codebox(msg='', title=' ', text='')

codebox() 以等寬字體顯示文本內(nèi)容刘绣，相當(dāng)于 textbox(codebox=1)

注：等寬字體很丑的樱溉，不信你試試看@_@

14. 目錄與文件

GUI 編程中一個(gè)常見的場(chǎng)景是要求用戶輸入目錄及文件名，EasyGui 提供了一些基本函數(shù)讓用戶來瀏覽文件系統(tǒng)纬凤，選擇一個(gè)目錄或文件福贞。

14.1 diropenbox()

diropenbox(msg=None, title=None, default=None)

diropenbox() 函數(shù)用于提供一個(gè)對(duì)話框，返回用戶選擇的目錄名（帶完整路徑哦）停士，如果用戶選擇"Cancel"則返回 None挖帘。

default 參數(shù)用于設(shè)置默認(rèn)的打開目錄（請(qǐng)確保設(shè)置的目錄已存在）。

14.2 fileopenbox()

fileopenbox(msg=None, title=None, default='*', filetypes=None)

fileopenbox() 函數(shù)用于提供一個(gè)對(duì)話框恋技，返回用戶選擇的文件名（帶完整路徑哦）拇舀，如果用戶選擇"Cancel"則返回 None。

關(guān)于 default 參數(shù)的設(shè)置方法：

default 參數(shù)指定一個(gè)默認(rèn)路徑蜻底，通常包含一個(gè)或多個(gè)通配符骄崩。
如果設(shè)置了 default 參數(shù)，fileopenbox() 顯示默認(rèn)的文件路徑和格式。
default 默認(rèn)的參數(shù)是'*'要拂，即匹配所有格式的文件抠璃。

例如：

default="c:/fishc/.py" 即顯示 C:\fishc 文件夾下所有的 Python 文件。
default="c:/fishc/test.py" 即顯示 C:\fishc 文件夾下所有的名字以 test 開頭的 Python 文件脱惰。

關(guān)于 filetypes 參數(shù)的設(shè)置方法：

可以是包含文件掩碼的字符串列表搏嗡，例如：filetypes = [".txt"]
可以是字符串列表，列表的最后一項(xiàng)字符串是文件類型的描述拉一，例如：filetypes = [".css", [".htm", ".html", "HTML files"]]

14.3 filesavebox()

filesavebox(msg=None, title=None, default='', filetypes=None)

filesavebox() 函數(shù)提供一個(gè)對(duì)話框采盒，讓用于選擇文件需要保存的路徑（帶完整路徑哦），如果用戶選擇"Cancel"則返回 None舅踪。

default 參數(shù)應(yīng)該包含一個(gè)文件名（例如當(dāng)前需要保存的文件名）纽甘，當(dāng)然你也可以設(shè)置為空的，或者包含一個(gè)文件格式掩碼的通配符抽碌。

filetypes 參數(shù)的設(shè)置方法請(qǐng)參考上邊。

15.1 EgStore

GUI 編程中一個(gè)常見的場(chǎng)景就是要求用戶設(shè)置一下參數(shù)决瞳，然后保存下來货徙，以便下次用戶使用你的程序的時(shí)候可以記住他的設(shè)置。

為了實(shí)現(xiàn)對(duì)用戶的設(shè)置進(jìn)行存儲(chǔ)和恢復(fù)這一過程皮胡，EasyGui 提供了一個(gè)叫做 EgStore 的類痴颊。為了記住某些設(shè)置，你的應(yīng)用程序必須定義一個(gè)類（暫時(shí)稱之為"設(shè)置"類屡贺，盡管你隨意地使用你想要的名稱設(shè)置它）繼承自 EgStore 類蠢棱。

然后你的應(yīng)用程序必須創(chuàng)建一個(gè)該類的對(duì)象（暫時(shí)稱之為"設(shè)置"對(duì)象）。

設(shè)置類的構(gòu)造函數(shù)（init 方法）必須初始化所有的你想要它所記住的那些值甩栈。

一旦你這樣做了泻仙，你就可以在"設(shè)置"對(duì)象中通過設(shè)定值去實(shí)例化變量，從而很簡(jiǎn)單地記住設(shè)置量没。之后使用 settings.store() 方法在硬盤上持久化設(shè)置對(duì)象玉转。

下面是創(chuàng)建一個(gè)"設(shè)置"類的例子：

-----------------------------------------------------------------------

create "settings", a persistent Settings object

Note that the "filename" argument is required.

The directory for the persistent file must already exist.

-----------------------------------------------------------------------

settingsFilename = os.path.join("C:", "FishCApp", "settings.txt") # Windows example
settings = Settings(settingsFilename)
下面是使用"設(shè)置"對(duì)象的例子：

we initialize the "user" and "server" variables

In a real application, we'd probably have the user enter them via enterbox

user = "奧巴馬"
server = "白宮"

we save the variables as attributes of the "settings" object

settings.userId = user
settings.targetServer = server
settings.store() # persist the settings

run code that gets a new value for userId

then persist the settings with the new value

user = "小甲魚"
settings.userId = user
settings.store()

16. 捕獲異常

exceptionbox()

使用 EasyGui 編寫 GUI 程序，有時(shí)候難免會(huì)產(chǎn)生異常殴蹄。當(dāng)然這取決于你如何運(yùn)行你的應(yīng)用程序究抓，當(dāng)你的應(yīng)用程序崩潰的時(shí)候，堆棧追蹤可能會(huì)被拋出袭灯，或者被寫入到 stdout 標(biāo)準(zhǔn)輸出函數(shù)中刺下。

EasyGui 通過 exceptionbox() 函數(shù)提供了更好的方式去處理異常，異常出現(xiàn)的時(shí)候稽荧，exceptionbox() 會(huì)顯示堆棧追蹤在一個(gè) codebox() 中并且允許你做進(jìn)一步的處理橘茉。

exceptionbox() 很容易使用，下面是一個(gè)例子：

try:
print('I Love FishC.com!')
int('FISHC') # 這里會(huì)產(chǎn)生異常
except:
exceptionbox()

————————————————

原文鏈接：https://blog.csdn.net/qianxinzhuanyan/java/article/details/84620619