想把一個日益膨脹的桌面程式拆成可以獨立增刪的功能模組,最常見的做法是寫死菜單、每加一個功能就改一次主程式。這篇提供另一條路:讓菜單結構完全由 XML 描述,並用 XSD 把這份描述約束起來,主程式只負責「照著讀」。
上篇先把兩個基礎檔案準備好——菜單定義檔與驗證用的 schema。
結構非常樸素:根元素 Menu 底下放若干 MenuItem,而 MenuItem 可以再嵌套 MenuItem,層次因此是無限的。
<Menu>
<MenuItem Name="系統管理" AssemblyName="" FormTag="FALSE" AddToolbar="FALSE">
<MenuItem Name="權限管理" ShortCut="" Image=""
AssemblyName="" FormTag="FALSE" AddToolButton="FALSE">
<MenuItem Name="系統權限管理" ShortCut="" Image="passWord.png"
AssemblyName="HustCAD.IntePLM.WinUI.FrmSysRight,IntePLM.TyRightWinUI"
FormTag="TRUE" AddToolButton="FALSE"/>
<MenuItem Name="權限規則定義" ShortCut="" Image="right.png"
AssemblyName="HustCAD.IntePLM.WinUI.FrmRightRule,IntePLM.TyRightWinUI"
FormTag="TRUE" AddToolButton="FALSE"/>
<MenuItem Name="權限日誌" ShortCut="" Image="doc_yellow_edit.png"
AssemblyName="HustCAD.IntePLM.WinUI.FrmRightLog,IntePLM.TyRightWinUI"
FormTag="TRUE" AddToolButton="FALSE"/>
</MenuItem>
</MenuItem>
</Menu>
每個屬性各有分工,理解它們的意思比記住語法更重要:
TRUE 才會觸發反射載入,FALSE 代表純分類。必填。F5、CtrlS。可選,且必須是 schema 認得的值。把「顯示文字」與「要去哪裡」拆成兩個不同屬性,是這份設計裡最關鍵的決定。因為兩者分離,同一支表單可以在菜單裡以不同名稱出現多次,介面調整時也不必動到任何程式碼。
XML 的長處是自由,短處也是自由。既然設定檔會決定整個程式的行為,就必須有東西告訴我們「怎樣才算寫對」。XSD 在這裡扮演的就是守門員。
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="https://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified">
<!-- 根元素:至少一個 MenuItem -->
<xs:element name="Menu">
<xs:complexType>
<xs:sequence>
<xs:element ref="MenuItem" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<!-- MenuItem 可自我嵌套,形成任意層次 -->
<xs:element name="MenuItem">
<xs:complexType>
<xs:sequence>
<xs:element ref="MenuItem" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<!-- 是否也在工具列上顯示 -->
<xs:attribute name="AddToolButton">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="TRUE"/>
<xs:enumeration value="FALSE"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="AddToolbar">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="TRUE"/>
<xs:enumeration value="FALSE"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<!-- 必填:表單所在位置 -->
<xs:attribute name="AssemblyName" type="xs:string" use="required"/>
<!-- 必填:是否為可開啟的表單節點 -->
<xs:attribute name="FormTag" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="TRUE"/>
<xs:enumeration value="FALSE"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<!-- 圖示檔名 -->
<xs:attribute name="Image" type="xs:string"/>
<!-- 必填:顯示文字 -->
<xs:attribute name="Name" type="xs:string" use="required"/>
<!-- 可選:全域快捷鍵,僅接受列舉中的值 -->
<xs:attribute name="ShortCut">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value=""/>
<xs:enumeration value="F1"/>
<xs:enumeration value="F2"/>
<!-- F3 ~ F12 依此類推 -->
<xs:enumeration value="CtrlA"/>
<xs:enumeration value="CtrlB"/>
<!-- CtrlC ~ CtrlZ 依此類推 -->
<xs:enumeration value="CtrlShiftA"/>
<!-- CtrlShiftB ~ CtrlShiftZ 依此類推 -->
<xs:enumeration value="AltF1"/>
<!-- AltF2 ~ AltF12 依此類推 -->
<xs:enumeration value="AltUpArrow"/>
<xs:enumeration value="AltDownArrow"/>
<xs:enumeration value="AltLeftArrow"/>
<xs:enumeration value="AltRightArrow"/>
<xs:enumeration value="ShiftF1"/>
<!-- ShiftF2 ~ ShiftF12 依此類推 -->
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
</xs:schema>
(實務上 ShortCut 的列舉會把 F1~F12、Ctrl+字母、Ctrl+Shift+字母、Alt+功能鍵、方向鍵等組合全部列舉出來,這裡只列出代表性項目以免佔篇幅。)
有了 use="required",Name、AssemblyName、FormTag 三個屬性一旦漏寫,驗證階段就會直接報錯,而不是等到使用者點下去才發現開不了視窗。
有了 xs:enumeration,ShortCut 就不能隨便亂填。這一點比看起來重要:快捷鍵字串是要交給 MenuShortCut.GetShortCut() 解析的,拼錯一個字母只會在執行期靜默失效,很難查。用列舉把它擋在門外,等於把錯誤往前挪到了設定階段。
而 MenuItem 裡允許 ref="MenuItem" 自我遞迴,正是「任意層次模組」的語法基礎——schema 不限制你只能有兩層或三層,菜單有多深,結構就能有多深。
檔案準備好了,接下來就是寫 MenuLoad 類別:先用 XSD 驗證這份 XML,再把 MenuItem 節點遞迴轉成真正的菜單控制項、OutlookBar 圖示與工具列按鈕,最後透過 AssemblyName 以反射把對應表單開起來。這些都在下篇。