Typ kontrolki przycisku
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla typu kontrolki Button.
Przycisk to obiekt, z którego użytkownik korzysta, aby wykonać akcję, taką jak PRZYCISK OK i Anuluj w oknie dialogowym. Kontrolka przycisku jest prostą kontrolką do uwidocznienia, ponieważ mapuje ją na pojedyncze polecenie, które użytkownik chce ukończyć.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Przycisk. Wymagania automatyzacji interfejsu użytkownika dotyczą wszystkich kontrolek przycisków, 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
- Tematy pokrewne
Typowa struktura drzewa
W poniższej tabeli przedstawiono typowy widok kontrolki i zawartości drzewa automatyzacji interfejsu użytkownika, który odnosi się do kontrolek przycisków i opisuje, 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 |
|---|---|
|
|
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 przycisk typu kontrolki (np. kontrolki przycisków). 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_AcceleratorKeyPropertyId | Zobacz uwagi. | Kontrolka przycisku zwykle obsługuje akceleratora, aby umożliwić użytkownikowi końcowemu szybkie wykonanie akcji reprezentowanej przez przycisk z klawiatury. |
| 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. | Obsługiwane, jeśli istnieje prostokąt ograniczenia. Jeśli nie każdy punkt w obrębie prostokąta ograniczenia jest klikalny, a element wykonuje wyspecjalizowane testowanie trafień, przesłonięć i zapewnić punkt możliwy do kliknięcia. |
| UIA_ControlTypePropertyId | przycisk | |
| UIA_HelpTextPropertyId | Zobacz uwagi. | Tekst pomocy powinien wskazywać, jaki będzie końcowy wynik aktywowania przycisku. Jest to zazwyczaj ten sam typ informacji przedstawiony za pomocą etykietki narzędzia. |
| UIA_IsContentElementPropertyId | PRAWDZIWY | Kontrolka przycisku musi zawsze być zawartością. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka przycisku musi być zawsze kontrolką. |
| UIA_IsKeyboardFocusablePropertyId | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| UIA_LabeledByPropertyId | Zero | Kontrolki przycisków są oznaczone etykietą własną zawartością. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki Button. Wartość domyślna to "button" dla en-US lub angielskiego (Stany Zjednoczone). |
| UIA_NamePropertyId | Zobacz uwagi. | Nazwa kontrolki przycisku to tekst używany do etykietowania. Za każdym razem, gdy obraz jest używany do etykietowania przycisku, należy podać tekst alternatywny dla właściwości Name przycisku. |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi wszystkich kontrolek przycisków. 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 |
|---|---|---|
| IExpandCollapseProvider | Zobacz uwagi. | Gdy przycisk jest hostowany jako element podrzędny przycisku podziału, przycisk podrzędny może obsługiwać wzorzec sterowania ExpandCollapse zamiast wzorca kontrolki Invoke lub Przełącznik. Wzorzec kontrolki ExpandCollapse może służyć do otwierania lub zamykania menu lub innej struktury podrzędnej skojarzonej z elementem przycisku. |
| IInvokeProvider | Zobacz uwagi. | Wszystkie przyciski powinny obsługiwać wzorzec kontrolki Invoke lub Przełącznik, ale nie oba te elementy. Wzorzec kontrolki Wywołaj musi być obsługiwany, gdy przycisk wykonuje polecenie na żądanie użytkownika. To polecenie mapuje na jedną operację, taką jak wycinanie, kopiowanie, wklejanie lub usuwanie. |
| IToggleProvider | Zobacz uwagi. | Wszystkie przyciski powinny obsługiwać wzorzec kontrolki Invoke lub Przełącznik, ale nie oba te elementy. Wzorzec przełącznika kontrolki musi być obsługiwany, jeśli przycisk może przechodzić przez serię maksymalnie trzech stanów. Zazwyczaj jest to postrzegane jako przełącznik włączony/wyłączony dla określonych funkcji. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika, które są wymagane do obsługi kontrolek przycisków. Aby uzyskać więcej informacji na temat zdarzeń, zobacz Omówienie zdarzeń automatyzacji interfejsu użytkownika.
| Zdarzenie automatyzacji interfejsu użytkownika | Notatki |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId zdarzenie zmienione właściwości. | |
| UIA_Invoke_InvokedEventId | Jeśli kontrolka obsługuje wzorzec kontrolki Invoke, musi obsługiwać to zdarzenie. |
| 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_NamePropertyId zdarzenie zmienione właściwości. | |
| UIA_StructureChangedEventId | |
| UIA_ToggleToggleStatePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec sterowania przełącznika, musi obsługiwać to zdarzenie. |
Tematy pokrewne