設計可設定樣式控制項的方針

本文摘要說明當設計要能夠容易設定樣式及範本化的控制項時，可考量的一組最佳做法。 我們在處理內建 WPF 控制項集的主題控制項樣式時，透過許多試驗和錯誤來到這組最佳做法。 我們了解到成功的樣式設定對設計良好的物件模型來說，不僅是樣式本身，也是一項功能。 本文件的適用對象是控制項作者，而不是樣式作者。

辭彙

「樣式設定和範本化」係指一套技術，可讓控制項作者將控制項的視覺方面交給控制項的樣式和範本去處理。 這套技術包括：

• 樣式 (包括屬性 setter、觸發程序及分鏡腳本)。

• 資源。

• 控制項範本。

• 資料範本。

如需樣式設定和範本化的簡介，請參閱樣式設定和範本化範例。

開始之前：了解您的控制項

在您開始研究這些方針之前，請務必先了解並定義您控制項的一般使用方式。 樣式設定所揭露的通常是一組難以駕馭的可能性。 撰寫來廣泛使用的控制項 (在許多應用程式中、供許多開發人員使用) 面臨挑戰，即樣式設定可用來對控制項的視覺外觀進行更深遠的變更。 事實上，已設定樣式的控制項甚至可能與控制項作者的意圖不符。 由於樣式設定所提供的彈性基本上是無限的，因此您可以使用一般使用方式的概念來協助限制您的決策範圍。

為了了解您控制項的一般使用方式，思考一下控制項的價值主張會相當有幫助。 您的控制項可為表格提供哪些任何其他控制所無法提供的效果？ 一般使用方式不包含任何特定的視覺外觀，而是包含控制項的原理，以及一組關於其使用方式的合理預期。 這項理解可讓您對一般情況下控制項的撰寫模型和已定義樣式的行為，進行一些假設。 ComboBox例如，瞭解常見的用法不會讓您瞭解特定 ComboBox 是否有圓角，但可讓您深入瞭解 ComboBox 可能需要快顯視窗和某種方式來切換它是否開啟。

一般準則

• 請勿強制執行範本合約。 控制項的範本合約成份可能包含元素、命令、繫結、觸發程序，或甚至是讓控制項正常運作所需或應有的屬性設定。

  • 將合約儘量縮減到最少。

  • 設計時需有心理準備，即在設計階段 (亦即在使用設計工具時) 控制項範本處於不完整狀態是正常的。 WPF 不提供「撰寫」狀態基礎結構，因此控制項必須建置，預期這類狀態可能有效。

  • 當有未遵守範本合約任何方面的情況時，請勿擲回例外狀況。 同樣地，面板在子系太多或太少時，也不應該擲回例外狀況。

• 將周邊功能列入為範本協助程式元素的考量因素。 每個控制項都應該將焦點放在其核心功能和實際的價值主張，並由控制項的一般使用方式定義。 為了達到該目的，請使用範本內的撰寫和協助程式元素來啟用周邊行為和視覺效果，也就是未包含在控制項核心功能內的那些行為和視覺效果。 協助程式元素分成三個分類：

  • 「獨立」協助程式是範本中公開且可重複使用的控制項，或是以「匿名方式」使用的基本型別，也就是說，協助程式元素和已設定樣式的控制項都不知道彼此。 就技術而言，任何元素都可以是匿名型別，但在此內容中，此詞彙所描述的是那些封裝特製化功能來實現目標案例的型別。

  • 「型別型」協助程式元素是封裝了特製化功能的新型別。 與一般控制項或基本型別相比，這些元素通常是設計為功能範圍較窄。 與獨立協助程式元素不同，型別型協助程式元素知道所處的使用內容，且通常必須與其所屬控制項範本的控制項共用資料。

  • 「具名」協助程式元素是控制項預期要在其範本內，依名稱找到的一般控制項或基本型別。 這些元素在範本內都有一個已知的名稱，使得控制項能夠透過程式設計方式找到元素並與其進行互動。 在任一範本中，只能有一個元素具有指定的名稱。

  下表說明現今控制項樣式所採用的協助程式元素 (本清單並不完全)：

  元素	類型	使用對象
  ContentPresenter	型別型	Button、 CheckBox 、 RadioButton 、、 Frame 等 （所有 ContentControl 類型）
  ItemsPresenter	型別型	ListBox、 ComboBox 、 Menu 、 等 （所有 ItemsControl 類型）
  ToolBarOverflowPanel	已命名	ToolBar
  Popup	獨立	ComboBox、 ToolBar 、 Menu 、、 ToolTip 等等
  RepeatButton	已命名	Slider、 ScrollBar 、 等等
  ScrollBar	已命名	ScrollViewer
  ScrollViewer	獨立	ListBox、 ComboBox 、 Menu 、、 Frame 等等
  TabPanel	獨立	TabControl
  TextBox	已命名	ComboBox
  TickBar	型別型	Slider

• 將在協助程式元素上所需的使用者指定繫結或屬性設定縮減到最少。 協助程式元素通常必須要有特定繫結或屬性設定，才能在控制項範本內正常運作。 協助程式元素和樣板化控制項應該儘可能建立這些設定。 設定屬性或建立繫結時，應該小心，不要覆寫使用者所設定的值。 特定的最佳做法如下：

  • 具名協助程式元素應該可由父代識別，而父代應該在該協助程式元素上建立任何必要的設定。

  • 型別型協助程式元素應該在本身直接建立任何必要的設定。 這麼做可能需要協助程式元素查詢所處的使用資訊內容，包括其 TemplatedParent (所處使用範本的控制項型別)。 例如，在衍生型別中使用 ContentControl 時， ContentPresenter 會自動將 它的 TemplatedParent 屬性系結 Content 至其 Content 屬性。

  • 您無法以此方式將獨立協助程式元素最佳化，因為根據定義，協助程式元素和父代都不知道彼此。

• 使用 Name 屬性在範本內標幟元素。 控制項如果需要在其樣式中尋找元素，以便透過程式設計方式存取該元素，應該使用 Name 屬性和 FindName 典型來執行此操作。 控制項不應該在找不到元素時擲回例外狀況，而是應該以無訊息且依正常程序的方式，停用需要該元素的功能。

• 使用可表達樣式中控制項狀態和行為的最佳做法。 以下是已排序的最佳做法清單，用來表達樣式中的控制項狀態變更和行為。 您應該使用清單上第一個可實現您案例的項目。

  1. 屬性繫結。 範例：和 ToggleButton.IsChecked 之間的 ComboBox.IsDropDownOpen 系結。

  2. 觸發的屬性變更或屬性動畫。 範例：的暫留狀態 Button 。

  3. 命令。 範例： LineUpCommand / LineDownCommand 在 中 ScrollBar 。

  4. 獨立協助程式元素。 範例： TabPanel 在 中 TabControl 。

  5. 型別型協助程式型別。 範例： ContentPresenter 在 中 Button ， TickBar 于 中 Slider 。

  6. 具名協助程式元素。 範例： TextBox 在 中 ComboBox 。

  7. 來自具名協助程式型別的反昇事件。 如果您接聽來自樣式元素的反昇事件，您應該要求必須能夠唯一識別產生該事件的元素。 範例： Thumb 在 中 ToolBar 。

  8. 自訂的 OnRender 行為。 範例： ButtonChrome 在 中 Button 。

• 儘量不要使用樣式觸發程序 (與範本觸發程序相反)。 針對會影響範本中元素上屬性的觸發程序，您必須在範本中進行宣告。 針對會影響控制項 (無 TargetName) 上屬性的觸發程序，除非您知道變更範本應該也會終結觸發程序，否則您可以在樣式中進行宣告。

• 與現有的樣式設定模式保持一致。 在很多時候，都有多種方式可以解決問題。 請注意，儘可能與現有的控制項樣式設定模式保持一致。 對於衍生自相同基底類型的控制項來說，這特別重要（例如、 ContentControlItemsControl 、 RangeBase 、 等等）。

• 公開屬性來啟用常見的自訂案例，而不重新範本化。 WPF 不支援插入式/可自訂的元件，因此控制項使用者只剩下兩種自訂方法：直接設定屬性或使用樣式設定屬性。 記住這一點之後，就可以公開以非常常見、高優先順序自訂案例為目標的數量有限屬性，否則這些案例將需要重新範本化。 以下是啟用自訂案例的時機和方式的最佳做法：

  • 非常常見的自訂應該以控制項上屬性的形式公開，並由範本取用。

  • 較不常見 (但並非罕見) 的自訂應該以附加屬性的形式公開，並由範本取用。

  • 針對已知但罕見的自訂，則可接受要求重新範本化。

佈景主題考量

• 佈景主題樣式應該嘗試在所有佈景主題都具有一致的屬性語意，但不保證能做到。 作為其記載的一部分，您的控制項應該要有一份文件，其中描述控制項的屬性語意，也就是控制項屬性的「意義」。 例如， ComboBox 控制項應該在 中 ComboBox 定義 屬性的意義 Background 。 您控制項的預設樣式應該嘗試在所有佈景主題都遵守該文件中定義的語意。 另一方面，控制項使用者則應該注意屬性語意可能會因佈景主題不同而改變。 在某些情況下，在特定佈景主題所需的視覺條件約束下，可能會無法表達指定的屬性。 (例如，「傳統」佈景主題並沒有可針對許多控制項套用 Thickness 的單一框線)。

• 佈景主題樣式不需要在所有佈景主題都具有一致的觸發程序語意。 控制項樣式透過觸發程序或動畫公開的行為可能會因佈景主題不同而不同。 控制項使用者應該注意，控制項未必會採用相同的機制在所有佈景主題達到特定的行為。 例如，可能有一個佈景主題使用動畫來表達暫留行為，而另一個佈景主題則使用觸發程序。 這會導致在保留自訂控制項上的行為時不一致。 （例如，變更背景屬性，如果該狀態是使用觸發程式表示，則可能不會影響控制項的暫留狀態。不過，如果使用動畫實作暫留狀態，變更為背景可能會無法復原地中斷動畫，因此狀態轉換。

• 佈景主題樣式不需要在所有佈景主題都具有一致的「版面配置」語意。 例如，預設樣式不需要保證控制項在所有佈景主題中都佔據相同的大小，或是保證控制項在所有佈景主題中都具有相同的內容邊界/邊框間距。

另請參閱

• 設定樣式和範本
• 控制項撰寫概觀