ComboBox, typ kontrolki
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla typem kontrolki ComboBox.
Pole kombi to pole listy połączone ze statyczną kontrolką lub kontrolką edycji, która wyświetla aktualnie wybrany element w części pola listy pola kombi. Część pola listy kontrolki jest wyświetlana przez cały czas lub pojawia się tylko wtedy, gdy użytkownik wybierze strzałkę listy rozwijanej (która jest przyciskiem naciśnięcia) obok kontrolki. Jeśli pole wyboru jest kontrolką edycji, użytkownik może wprowadzić informacje, które nie znajdują się na liście; w przeciwnym razie użytkownik może wybrać tylko elementy na liście.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typem kontrolki ComboBox. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek pól kombi, 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 odnoszącego się do kontrolek pola kombi 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 edycji w widoku kontrolki pola kombi jest konieczna tylko wtedy, gdy pole kombi można edytować, aby pobrać dowolne dane wejściowe, tak jak w przypadku pola kombi w oknie dialogowym Uruchom.
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 typ kontrolki ComboBox. 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. | 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 | Pole kombi | |
| UIA_HelpTextPropertyId | Zobacz uwagi. | Tekst pomocy dla kontrolek pól kombi powinien wyjaśnić, dlaczego użytkownik jest proszony o wybranie opcji w polu kombi. Tekst jest podobny do informacji przedstawionych za pomocą etykietki narzędzia. Na przykład "Wybierz element, aby ustawić rozdzielczość wyświetlania monitora". |
| UIA_IsContentElementPropertyId | PRAWDZIWY | Kontrolki pola kombi są zawsze uwzględniane w widoku zawartości drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolki pola kombi są zawsze uwzględniane w widoku kontrolki drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsKeyboardFocusablePropertyId | PRAWDZIWY | Kontrolki pola kombi mogą odbierać fokus klawiatury; Jednak gdy klient automatyzacji interfejsu użytkownika ustawia fokus na pole kombi, każdy element w poddrzewie pola kombi może otrzymać fokus. |
| UIA_LabeledByPropertyId | Zobacz uwagi. | Kontrolki pola kombi zwykle mają statyczną etykietę tekstową, do których odwołuje się ta właściwość. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki ComboBox. Wartość domyślna to "pole kombi" dla en-US lub angielskiego (Stany Zjednoczone). |
| UIA_NamePropertyId | Zobacz uwagi. | Nazwa kontrolki pola kombi jest zwykle generowana na podstawie statycznej etykiety tekstowej. Jeśli nie ma statycznej etykiety tekstowej, musisz przypisać wartość właściwości Name. Właściwość Name nigdy nie powinna zawierać bieżącej zawartości pola kombi lub zmieniać się po zmianie zawartości pola kombi. |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi wszystkich kontrolek pola kombi. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.
| Wzorzec kontrolki | Wsparcie | Notatki |
|---|---|---|
| IExpandCollapseProvider | Wymagane | Wzorzec sterowania ExpandCollapse musi być obsługiwany, ponieważ kontrolka pola kombi musi zawsze zawierać przycisk listy rozwijanej. |
| ISelectionProvider | Zależy | Wyświetla bieżące zaznaczenie w polu kombi. Obsługa wzorca kontrolki wyboru jest delegowana do pola listy pod polem kombi, ale nie zawsze może być możliwa. |
| IValueProvider | Zależy | Jeśli pole kombi może przyjmować dowolne wartości tekstowe, wzorzec kontrolki Wartość musi być obsługiwany. Ten wzorzec umożliwia programowe ustawianie zawartości ciągu pola kombi. Jeśli wzorzec kontrolki Wartość nie jest obsługiwany, użytkownik musi wybrać elementy listy w poddrzewie pola kombi. |
| IScrollProvider | Nigdy | Wzorzec sterowania przewijania nigdy nie jest obsługiwany bezpośrednio w polu kombi. Jest on obsługiwany, jeśli pole listy zawarte w polu kombi może przewijać i tylko wtedy, gdy pole listy jest widoczne na ekranie. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi kontrolek pól kombi. 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_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_StructureChangedEventId | |
| UIA_ExpandCollapseExpandCollapseStatePropertyId zdarzenie zmienione właściwości. | |
| UIA_ValueValuePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki Value, musi obsługiwać to zdarzenie. |
Tematy pokrewne