本文分享一個以 XML 為設定來源、可動態載入任意層級模組的整合框架。核心概念是把整個系統的「功能表結構」寫成一份 XML 檔,再由程式讀取這份設定,動態組出功能表、工具列與圖示面板,並在點擊時透過反射開啟對應的表單。
框架以 <Menu> 為根節點,每個 <MenuItem> 代表一個功能項,可透過巢狀結構表示子功能。每個節點帶有幾個關鍵屬性:
Name:顯示文字;AssemblyName:要載入的組件與類別(用於反射建立表單);FormTag:是否為表單;AddToolButton:是否在工具列顯示按鈕;Image:圖示檔名;ShortCut:快速鍵。例如「系統管理」底下可再展開「權限管理」,而最底層的「系統權限管理」則透過 AssemblyName 指向 HustCAD.IntePLM.WinUI.FrmSysRight,IntePLM.TyRightWinUI。
為確保設定檔格式正確,框架定義了一份 XML 架構(.xsd)來驗證。架構中 Menu 允許包含一個或多個 MenuItem(maxOccurs="unbounded"),而每個 MenuItem 又能以 minOccurs="0" maxOccurs="unbounded" 遞迴包含子項。屬性方面,AddToolButton、AddToolbar、FormTag 等布林屬性以 enumeration 限定為 TRUE 或 FALSE;AssemblyName 與 Name 標為 required;ShortCut 則用一长串 enumeration 枚舉 F1~F12、Ctrl、Shift、Alt 等合法快速鍵組合。
框架以 MenuLoad 類別負責組裝介面,內部持有 MenuBar、ToolStrip、OutlookBar 與 ImageList 等元件。載入流程如下:
1. ValidateXml 先以 XmlReaderSettings 掛上驗證事件,讀取整份 XML 並收集錯誤訊息;若無錯誤才回傳 true。
2. LoadMenus 在驗證通過後載入 XmlDocument,呼叫 GetMenus 取得主功能表。
3. GetMenus 先遍歷根節點,為每個頂層 MenuItem 建立 OfficeMenuItem 與對應的 IconPanel,避免迭代時畫面延遲,再交給 GetSubMenus 處理子項。
4. GetSubMenus 與 GetChildMenu 遞迴處理各層子功能,為每個項目掛上點擊事件、圖示與快速鍵,並視需要加入 OutlookBar 與 ToolStrip 按鈕。
點擊功能項時觸發 OnPluginClick,它從項目的 Tag 取出 MenuClass,判斷是否為「退出」,否則呼叫 OpenForm。OpenForm 透過 Type.GetType(asmname) 取得型別,再以 Activator.CreateInstance 動態建立物件,檢查是否為 Form 後,若主視窗是 MDI 容器就設為 MdiParent,最後呼叫 Show() 顯示。
這套框架大量運用 delegate 掛接事件,最關鍵的莫過於「載入功能表」與「OnPluginClick」兩個函式。由於所有功能都定義在 XML 中,只要修改設定檔即可動態增加任意層級的模組,無須改動主程式。相較於微軟 CAB 以 RegisterSite 方式加入模組,這種做法在擴充性與便利性上都更為直觀。若你對此框架有興趣,可寄信至 piyanrong@gmail.com 交流。