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 事件 此控制項沒有相關聯的事件;使用此泛型事件處理常式。

 

控制項類型及其支援的控制項模式

UI 自動化控制項模式概觀

UI 自動化樹狀目錄概觀