Obsługa automatyzacji interfejsu użytkownika dla typu formantu ComboBox
Uwaga
Ta dokumentacja jest przeznaczona dla deweloperów programu .NET Framework, którzy chcą używać zarządzanych klas automatyzacja interfejsu użytkownika zdefiniowanych w System.Windows.Automation przestrzeni nazw. Aby uzyskać najnowsze informacje na temat automatyzacja interfejsu użytkownika, zobacz Interfejs API usługi Windows Automation: automatyzacja interfejsu użytkownika.
Ten temat zawiera informacje o obsłudze automatyzacja interfejsu użytkownika dla typu kontrolki ComboBox. W automatyzacja interfejsu użytkownika typ kontrolki jest zestawem warunków, które musi spełniać kontrolka ControlTypeProperty w celu użycia właściwości . Warunki obejmują określone wytyczne dotyczące struktury drzewa automatyzacja interfejsu użytkownika, automatyzacja interfejsu użytkownika wartości właściwości, wzorców kontrolek i zdarzeń automatyzacja interfejsu użytkownika.
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 automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki ComboBox. Wymagania automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek pola kombi, niezależnie od tego, czy Windows Presentation Foundation (WPF), Win32 lub Windows Forms.
Wymagana struktura drzewa automatyzacja interfejsu użytkownika
W poniższej tabeli przedstawiono widok kontrolki i widok zawartości drzewa automatyzacja 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 automatyzacja interfejsu użytkownika, zobacz omówienie drzewa automatyzacja interfejsu użytkownika.
| Widok kontrolki | Widok zawartości |
|---|---|
| ComboBox - Edycja (0 lub 1) - Lista (1) - Element listy (element podrzędny listy; od 0 do wielu) - Przycisk (1) |
ComboBox - Element listy (od 0 do wielu) |
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 Uruchamianie.
Wymagane właściwości automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono właściwości automatyzacja interfejsu użytkownika, których wartość lub definicja jest szczególnie istotna dla kontrolek pola kombi. Aby uzyskać więcej informacji na temat właściwości automatyzacja interfejsu użytkownika, zobacz automatyzacja interfejsu użytkownika Właściwości dla klientów.
| właściwość automatyzacja interfejsu użytkownika | Wartość | Uwagi |
|---|---|---|
| AutomationIdProperty | Zobacz uwagi. | Wartość tej właściwości musi być unikatowa we wszystkich kontrolkach w aplikacji. |
| BoundingRectangleProperty | Zobacz uwagi. | Najbardziej oddalony prostokąt, który zawiera całą kontrolkę. |
| ClickablePointProperty | Zobacz uwagi. | Obsługiwane, jeśli istnieje prostokąt ograniczenia. Jeśli nie każdy punkt w prostokątze ograniczenia jest klikalny, i wykonujesz wyspecjalizowane testowanie trafień, przesłoń i zapewnia punkt możliwy do kliknięcia. |
| ControlTypeProperty | ComboBox | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| HelpTextProperty | 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". |
| IsContentElementProperty | Prawda | Kontrolki pola kombi są zawsze uwzględniane w widoku zawartości drzewa automatyzacja interfejsu użytkownika. |
| IsControlElementProperty | Prawda | Kontrolki pola kombi są zawsze uwzględniane w widoku kontrolki drzewa automatyzacja interfejsu użytkownika. |
| IsKeyboardFocusableProperty | Prawda | Kontrolki pola kombi uwidaczniają zestaw elementów z kontenera wyboru. Kontrolka pola kombi może odbierać fokus klawiatury, chociaż gdy klient automatyzacja interfejsu użytkownika ustawia fokus na polu kombi, wszystkie elementy w poddrzewie pola kombi mogą otrzymać fokus. |
| LabeledByProperty | Zobacz uwagi. | Kontrolki pola kombi zwykle mają statyczną etykietę tekstową, do których odwołuje się ta właściwość. |
| LocalizedControlTypeProperty | "pole kombi" | Zlokalizowany ciąg odpowiadający typowi kontrolki ComboBox. |
| NameProperty | Zobacz uwagi. | Kontrolka pola kombi zwykle pobiera swoją nazwę z kontrolki tekstu statycznego. |
Wymagane wzorce kontrolek automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono wzorce kontrolek automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki pola kombi. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz automatyzacja interfejsu użytkownika Control Patterns Overview (Omówienie wzorców kontrolek automatyzacja interfejsu użytkownika).
| Wzorzec kontrolki | Pomoc techniczna | Uwagi |
|---|---|---|
| IExpandCollapseProvider | Tak | Kontrolka pola kombi musi zawsze zawierać przycisk listy rozwijanej, aby był polem kombi. |
| ISelectionProvider | Tak | Wyświetla bieżące zaznaczenie w polu kombi. Ta obsługa jest delegowana do pola listy pod polem kombi. |
| IValueProvider | Zależy | Jeśli pole kombi ma możliwość podejmowania dowolnych wartości tekstowych, wzorzec wartości musi być obsługiwany. Ten wzorzec umożliwia programowe ustawianie zawartości ciągu pola kombi. Jeśli wzorzec wartości nie jest obsługiwany, oznacza to, że użytkownik musi dokonać wyboru z elementów listy w poddrzewie pola kombi. |
| IScrollProvider | Nigdy | Wzorzec 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ć. Może być obsługiwana tylko wtedy, gdy pole listy jest widoczne na ekranie. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki pola kombi. Aby uzyskać więcej informacji na temat zdarzeń, zobacz omówienie zdarzeń automatyzacja interfejsu użytkownika.
| zdarzenie automatyzacja interfejsu użytkownika | Pomoc techniczna | Uwagi |
|---|---|---|
| AutomationFocusChangedEvent | Wymagania | Brak |
| BoundingRectangleProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| IsOffscreenProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| IsEnabledProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |
| ExpandCollapseStateProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| ValueProperty zdarzenie zmienione właściwości. | Zależy | Jeśli kontrolka obsługuje wzorzec wartości, musi obsługiwać to zdarzenie. |