SemanticZoom 控制件類型
本主題提供 SemanticZoom 控件類型的 UI 自動化支援相關信息。
語意式縮放是在 Windows 8 中引進的技術，用於呈現和瀏覽單一檢視內的大型相關數據或內容集，例如相簿、應用程式清單或通訊簿。 語意式縮放使用兩種不同的分類模式，或 縮放層級，來組織和呈現內容。 低階（或 放大）模式會顯示平面「全能」結構中的專案：而高階（或 縮小）模式會顯示群組中的專案，讓用戶能夠快速瀏覽和瀏覽內容。 例如，縮放城市清單可能會變更為包含這些城市的狀態清單。 縮放程式清單可能會變更為邏輯程式群組的清單。
如需特別用於 Windows 市集應用程式之語意式縮放的詳細資訊，請參閱語意式縮放 的指導方針。
SemanticZoom 控件類型的使用模型不尋常，因為它主要是為了以程式設計方式存取。 Microsoft使用者介面自動化用戶端可以監視及作語意式縮放控件，以控制清單的縮放狀態。 未使用輔助技術的使用者通常會透過觸控手勢或鍵盤快捷方式直接作語意縮放控件。
下列各節會定義 SemanticZoom 控件類型所需的 UI 自動化樹狀結構、屬性、控件模式和事件。 使用者介面自動化需求適用於所有語意式縮放控件，其中 UI 架構/平臺會整合控件類型和控件模式的 UI 自動化支援。
本主題包含下列各節。
一般樹狀結構
下表描述與 SemanticZoom 控件類型相關的 UI 自動化樹狀結構一般控件和內容檢視，並描述每個檢視中可包含的內容。 如需 UI 自動化樹狀結構的詳細資訊，請參閱 UI 自動化樹狀結構概觀。
| 控件檢視 | 內容檢視 |
|---|---|
|
|
或：
| 控件檢視 | 內容檢視 |
|---|---|
|
|
相關屬性
下表列出UI自動化屬性，其值或定義與實作 SemanticZoom 控件類型的控件特別相關。 如需 UI 自動化屬性的詳細資訊，請參閱 從 UI 自動化元素擷取屬性。
| UI 自動化屬性 | 價值 | 筆記 |
|---|---|---|
| UIA_AutomationIdPropertyId | 請參閱附注。 | 在UI自動化樹狀結構的原始檢視中，此屬性的值在所有對等專案之間必須是唯一的。 |
| UIA_BoundingRectanglePropertyId | 請參閱附注。 | 包含整個控件的最外框。 |
| UIA_ClickablePointPropertyId | 請參閱附注。 | 如果清單控制項具有可點選的點（可以按兩下以讓清單取得焦點的點），則必須透過這個屬性公開該點。 如果 UIA_IsOffscreenPropertyId 屬性值 TRUE，則嘗試擷取此屬性會導致 UIA_E_NOCLICKABLEPOINT 錯誤。 |
| UIA_ControlTypePropertyId | SemanticZoom | |
| UIA_IsContentElementPropertyId | 真 | |
| UIA_IsControlElementPropertyId | 真 | |
| UIA_IsKeyboardFocusablePropertyId | 假 | |
| UIA_LabeledByPropertyId | 請參閱附注。 | 如果有靜態文字標籤，這個屬性必須公開該控件的參考。 |
| UIA_LocalizedControlTypePropertyId | 請參閱附注。 | 對應至 SemanticZoom 控件類型的當地語系化字串。 默認值為 en-US 或英文（美國）的「語意式縮放」。
注意： 某些架構串連為 “semanticzoom”。 |
| UIA_NamePropertyId | 請參閱附注。 | 可以接受空字串，或提供更有用的名稱，只要它不包含語意式縮放一詞，這會使控件類型和名稱的組合混淆。 |
必要的控制件模式和屬性
下表列出所有語意式縮放控件必須支援的UI自動化控制模式。 如需控制樣式的詳細資訊，請參閱 UI 自動化控制樣式概觀。
| 控制件模式/模式屬性 | 支援/值 | 筆記 |
|---|---|---|
| IToggleProvider | 取決於 | 語意式縮放控件支援 切換 控件模式，以允許啟用或停用縮放。 ToggleState_Off 對應至平面、全向上狀態，而 ToggleState_On 對應至高階縮小檢視。 |
必要事件
下表列出語意式縮放控件需要支援的UI自動化事件。 如需事件的詳細資訊，請參閱 UI 自動化事件概觀。
| UI 自動化事件 | 筆記 |
|---|---|
| UIA_BoundingRectanglePropertyId 屬性變更事件。 | |
| UIA_IsEnabledPropertyId 屬性變更事件。 | 如果控件支援 IsEnabled 屬性，則必須支援這個事件。 |
| UIA_IsOffscreenPropertyId 屬性變更事件。 | 如果控件支援 IsOffscreen 屬性，它就必須支援這個事件。 |
| UIA_ToggleToggleStatePropertyId 屬性變更事件。 |
言論
如果UI具有可切換語意縮放控件行為的可見按鈕，則此按鈕不應該有 SemanticZoom 控件類型。 這是反直覺式的，但 SemanticZoom 控件類型會描述縮放內容的容器，而不是控制縮放的按鈕。 （這類按鈕可以直接表示為具有 Toggle 控件模式的 Button 控件類型。