共用方式為


視窗控制件模式

說明實作 IWindowProvider的指導方針和慣例,包括屬性、方法和事件的相關信息。 視窗 控件模式支援在傳統 GUI 內提供基本視窗式功能的控制件。

必須實作此控件模式的控件範例包括最上層應用程式視窗、多文檔介面 (MDI) 子視窗、可重設大小的分割窗格控制件、強制回應對話框和氣球說明視窗。 如需實作此控制項模式的控制項範例,請參閱 UI 自動化用戶端的控制項模式對應

本主題包含下列各節。

實作指導方針和慣例

實作 視窗 控制項模式時,請注意下列指導方針和慣例:

  • 若要支援使用 Microsoft UI 自動化來修改視窗大小和螢幕位置的能力,除了 IWindowProvider之外,控件還必須實作 ITransformProvider
  • 包含標題列的控件,以及可讓控件移動、重設大小、最大化、最小化或關閉的控件,通常需要實作 IWindowProvider
  • 工具提示快顯和下拉式方塊或功能表下拉選單等控制項通常不會實作 IWindowProvider
  • 氣球說明視窗會透過布建類似視窗 關閉 按鈕,來區別於基本工具提示彈出視窗。
  • IWindowProvider 不支援全螢幕模式,因為它是應用程式特有的功能,而不是典型的窗口行為。

IWindowProvider 的必要成員

實作 IWindowProvider 介面需要下列屬性、方法和事件。

必要成員 成員類型 筆記
WindowInteractionState 財產 不保證 WindowInteractionState_ReadyForUserInteraction
IsModal 財產 沒有
IsTopmost 財產 沒有
CanMaximize 財產 沒有
CanMinimize 財產 沒有
WindowVisualState 財產 沒有
關閉 方法 沒有
SetVisualState 方法 沒有
WaitForInputIdle 方法 沒有
UIA_Window_WindowClosedEventId 事件 沒有
UIA_Window_WindowOpenedEventId 事件 沒有

 

概念

UI 自動化控制項模式概觀

UI 自動化用戶端的控制模式對應

UI 自動化樹狀結構概觀