工具提示控制項類型

  • 發行項

本主題提供工具提示控制項類型的 Microsoft 消費者介面自動化支援相關資訊。 工具提示控制項是包含文字的快顯視窗。

下列各節會定義工具提示控制項類型所需的樹狀結構、屬性、控制項模式和事件消費者介面自動化。 消費者介面自動化需求適用于 UI 架構/平臺整合消費者介面自動化控制項類型和控制項模式支援的所有工具提示控制項。

本主題包含下列各節。

一般樹狀結構

下表描述與工具提示控制項相關的消費者介面自動化樹狀結構的典型控制項和內容檢視，並描述每個檢視中可包含的內容。 如需 UI 自動化樹狀結構的詳細資訊，請參閱 UI 自動化樹狀結構概觀。

控制項檢視 內容檢視
  • ToolTip
    • 文字 (0 個以上)
    • 影像 (0 個以上)
  • ToolTip

 

工具提示控制項只有在可以接收鍵盤焦點時，才會出現在消費者介面自動化樹的內容檢視中。 否則，工具提示的所有資訊都可從工具提示所參考的元素上的 IUIAutomationElement：：CurrentHelpText (或 CachedHelpText) 屬性取得。

工具提示應該出現在其資訊所參考的控制項下方。 用戶端必須接聽 UIA_ToolTipOpenedEventId ，以確保它們一致地取得工具提示中包含的資訊。

相關屬性

下表列出與工具提示控制項類型特別相關的消費者介面自動化屬性。 如需消費者介面自動化屬性的詳細資訊，請參閱從 消費者介面自動化 Elements 擷取屬性。

使用者介面自動化屬性 值 注意
UIA_AutomationIdPropertyId 請參閱備註。 此屬性的值在消費者介面自動化樹狀結構的原始檢視中，所有對等專案都必須是唯一的。
UIA_BoundingRectanglePropertyId 請參閱備註。 包含整個控制項的最外層矩形。
UIA_ClickablePointPropertyId 請參閱備註。 可點選點應該是關閉控制項之工具提示的一部分。 某些工具提示沒有這項功能，而且沒有可點選的點。
UIA_ControlTypePropertyId ToolTip
UIA_IsContentElementPropertyId 相依 如果工具提示控制項可以接收鍵盤焦點，它必須出現在樹狀結構的內容檢視中。 如果只有文字，則會從引發它的控制項，以 IUIAutomationElement：：CurrentHelpText (或 CachedHelpText) 屬性的形式提供。
UIA_IsControlElementPropertyId 是 工具提示控制項一律包含在消費者介面自動化樹狀結構的控制項檢視中。
UIA_IsKeyboardFocusablePropertyId 請參閱備註。 如果控制項可接收鍵盤焦點，就必定支援此屬性。
UIA_LabeledByPropertyId NULL 工具提示控制項一律會由其內容自我標記。
UIA_LocalizedControlTypePropertyId 請參閱備註。 對應到工具提示控制項類型的當地語系化字串。 en-US 或英文 (美國) 的預設值為 「tooltip」。
UIA_NamePropertyId 請參閱備註。 工具提示控制項的名稱是工具提示中顯示的文字。

 

必要的控制項模式

下表列出工具提示控制項必須支援的消費者介面自動化控制項模式。 如需控制項模式的詳細資訊，請參閱 UI Automation Control Patterns Overview。

控制項模式 支援 備註
ITextProvider 相依 為了取得更好的協助工具，工具提示控制項可以支援 文字 控制項模式，但並非必要。 當文字有豐富的樣式和屬性 (例如色彩、粗體和斜體) 時，這種文字控制項模式相當有用。
IWindowProvider 相依 按一下 UI 專案可以關閉的工具提示必須支援 視窗 控制項模式，以便自動關閉。

 

必要的事件

工具提示控制項在畫面上出現時，必須引發 UIA_ToolTipOpenedEventId 事件。 事件將包含工具提示本身消費者介面自動化專案的參考。

下表列出支援工具提示控制項所需的消費者介面自動化事件。 如需 UI Automation Events Overview事件的詳細資訊，請參閱

UI 自動化事件 備註
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId 屬性變更事件。
UIA_IsEnabledPropertyId 屬性變更事件。 如果控制項支援 IsEnabled 屬性，它必須支援這個事件。
UIA_IsOffscreenPropertyId 屬性變更事件。 如果控制項支援 IsOffscreen 屬性，它必須支援此事件。
UIA_NamePropertyId 屬性變更事件。
UIA_Text_TextChangedEventId 如果控制項支援 文字 控制項模式，它必須支援這個事件。
UIA_ToolTipClosedEventId
UIA_ToolTipOpenedEventId
UIA_StructureChangedEventId
UIA_Window_WindowClosedEventId 如果控制項支援 Window 控制項模式，它必須支援這個事件。
UIA_Window_WindowOpenedEventId 如果控制項支援 Window 控制項模式，它必須支援這個事件。
UIA_WindowWindowVisualStatePropertyId 屬性變更事件。 如果控制項支援 Window 控制項模式，它必須支援這個事件。

 

概念

UI 自動化控制項類型概觀

UI 自動化概觀