ExpandCollapse 控制項模式
描述實作 IExpandCollapseProvider的指導方針和慣例，包括屬性、方法和事件的相關資訊。 ExpandCollapse控制項模式可用來支援以視覺化方式展開以顯示更多內容的控制項，並折迭以隱藏內容。
如需實作此控制項模式的控制項範例，請參閱 控制項類型及其支援的控制項模式。
本主題包含下列各節。
實作方針和慣例
實作 ExpandCollapse 控制項模式時，請注意下列指導方針和慣例：
使用提供展開/折迭功能的 UI 所建置的匯總控制項必須支援 ExpandCollapse 控制項模式，而其子項目則不支援。 例如，下拉式方塊控制項是使用清單方塊、按鈕和編輯控制項的組合所建置，但它只是必須支援 ExpandCollapse 控制項模式的父下拉式方塊。
注意
例外狀況是功能表控制項，這是個別功能表項目物件的匯總。 功能表項目物件可以支援 ExpandCollapse 控制項模式，但父功能表控制項無法支援。 類似的例外狀況適用于樹狀結構和樹狀目錄專案控制項。
當控制項的 IExpandCollapseProvider：：ExpandCollapseState 設定為 ExpandCollapseState_LeafNode時，控制項的任何 ExpandCollapse 功能目前為非作用中，而且可以使用這個控制項模式取得的唯一資訊是 ExpandCollapseState。 如果後續新增任何子物件， 則 ExpandCollapseState 會變更並啟動 ExpandCollapse 功能。
ExpandCollapseState 僅是指立即子物件的可見度;它不會參考所有子代物件的可見度。
IExpandCollapseProvider：：Expand and Collapse 功能是控制項特定的。 以下是此行為的範例：
- Office 個人功能表可以是三種狀態功能表項目， (「Expand」、「Collapsed」 和 「PartiallyExpanded」) 其中控制項指定要在呼叫 Expand 或 Collapse 時採用的狀態。
- 在樹狀結構專案上呼叫 Expand 可能會顯示所有子代或只顯示立即子系。
- 如果在控制項上呼叫 Expand 或 Collapse 會維護其子系的狀態，則應該傳送可見度變更事件，而不是狀態變更事件。 如果父控制項在折迭時不會維護其子系的狀態，控制項可能會終結不再顯示的所有子代，並引發終結的事件;或者，它可能會變更每個子代的 ExpandCollapseState ，並引發可見度變更事件。
為了保證流覽，不論其父代ExpandCollapseState為何，物件都位於 Microsoft 消費者介面自動化 樹狀結構 (，且其可見度狀態) 。 如果子系是隨選產生，則其只有在第一次顯示或可見時，才會出現在 UI 自動化樹狀結構中。
IExpandCollapseProvider的必要成員
實作 IExpandCollapseProvider 介面時，需要下列屬性、方法和事件。
| 必要成員 | 成員類型 | 備註 |
|---|---|---|
| ExpandCollapseState | 屬性 | 無 |
| 展開 | 方法 | 無 |
| 摺疊 | 方法 | 無 |
| IUIAutomationPropertyChangedEventHandler | 事件 | 此控制項沒有相關聯的事件;使用此泛型事件處理常式。 |
相關主題