Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika dla SemanticZoom typu kontrolki.
Semantic Zoom to technika wprowadzona w systemie Windows 8 do prezentowania i nawigowania po dużych zestawach powiązanych danych lub zawartości w jednym widoku, takich jak album fotograficzny, lista aplikacji lub książka adresowa. Semantyczny zoom używa dwóch odrębnych trybów klasyfikacji lub poziomów powiększeniado organizowania i prezentowania zawartości. Tryb niskiego poziomu (lub powiększany w) wyświetla elementy w płaskiej strukturze "all-up"; i ogólny (lub pomniejszony) tryb wyświetla elementy w grupach, umożliwiając użytkownikowi szybkie nawigowanie i przeglądanie zawartości. Na przykład powiększanie listy miast może zmienić się na listę stanów zawierających te miasta. Powiększenie listy programów może ulec zmianie na listę grup programów logicznych.
Aby uzyskać więcej informacji na temat semantycznego powiększania specjalnie używanego dla aplikacji ze Sklepu Windows, zobacz Guidelines for Semantic Zoom.
Model użycia SemanticZoom typu kontrolki jest nietypowy, ponieważ istnieje głównie w przypadku dostępu programowego. Klienci usługi Microsoft UI Automation mogą monitorować kontrolkę Semantic Zoom i manipulować nią, aby kontrolować stan powiększenia listy. Użytkownicy, którzy nie korzystają z technologii pomocniczej, zwykle manipulują kontrolką Semantic Zoom bezpośrednio za pomocą gestów dotykowych lub skrótów klawiaturowych.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla semanticZoom typu kontrolki. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek Semantic Zoom, w których platforma/platforma interfejsu użytkownika integruje obsługę automatyzacji interfejsu użytkownika dla typów kontrolek i wzorców kontrolek.
Ten temat zawiera następujące sekcje.
- typowa struktura drzewa
- odpowiednie właściwości
- wymagane wzorce kontrolek i właściwości
- wymagane zdarzenia
- uwagi
- Tematy pokrewne
Typowa struktura drzewa
W poniższej tabeli przedstawiono typowy widok kontrolki i zawartości drzewa automatyzacji interfejsu użytkownika odnoszącego się do semanticZo om typu kontrolki i opisano, co można zawierać w każdym widoku. Aby uzyskać więcej informacji na temat drzewa automatyzacji interfejsu użytkownika, zobacz Omówienie drzewa automatyzacji interfejsu użytkownika.
| Widok kontrolki | Widok zawartości |
|---|---|
|
|
Lub:
| Widok kontrolki | Widok zawartości |
|---|---|
|
|
Odpowiednie właściwości
W poniższej tabeli wymieniono właściwości automatyzacji interfejsu użytkownika, których wartość lub definicja jest szczególnie istotna dla kontrolek implementujących semanticZoom typu kontrolki. Aby uzyskać więcej informacji na temat właściwości automatyzacji interfejsu użytkownika, zobacz Pobieranie właściwości z elementów automatyzacji interfejsu użytkownika.
| Właściwość automatyzacji interfejsu użytkownika | Wartość | Notatki |
|---|---|---|
| UIA_AutomationIdPropertyId | Zobacz uwagi. | Wartość tej właściwości musi być unikatowa wśród wszystkich elementów równorzędnych w nieprzetworzonym widoku drzewa automatyzacji interfejsu użytkownika. |
| UIA_BoundingRectanglePropertyId | Zobacz uwagi. | Najbardziej oddalony prostokąt, który zawiera całą kontrolkę. |
| UIA_ClickablePointPropertyId | Zobacz uwagi. | Jeśli kontrolka listy ma punkt możliwy do kliknięcia (punkt, który można kliknąć, aby spowodować skupienie listy), ten punkt musi być uwidoczniony za pośrednictwem tej właściwości. Jeśli wartość właściwości UIA_IsOffscreenPropertyId jest true, próba pobrania tej właściwości spowoduje błąd UIA_E_NOCLICKABLEPOINT. |
| UIA_ControlTypePropertyId | semanticZoom | |
| UIA_IsContentElementPropertyId | PRAWDZIWY | |
| UIA_IsControlElementPropertyId | PRAWDZIWY | |
| UIA_IsKeyboardFocusablePropertyId | FAŁSZYWY | |
| UIA_LabeledByPropertyId | Zobacz uwagi. | Jeśli istnieje statyczna etykieta tekstowa, ta właściwość musi uwidocznić odwołanie do tej kontrolki. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki SemanticZoom. Wartość domyślna to "powiększenie semantyczne" dla en-US lub angielskiego (Stany Zjednoczone).
Uwaga: Niektóre struktury połączyły to jako "semanticzoom". |
| UIA_NamePropertyId | Zobacz uwagi. | Pusty ciąg jest akceptowalny lub można podać bardziej przydatną nazwę, o ile nie zawiera terminu semantyczne powiększenie , co spowodowałoby mylące połączenie typu kontrolki i nazwy. |
Wymagane wzorce i właściwości kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi wszystkich kontrolek Semantic Zoom. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.
| Wzorzec/wzorzec kontrolki, właściwość | Pomoc techniczna/wartość | Notatki |
|---|---|---|
| IToggleProvider | Zależy | Kontrolki Semantic Zoom obsługują wzorzec sterowania przełącznika, aby umożliwić włączenie lub wyłączenie powiększania. ToggleState_Off odpowiada płaskiemu, wszystkiemu stanowi i ToggleState_On odpowiada widokowi wysokiego, pomniejszonego widoku. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi kontrolek Semantic Zoom. Aby uzyskać więcej informacji na temat zdarzeń, zobacz Omówienie zdarzeń automatyzacji interfejsu użytkownika.
| Zdarzenie automatyzacji interfejsu użytkownika | Notatki |
|---|---|
| UIA_BoundingRectanglePropertyId zdarzenie zmienione właściwości. | |
| UIA_IsEnabledPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsEnabled, musi obsługiwać to zdarzenie. |
| UIA_IsOffscreenPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsOffscreen, musi obsługiwać to zdarzenie. |
| UIA_ToggleToggleStatePropertyId zdarzenie zmienione właściwości. |
Uwagi
Jeśli interfejs użytkownika ma widoczny przycisk przełączania zachowania kontrolki Semantic Zoom, ten przycisk nie powinien mieć semanticZoom typu kontrolki. Jest to sprzeczne z intuicją, ale SemanticZoom typ kontrolki charakteryzuje kontener zawartości powiększającej, a nie przycisk sterujący powiększeniem. (Taki przycisk może być reprezentowany po prostu jako Przycisk typem kontrolki z przełącznikiem Przełącz wzorzec).