wxPython 是成熟的跨平台 GUI 工具包,封裝了 C++ 的 wxWidgets,提供原生外觀與豐富元件。本文帶領你從零開始,打造一個具備「開啟、編輯、儲存」功能的簡易記事本,並解析關鍵架構與常見坑點。
pip install wxPython # 會自動安裝對應平台的預編譯輪子
BoxSizer(水平/垂直)、GridSizer、FlexGridSizer 等,自動處理視窗縮放時的元件重排。import wx
class NotepadFrame(wx.Frame):
def __init__(self):
super().__init__(None, title='Simple Notepad', size=(800, 600))
self.current_file = None
self._build_ui()
self.Centre()
self.Show()
def _build_ui(self):
panel = wx.Panel(self)
# 工具列區
toolbar = wx.BoxSizer(wx.HORIZONTAL)
self.filename_ctrl = wx.TextCtrl(panel, style=wx.TE_READONLY)
btn_open = wx.Button(panel, label='開啟')
btn_save = wx.Button(panel, label='儲存')
btn_saveas = wx.Button(panel, label='另存新檔')
toolbar.Add(self.filename_ctrl, 1, wx.EXPAND | wx.ALL, 5)
for b in (btn_open, btn_save, btn_saveas):
toolbar.Add(b, 0, wx.LEFT, 5)
# 編輯區
self.text_ctrl = wx.TextCtrl(panel, style=wx.TE_MULTILINE | wx.TE_RICH2)
self.text_ctrl.SetFont(wx.Font(11, wx.FONTFAMILY_TELETYPE, wx.FONTSTYLE_NORMAL, wx.FONTWEIGHT_NORMAL))
# 主佈局
main_sizer = wx.BoxSizer(wx.VERTICAL)
main_sizer.Add(toolbar, 0, wx.EXPAND)
main_sizer.Add(self.text_ctrl, 1, wx.EXPAND | wx.ALL, 5)
panel.SetSizer(main_sizer)
# 事件綁定
btn_open.Bind(wx.EVT_BUTTON, self.on_open)
btn_save.Bind(wx.EVT_BUTTON, self.on_save)
btn_saveas.Bind(wx.EVT_BUTTON, self.on_save_as)
# 選單列
self._build_menubar()
# 狀態列
self.CreateStatusBar()
self.SetStatusText('就緒')
def _build_menubar(self):
menubar = wx.MenuBar()
file_menu = wx.Menu()
file_menu.Append(wx.ID_OPEN, '開啟\tCtrl+O')
file_menu.Append(wx.ID_SAVE, '儲存\tCtrl+S')
file_menu.Append(wx.ID_SAVEAS, '另存新檔\tCtrl+Shift+S')
file_menu.AppendSeparator()
file_menu.Append(wx.ID_EXIT, '離開\tCtrl+Q')
menubar.Append(file_menu, '檔案(&F)')
self.SetMenuBar(menubar)
self.Bind(wx.EVT_MENU, self.on_open, id=wx.ID_OPEN)
self.Bind(wx.EVT_MENU, self.on_save, id=wx.ID_SAVE)
self.Bind(wx.EVT_MENU, self.on_save_as, id=wx.ID_SAVEAS)
self.Bind(wx.EVT_MENU, self.on_exit, id=wx.ID_EXIT)
# --- 事件處理 ---
def on_open(self, event):
with wx.FileDialog(self, '開啟文字檔', wildcard='文字檔 (*.txt)|*.txt|所有檔案 (*.*)|*.*',
style=wx.FD_OPEN | wx.FD_FILE_MUST_EXIST) as dlg:
if dlg.ShowModal() == wx.ID_OK:
path = dlg.GetPath()
try:
with open(path, 'r', encoding='utf-8') as f:
self.text_ctrl.SetValue(f.read())
self.current_file = path
self.filename_ctrl.SetValue(path)
self.SetStatusText(f'已開啟: {path}')
except Exception as e:
wx.MessageBox(f'讀取失敗: {e}', '錯誤', wx.OK | wx.ICON_ERROR)
def _do_save(self, path):
try:
with open(path, 'w', encoding='utf-8') as f:
f.write(self.text_ctrl.GetValue())
self.current_file = path
self.filename_ctrl.SetValue(path)
self.SetStatusText(f'已儲存: {path}')
return True
except Exception as e:
wx.MessageBox(f'儲存失敗: {e}', '錯誤', wx.OK | wx.ICON_ERROR)
return False
def on_save(self, event):
if self.current_file:
self._do_save(self.current_file)
else:
self.on_save_as(event)
def on_save_as(self, event):
with wx.FileDialog(self, '另存新檔', wildcard='文字檔 (*.txt)|*.txt|所有檔案 (*.*)|*.*',
style=wx.FD_SAVE | wx.FD_OVERWRITE_PROMPT) as dlg:
if dlg.ShowModal() == wx.ID_OK:
self._do_save(dlg.GetPath())
def on_exit(self, event):
self.Close()
if __name__ == '__main__':
app = wx.App()
NotepadFrame()
app.MainLoop()
| 技術點 | 說明 | 啟用 RichText 功能,支援字型、顏色、插圖(本範例未使用,但預留擴充性) | proportion=1 表示佔用剩餘空間;工具列 0 固定高度,編輯區 1 自動填滿 |
另存新檔時若檔案存在會詢問覆蓋,避免誤刪 | 開啟/儲存皆指定 encoding='utf-8',相容中文與特殊字元 |
檔案 I/O 包在 try/except,透過 wx.MessageBox 友善提示 |
|---|
main_sizer.Add(text_ctrl, 1, wx.EXPAND) 設正確。SetFont 指定已知中文字型(如 Noto Sans CJK)。TextCtrl 非為大檔設計;超過 10MB 建議改用 wx.stc.StyledTextCtrl(Scintilla 元件)或分頁載入。wx.stc.StyledTextCtrl + 詞法分析器。wx.Notebook 或 wx.aui.AuiNotebook。TextCtrl 內建 Undo()/Redo(),配合選單項啟用。wx.Timer 定期呼叫儲存邏輯。PyInstaller 或 cx_Freeze 產生單一執行檔。wxPython 雖學習曲線稍陡,但其原生外觀、完整文檔與活躍社群,使其成為開發桌面應用的可靠選擇。掌握 Sizer 佈局與事件綁定核心概念後,即可快速構建功能完整的 GUI 程式。