影像控制項類型
本主題提供影像控制項類型的 Microsoft 消費者介面自動化支援相關資訊。
做為圖示、參考圖形和圖表使用的影像控制項將支援 影像 控制項類型。 做為背景或浮水印影像的控制項不支援 影像 控制項類型。
下列各節會定義影像控制項類型所需的消費者介面自動化樹狀結構、屬性、控制項模式和事件。 消費者介面自動化需求適用于 UI 架構/平臺整合消費者介面自動化控制項類型和控制項模式支援的所有影像控制項。
本主題包含下列各節。
一般樹狀結構
下表描述與影像控制項相關的消費者介面自動化樹狀結構的典型控制項和內容檢視，並描述每個檢視中可包含的內容。 如需 UI 自動化樹狀結構的詳細資訊，請參閱 UI 自動化樹狀結構概觀。
| 控制項檢視 | 內容檢視 |
|---|---|
| 映像 | 影像 (根據 Automation Element Property Identifiers 屬性的值，根據影像是否包含資訊) |
相關屬性
下表列出消費者介面自動化屬性，其值或定義與影像控制項特別相關。 如需消費者介面自動化屬性的詳細資訊，請參閱從 消費者介面自動化 Elements 擷取屬性。
| 使用者介面自動化屬性 | 值 | 注意 |
|---|---|---|
| UIA_AutomationIdPropertyId | 請參閱備註。 | 此屬性的值在消費者介面自動化樹狀結構的原始檢視中，所有對等專案都必須是唯一的。 |
| UIA_BoundingRectanglePropertyId | 請參閱備註。 | 包含整個控制項的最外層矩形。 |
| UIA_ClickablePointPropertyId | 請參閱備註。 | 影像控制項的可點選點必須是影像控制項周框內的點。 |
| UIA_ControlTypePropertyId | 映像 | |
| UIA_HelpTextPropertyId | 請參閱備註。 | HelpText屬性會公開當地語系化字串，描述控制項的實際視覺外觀，或其他與影像相關聯的工具提示資訊。 如果需要較長的描述，才能傳達影像控制項的詳細資訊 (，例如，如果影像是複雜的圖表或圖表) ，則必須支援此屬性。 此屬性對應至 HTML LongDesc 標籤和可調整向量圖形 (SVG) Desc 標籤。 使用影像控制項的開發人員必須支援屬性來允許在控制項設定視覺描述。 此屬性必須對應至 消費者介面自動化VisualDescription屬性。 |
| UIA_IsContentElementPropertyId | 請參閱備註。 | 如果影像控制項包含尚未公開給使用者的有意義資訊，則必須包含在 UI 自動化樹狀結構的內容檢視。 |
| UIA_IsControlElementPropertyId | true | 此影像控制項一律包含在 UI 自動化樹狀結構的控制項檢視中。 |
| UIA_IsKeyboardFocusablePropertyId | 請參閱備註。 | 如果控制項可接收鍵盤焦點，就必定支援此屬性。 |
| UIA_ItemStatusPropertyId | 請參閱備註。 | 如果影像控制項是用來表示螢幕上特定項目的狀態資訊，則該控制項應包含在項目內。 當影像包含在專案內時，專案必須支援 status 屬性，並在狀態變更時引發適當的通知。 若影像為單獨控制項並傳達狀態資訊，則必須支援此屬性。 |
| UIA_LabeledByPropertyId | 請參閱備註。 | 如果有靜態文字標籤，此屬性必須公開該控制項的參考。 |
| UIA_LocalizedControlTypePropertyId | 請參閱備註。 | 對應至 Image 控制項類型的當地語系化字串。 en-US 或英文 (美國) 的預設值為 「image」。 |
| UIA_NamePropertyId | 請參閱備註。 | 所有包含資訊的影像控制項都必須公開 Name 屬性。 以程式設計方式存取此資訊時，必須提供相當於該圖形的文字。 If the image control is purely decorative, it must only show up in the control view of the UI Automation tree and is not required to have a name (see Remarks). 使用者介面架構必須支援 ALT 或影像的替代文字屬性，其可由架構內設定。 此屬性接著會對應至 UI 自動化名稱屬性。 |
必要的控制項模式
下表列出影像控制項所需的消費者介面自動化控制項模式。 如需控制項模式的詳細資訊，請參閱 UI Automation Control Patterns Overview。
| 控制項模式 | 支援 | 備註 |
|---|---|---|
| IGridItemProvider | 相依 | 如果控制項位於方格容器內，則影像控制項支援 GridItem 控制項模式。 |
| IInvokeProvider | 永不 | 如果影像控制項是可點選的物件，控制項應該支援支援 叫 用控制項模式的控制項類型，例如 Button 控制項類型。 對於包含多個可點選物件的影像物件， (Image 控制項類型) 可能會裝載子連結， (超連結控制項類型) 消費者介面自動化樹狀結構中。 |
| ISelectionItemProvider | 永不 | 影像控制項不應支援 SelectionItem 控制項模式。 如果影像是可選取的容器的一部分，例如具有影像圖示做為內容的按鈕，該容器支援模式，而不是內的影像。 |
| ITableItemProvider | 相依 | 如果控制項位於具有標頭控制項的容器內，則影像控制項支援 TableItem 控制項模式。 |
必要的事件
下表列出影像控制項支援所需的消費者介面自動化事件。 如需 UI Automation Events Overview事件的詳細資訊，請參閱
| UI 自動化事件 | 備註 |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId 屬性變更事件。 | |
| UIA_IsEnabledPropertyId 屬性變更事件。 | 如果控制項支援 IsEnabled 屬性，它必須支援這個事件。 |
| UIA_IsOffscreenPropertyId 屬性變更事件。 | 如果控制項支援 IsOffscreen 屬性，它必須支援此事件。 |
| UIA_ItemStatusPropertyId 屬性變更的事件。 | 如果控制項支援 ItemStatus 屬性，它必須支援這個事件。 |
| UIA_NamePropertyId 屬性變更事件。 | |
| UIA_StructureChangedEventId |
備註
World Wide Web Consortium (W3C) 會將裝飾性影像定義為不會將資訊新增至頁面內容。 如需詳細資訊，請參閱 裝飾影像的 W3C 主題。
關於消費者介面自動化：
- 如果影像純裝飾性、不是互動式的，而且不會傳達任何資訊，則影像：
- 可能或可能不在 UIA 樹狀結構中
- 可能或可能不在 UIA 原始檢視中
- 不得位於 UIA 控制項檢視中
- 不得在內容檢視中
- 可能或可能沒有名稱
- 如果影像傳達資訊，但有清楚關聯的文字會提供相同的資訊 (，例如包含左指三角形圖形的播放按鈕，以及文字「播放」) ，影像會被視為裝飾性與影像：
- 必須位於原始檢視中
- 必須位於控制項檢視中
- 不得在內容檢視中
- Name 屬性中可能或可能沒有值
- 同時傳達影像意義的文字必須位於內容檢視中
- 如果影像具有資訊，並傳達任何相關聯文字未提供的詳細資料，則影像：
- 必須位於原始檢視中
- 必須位於控制項檢視中
- 必須位於內容檢視中
- 必須具有描述影像及其意義的名稱值