萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

使用 wxPython 打造簡易記事本:從零開始的 GUI 開發實戰

前言

wxPython 是成熟的跨平台 GUI 工具包,封裝了 C++ 的 wxWidgets,提供原生外觀與豐富元件。本文帶領你從零開始,打造一個具備「開啟、編輯、儲存」功能的簡易記事本,並解析關鍵架構與常見坑點。

環境準備

pip install wxPython  # 會自動安裝對應平台的預編譯輪子

核心架構:Frame → Panel → Sizer → Controls

  • Frame:頂層視窗,包含標題列、選單、狀態列。
  • Panel:容器,負責鍵盤導航(Tab 鍵切換焦點)與背景色。
  • Sizer:佈局管理器,BoxSizer(水平/垂直)、GridSizer、FlexGridSizer 等,自動處理視窗縮放時的元件重排。
  • Controls:按鈕、文字框、選單項等互動元件。

完整程式碼(重構為類別結構)

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()

關鍵技術點解析

  • wx.TE_RICH2
  • BoxSizer 比例參數
  • wx.FD_OVERWRITE_PROMPT
  • 編碼統一用 UTF-8
  • 錯誤處理
  • 技術點說明
    啟用 RichText 功能,支援字型、顏色、插圖(本範例未使用,但預留擴充性)
    proportion=1 表示佔用剩餘空間;工具列 0 固定高度,編輯區 1 自動填滿
    另存新檔時若檔案存在會詢問覆蓋,避免誤刪
    開啟/儲存皆指定 encoding='utf-8',相容中文與特殊字元
    檔案 I/O 包在 try/except,透過 wx.MessageBox 友善提示

    常見問題與解決

    • 視窗縮小時文字區不跟著縮放:確認 main_sizer.Add(text_ctrl, 1, wx.EXPAND) 設正確。
    • 中文顯示方塊:Windows 預設字型支援中文;Linux/Mac 需確保系統安裝中文字型,或在 SetFont 指定已知中文字型(如 Noto Sans CJK)。
    • 大檔案載入卡頓:TextCtrl 非為大檔設計;超過 10MB 建議改用 wx.stc.StyledTextCtrl(Scintilla 元件)或分頁載入。

    進階擴充方向

    1. 語法高亮:整合 wx.stc.StyledTextCtrl + 詞法分析器。
    2. 多標籤頁:使用 wx.Notebook 或 wx.aui.AuiNotebook。
    3. 撤銷/重做:TextCtrl 內建 Undo()/Redo(),配合選單項啟用。
    4. 自動儲存:wx.Timer 定期呼叫儲存邏輯。
    5. 打包發佈:使用 PyInstaller 或 cx_Freeze 產生單一執行檔。

    結語

    wxPython 雖學習曲線稍陡,但其原生外觀、完整文檔與活躍社群,使其成為開發桌面應用的可靠選擇。掌握 Sizer 佈局與事件綁定核心概念後,即可快速構建功能完整的 GUI 程式。

    copyright © 萬盛學電腦網 all rights reserved