Typ kontrolki okienka
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla typu kontrolki okienka.
Typ kontrolki okienka dotyczy potencjalnie przewijanych regionów o różnej zawartości. Służy do reprezentowania obiektu w ramce lub oknie dokumentu. Użytkownicy mogą nawigować między kontrolkami okienka a zawartością bieżącego okienka. Kontrolki okienka reprezentują poziom grupowania niższy niż okna lub dokumenty, ale powyżej poszczególnych kontrolek. Użytkownik przechodzi między okienkami, naciskając TAB, F6 lub CTRL+TAB, w zależności od kontekstu.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu okienka. Wymagania automatyzacji interfejsu użytkownika dotyczą wszystkich kontrolek okienka, 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
- wymagane zdarzenia
- Przykładowy typ kontrolki okienka
- 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 kontrolek okienka 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 |
|---|---|
|
|
Kontrolka okienka zawsze jest wyświetlana w widokach kontrolki i zawartości. Nie ujawniaj obiektu układu jako okienka w kontrolce lub widoku zawartości, jeśli obiekt jest używany tylko do prezentacji wizualnej.
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 okienka. 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_AccessKeyPropertyId | Zobacz uwagi. | Jeśli określona kombinacja koncentruje się na okienku, te informacje powinny być uwidocznione za pośrednictwem tej właściwości. |
| 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. | Ta właściwość uwidacznia klikalny punkt kontrolki okienka, który powoduje, że okienko staje się skoncentrowane po kliknięciu. |
| UIA_ControlTypePropertyId | okienka | |
| UIA_HelpTextPropertyId | Zobacz uwagi. | Tekst pomocy dla kontrolek okienka powinien wyjaśniać przeznaczenie ramki i jej powiązania z innymi ramkami. Opis jest niezbędny, jeśli cel i relacja ramek nie jest jasna z wartości właściwości UIA_NamePropertyId. |
| UIA_IsContentElementPropertyId | PRAWDZIWY | Kontrolka okienka jest zawsze uwzględniana w widoku zawartości drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka okienka jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsKeyboardFocusablePropertyId | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| UIA_LabeledByPropertyId | Zobacz uwagi. | Kontrolki okienka zwykle nie mają etykiety statycznej. Jeśli istnieje statyczna etykieta tekstowa, powinna zostać uwidoczniona za pośrednictwem tej właściwości. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki Okienko. Wartość domyślna to "pane" dla en-US lub angielski (Stany Zjednoczone). |
| UIA_NamePropertyId | Zobacz uwagi. | Wartość tej właściwości musi zawsze być jasnym, zwięzłym i znaczącym tytułem. |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi przez kontrolki okienka. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.
| Wzorzec kontrolki | Wsparcie | Notatki |
|---|---|---|
| IDockProvider | Zależy | Zaimplementuj wzorzec sterowania docku, jeśli kontrolka okienka może być zadokowana. |
| IScrollProvider | Zależy | Zaimplementuj wzorzec kontrolki przewijania, jeśli kontrolka okienka może zostać przewinięta. |
| ITransformProvider | Zależy | Zaimplementuj wzorzec kontrolki Przekształć, jeśli kontrolka okienka może zostać przeniesiona, zmieniona lub obracana na ekranie. |
| IWindowProvider | Nigdy | Jeśli element musi zaimplementować wzorzec kontrolki okna , kontrolka powinna być oparta na typie kontrolki okna. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika, które kontrolki okienka są wymagane do obsługi. Aby uzyskać więcej informacji na temat zdarzeń, zobacz Omówienie zdarzeń automatyzacji interfejsu użytkownika.
| Zdarzenie automatyzacji interfejsu użytkownika | Notatki |
|---|---|
| UIA_AsyncContentLoadedEventId | |
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId zdarzenie zmienione właściwości. | |
| UIA_IsOffscreenPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsOffscreen, musi obsługiwać to zdarzenie. |
| UIA_ScrollHorizontallyScrollablePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie. |
| UIA_ScrollHorizontalScrollPercentPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie. |
| UIA_ScrollHorizontalViewSizePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie. |
| UIA_ScrollVerticallyScrollablePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie. |
| UIA_ScrollVerticalScrollPercentPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie. |
| UIA_ScrollVerticalViewSizePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie. |
| UIA_StructureChangedEventId |
Przykładowy typ kontrolki okienka
Na poniższej ilustracji przedstawiono kontrolkę, która implementuje typ kontrolki okienka.
zrzut ekranu 
| Drzewo automatyzacji interfejsu użytkownika — widok sterowania | Drzewo automatyzacji interfejsu użytkownika — widok zawartości |
|---|---|
|
|
Tematy pokrewne