影像控制件類型
本主題提供 映像 控件類型的Microsoft使用者介面自動化支持相關信息。
做為圖示、信息圖形和圖表的影像控件將支援 影像 控件類型。 做為背景或浮浮浮水印影像的控件不支援 影像 控件類型。
下列各節會定義 映射 控件類型所需的 UI 自動化樹狀結構、屬性、控制項模式和事件。 使用者介面自動化需求適用於所有影像控件，其中UI架構/平臺會整合控件類型和控件模式的UI自動化支援。
本主題包含下列各節。
一般樹狀結構
下表描述與影像控件相關的UI自動化樹狀結構一般控件和內容檢視，並描述每個檢視中可包含的內容。 如需 UI 自動化樹狀結構的詳細資訊，請參閱 UI 自動化樹狀結構概觀。
| 控件檢視 | 內容檢視 |
|---|---|
| 圖像 | 影像 （視影像是否包含資訊而定，根據 Automation 元素屬性識別碼 屬性的值） |
相關屬性
下表列出UI自動化屬性，其值或定義與影像控件特別相關。 如需 UI 自動化屬性的詳細資訊，請參閱 從 UI 自動化元素擷取屬性。
| UI 自動化屬性 | 價值 | 筆記 |
|---|---|---|
| UIA_AutomationIdPropertyId | 請參閱附注。 | 在UI自動化樹狀結構的原始檢視中，此屬性的值在所有對等專案之間必須是唯一的。 |
| UIA_BoundingRectanglePropertyId | 請參閱附注。 | 包含整個控件的最外框。 |
| UIA_ClickablePointPropertyId | 請參閱附注。 | 影像控件的可點選點必須是影像控件周框內的點。 |
| UIA_ControlTypePropertyId | 映像 | |
| UIA_HelpTextPropertyId | 請參閱附注。 | HelpText 屬性會公開當地語系化字串，描述控件的實際視覺外觀，或其他與影像相關聯的工具提示資訊。 需要較長的描述才能傳達影像控件的詳細資訊時，必須支援這個屬性（例如，如果影像是複雜的圖表或圖表）。 此屬性會對應至 HTML LongDesc 標籤和可調整向量圖形 （SVG） Desc 標記。 使用影像控制件的開發人員必須支援 屬性，才能在控件上設定視覺描述。 此屬性必須對應至 VISUALDescription 屬性的 UI 自動化。 |
| UIA_IsContentElementPropertyId | 請參閱附注。 | 當影像控制項包含尚未公開給使用者有意義的資訊時，必須包含在使用者介面自動化樹狀結構的內容檢視中。 |
| UIA_IsControlElementPropertyId | 真 | 影像控件一律包含在UI自動化樹狀結構的控件檢視中。 |
| UIA_IsKeyboardFocusablePropertyId | 請參閱附注。 | 如果控件可以接收鍵盤焦點，它必須支援這個屬性。 |
| UIA_ItemStatusPropertyId | 請參閱附注。 | 如果影像控制項代表螢幕上特定項目的狀態資訊，控制項應該包含在專案內。 當影像包含在專案內時，項目必須支援 status 屬性，並在狀態變更時引發適當的通知。 如果影像是獨立控件，且正在傳遞狀態，則必須支援此屬性。 |
| UIA_LabeledByPropertyId | 請參閱附注。 | 如果有靜態文字標籤，這個屬性必須公開該控件的參考。 |
| UIA_LocalizedControlTypePropertyId | 請參閱附注。 | 對應至 Image 控制件類型的當地語系化字串。 默認值為 en-US 或英文 （美國） 的 「image」。。 |
| UIA_NamePropertyId | 請參閱附注。 | 所有包含資訊的影像控件都必須公開 Name 屬性。 以程式設計方式存取這項資訊時，必須提供相當於圖形的文字。 如果影像控件純粹是裝飾性的，它只能顯示在UI自動化樹狀結構的控件檢視中，而且不需要有名稱（請參閱 備註）。 UI 架構必須支援可從其架構內設定之影像上的 ALT 或替代文字屬性。 此屬性接著會對應至UI自動化名稱屬性。 |
必要的控制件模式
下表列出影像控制項需要支援的UI自動化控制件模式。 如需控制樣式的詳細資訊，請參閱 UI 自動化控制樣式概觀。
| 控制件模式 | 支援 | 筆記 |
|---|---|---|
| IGridItemProvider | 取決於 | 如果控件位於方格容器內，影像控件支援 GridItem 控件模式。 |
| IInvokeProvider | 從不 | 如果影像控制項是可點選的物件，控件應該支援支援 Invoke 控件模式的控件類型，例如 Button 控件類型。 對於包含多個可點選物件的影像物件，元素（影像控件類型）可能會裝載 UI 自動化樹狀結構中的子連結（Hyperlink 控件類型）。 |
| ISelectionItemProvider | 從不 | 影像控件不應該支援 SelectionItem 控件模式。 如果影像是可選取的容器的一部分，例如具有影像圖示為內容的按鈕，該容器支援模式，而不是內的映像。 |
| ITableItemProvider | 取決於 | 如果控件位於具有標頭控件的容器內，影像控件支援 TableItem 控件模式。 |
必要事件
下表列出影像控制項需要支援的UI自動化事件。 如需事件的詳細資訊，請參閱 UI 自動化事件概觀。
| UI 自動化事件 | 筆記 |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId 屬性變更事件。 | |
| UIA_IsEnabledPropertyId 屬性變更事件。 | 如果控件支援 IsEnabled 屬性，則必須支援這個事件。 |
| UIA_IsOffscreenPropertyId 屬性變更事件。 | 如果控件支援 IsOffscreen 屬性，它就必須支援這個事件。 |
| UIA_ItemStatusPropertyId 屬性變更事件。 | 如果控件支援 ItemStatus 屬性，它就必須支持這個事件。 |
| UIA_NamePropertyId 屬性變更事件。 | |
| UIA_StructureChangedEventId |
言論
萬維網聯合會 （W3C） 會將裝飾性影像定義為不會將資訊新增至頁面內容的影像。 如需詳細資訊，請參閱 裝飾影像的 W3C 主題。
關於 UI 自動化：
- 如果影像純粹是裝飾的，不是互動式的，而且不會傳達任何資訊，則影像：
- 可能或可能不在UIA樹狀結構中
- 可能或可能不在 UIA 原始檢視中
- 不得在 UIA 控制件檢視中
- 不得在內容檢視中
- 可能或可能沒有名稱
- 如果影像傳達資訊，但有清楚相關的文字提供相同的資訊（例如包含左指三角形圖形以及文字「播放」的播放按鈕），則影像會被視為裝飾和影像：
- 必須位於原始檢視中
- 必須位於控件檢視中
- 不得在內容檢視中
- Name 屬性中可能或可能沒有值
- 同時傳達影像意義的文字必須位於內容檢視中
- 如果影像具有資訊，並傳達任何相關聯文字未提供的詳細數據，則影像：
- 必須位於原始檢視中
- 必須位於控件檢視中
- 必須位於內容檢視中
- 必須具有描述影像及其意義的名稱值