Obsługa automatyzacji interfejsu użytkownika dla typu formantu ListItem
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 kontrolkiListItem. 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ą konkretne wytyczne dotyczące struktury drzewa automatyzacja interfejsu użytkownika, automatyzacja interfejsu użytkownika wartości właściwości i wzorce kontrolek.
Kontrolki elementów listy to przykład kontrolek implementujących typ kontrolki ListItem.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki ListItem. Wymagania dotyczące automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek listy, 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 elementów listy 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 |
|---|---|
| Listitem - Obraz (co najmniej 0) - Tekst (co najmniej 0) - Edytuj (co najmniej 0) |
Listitem |
Elementy podrzędne kontrolki elementu listy w widoku zawartości drzewa automatyzacja interfejsu użytkownika muszą zawsze mieć wartość "0". Jeśli struktura kontrolki jest taka, że inne elementy znajdują się pod elementem listy, należy przestrzegać wymagań dotyczących obsługi automatyzacja interfejsu użytkownika dla typu formantu TreeItem.
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 elementów listy. 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. | Ta wartość tej właściwości powinna zawierać obszar obrazu i zawartości tekstowej elementu listy. |
| ClickablePointProperty | Zależy | 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 kontrolka listy jest całkowicie objęta elementami listy potomnej, zgłosi wartość , NoClickablePointException aby wskazać, że klient musi poprosić element wewnątrz kontrolki listy o punkt możliwy do kliknięcia. |
| NameProperty | Zobacz uwagi. | Wartość właściwości name kontrolki elementu listy pochodzi z zawartości tekstowej elementu. |
| LabeledByProperty | Zobacz uwagi. | Jeśli istnieje statyczna etykieta tekstowa, ta właściwość musi uwidocznić odwołanie do tej kontrolki. |
| ControlTypeProperty | Listitem | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| LocalizedControlTypeProperty | "element listy" | Zlokalizowany ciąg odpowiadający typowi kontrolki ListItem. |
| IsContentElementProperty | Prawda | Kontrolka listy jest zawsze uwzględniana w widoku zawartości drzewa automatyzacja interfejsu użytkownika. |
| IsControlElementProperty | Prawda | Kontrolka listy jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacja interfejsu użytkownika. |
| IsKeyboardFocusableProperty | Prawda | Jeśli kontener może akceptować dane wejściowe klawiatury, ta wartość właściwości powinna mieć wartość true. |
| HelpTextProperty | "" | Tekst Pomocy dla kontrolek listy powinien wyjaśnić, dlaczego użytkownik jest proszony o dokonanie wyboru z listy opcji, która jest zazwyczaj tego samego typu informacjami przedstawionymi za pomocą etykietki narzędzia. Na przykład "Wybierz element, aby ustawić rozdzielczość wyświetlania monitora". |
| ItemTypeProperty | Zależy | Ta właściwość powinna być uwidoczniona dla kontrolek elementów listy reprezentujących obiekt bazowy. Te kontrolki elementów listy zwykle mają ikonę skojarzona z kontrolką, którą użytkownicy kojarzą z obiektem bazowym. |
| IsOffscreenProperty | Zależy | Ta właściwość musi zwrócić wartość dla tego, czy element listy jest obecnie przewijany do widoku w kontenerze nadrzędnym, który implementuje wzorzec kontrolki Przewijanie. |
Wymagane wzorce kontrolek automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono wzorce kontrolek automatyzacja interfejsu użytkownika wymagane do obsługi przez kontrolki elementów listy. 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 |
|---|---|---|
| ISelectionItemProvider | Tak | Kontrolka elementu listy musi implementować ten wzorzec kontrolki. Dzięki temu elementy listy mogą być przekazywane po ich wybraniu. |
| IScrollItemProvider | Zależy | Jeśli element listy znajduje się w kontenerze, który można przewijać, należy zaimplementować ten wzorzec kontrolki. |
| IToggleProvider | Zależy | Jeśli element listy jest sprawdzalny, a akcja nie wykonuje zmiany stanu zaznaczenia, należy zaimplementować ten wzorzec kontrolki. |
| IExpandCollapseProvider | Zależy | Jeśli element można manipulować w celu pokazania lub ukrycia informacji, należy zaimplementować ten wzorzec kontrolki. |
| IValueProvider | Zależy | Jeśli element można edytować, należy zaimplementować ten wzorzec kontrolki. Zmiany w kontrolce elementu listy spowodują zmiany wartości NameProperty, i Value. |
| IGridItemProvider | Zależy | Jeśli element do elementu nawigacji przestrzennej jest obsługiwany w kontenerze listy, a kontener jest rozmieszczony w wierszach i kolumnach, należy zaimplementować wzorzec kontrolki Element siatki. |
| IInvokeProvider | Zależy | Jeśli element ma polecenie, które można na nim wykonać, oddzielone od zaznaczenia, należy zaimplementować ten wzorzec. Zazwyczaj jest to akcja skojarzona z dwukrotnym kliknięciem kontrolki elementu listy. Przykłady to uruchomienie dokumentu z Eksploratora Microsoft Windows lub odtwarzanie pliku muzycznego w Odtwarzacz multimedialny Windows microsoft. |
Wymagane zdarzenia automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki elementów listy. Aby uzyskać więcej informacji na temat zdarzeń, zobacz omówienie zdarzeń automatyzacja interfejsu użytkownika.
| zdarzenie automatyzacja interfejsu użytkownika | Pomoc techniczna | Uwagi |
|---|---|---|
| InvokedEvent | Zależy | Brak |
| ElementAddedToSelectionEvent | Wymagania | Brak |
| ElementRemovedFromSelectionEvent | Wymagania | Brak |
| ElementSelectedEvent | 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 |
| NameProperty | Wymagania | Brak |
| ItemStatusProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| ExpandCollapseStateProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| ValueProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| ToggleStateProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| AutomationFocusChangedEvent | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |