Obsługa automatyzacji interfejsu użytkownika dla typu kontrolki TreeItem
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 TreeItem. 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.
Typ kontrolki TreeItem reprezentuje węzeł w kontenerze drzewa. Każdy węzeł może zawierać inne węzły nazywane węzłami podrzędnym. Węzły nadrzędne lub węzły zawierające węzły podrzędne mogą być wyświetlane jako rozwinięte lub zwinięte.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki TreeItem. Wymagania dotyczące automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek elementów drzewa, 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 drzewa 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 |
|---|---|
| Treeitem - CheckBox (0 lub 1) - Obraz (0 lub 1) - Przycisk (0 lub 1) - TreeItem (0 lub więcej) |
Treeitem - TreeItem (0 lub więcej) |
Kontrolki elementu drzewa mogą mieć zero lub więcej elementów podrzędnych elementu drzewa w widoku zawartości drzewa automatyzacja interfejsu użytkownika. Jeśli kontrolka elementu drzewa ma funkcje wykraczające poza funkcje uwidocznione w wzorcach kontrolek wymienionych poniżej, kontrolka powinna być oparta na typie kontrolki Element danych.
Zwinięte elementy drzewa nie będą wyświetlane w widoku kontrolki ani widoku zawartości, dopóki nie staną się rozwinięte i widoczne (lub mogą być przewinięte do widoku).
Widok kontrolki może zawierać dodatkowe szczegóły kontrolki, w tym skojarzony obraz lub przycisk. Na przykład element w widoku konspektu może zawierać obraz, a także przycisk umożliwiający rozwinięcie lub zwinięcie konspektu. Te obiekty szczegółów nie są wyświetlane w widoku zawartości, ponieważ informacje są już reprezentowane przez element drzewa nadrzędnego. Elementy drzewa, które są przewijane poza ekran, będą wyświetlane zarówno w widokach kontrolki, jak i zawartości drzewa automatyzacja interfejsu użytkownika i powinny mieć ustawioną IsOffscreenProperty wartość true.
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 są szczególnie istotne dla kontrolek 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. | Najbardziej oddalony prostokąt, który zawiera całą kontrolkę. |
| ClickablePointProperty | Zobacz uwagi. | Ta właściwość musi zwrócić lokalizację elementu, która spowoduje zmianę stanu zaznaczenia lub skoncentrowanie elementu. |
| ControlTypeProperty | Treeitem | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| 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. |
| IsOffscreenProperty | Zobacz uwagi. | Ta właściwość jest ustawiona tak, aby wskazywała, kiedy kontrolka elementu drzewa jest przewijana z ekranu. |
| IsKeyboardFocusableProperty | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| ItemTypeProperty | Zobacz uwagi. | Jeśli kontrolka elementu drzewa używa ikony wizualizacji, aby wskazać, że jest to określony typ obiektu, ta właściwość musi być obsługiwana i wskazywać, jaki jest obiekt. |
| LabeledByProperty | Null |
Kontrolki elementów drzewa są etykietami własnymi. |
| LocalizedControlTypeProperty | "element drzewa" | Zlokalizowany ciąg odpowiadający typowi kontrolki TreeItem. |
| NameProperty | Zobacz uwagi. | Ta właściwość uwidacznia tekst wyświetlany dla każdej kontrolki elementu drzewa. |
Wymagane wzorce kontrolek automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono wzorce kontrolek automatyzacja interfejsu użytkownika wymagane do obsługi przez kontrolki 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/wzorzec kontrolki, właściwość | Pomoc techniczna/wartość | Uwagi |
|---|---|---|
| IInvokeProvider | Zależy | Zaimplementuj ten wzorzec kontrolki, jeśli element drzewa ma oddzielne polecenie z możliwością działania. |
| IExpandCollapseProvider | Tak | Wszystkie elementy drzewa można rozwinąć lub zwinąć. |
| ExpandCollapseState | Węzeł rozwinięty, zwinięty lub liściowy | Elementy drzewa będą węzłami liścia, gdy nie zostaną rozwinięte lub zwinięte. |
| IScrollItemProvider | Zależy | Zaimplementuj ten wzorzec kontrolki, jeśli kontener drzewa obsługuje wzorzec kontrolki Przewijanie. |
| ISelectionItemProvider | Zależy | Zaimplementuj ten wzorzec kontrolki, jeśli istnieje możliwość aktywnego zaznaczenia, który jest zachowywany, gdy użytkownik wróci do kontenera drzewa. |
| SelectionContainer | Tak | Ta właściwość uwidacznia ten sam kontener dla wszystkich elementów w kontenerze. |
| IToggleProvider | Zależy | Zaimplementuj ten wzorzec kontrolki, jeśli element drzewa ma skojarzone pole wyboru. |
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 drzewa. 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 |
| IsEnabledProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| IsOffscreenProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| ItemStatusProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| NameProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |
| ExpandCollapseStateProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| InvokedEvent | Zależy | Brak |
| CurrentViewProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| ElementAddedToSelectionEvent | Zależy | Brak |
| ElementRemovedFromSelectionEvent | Zależy | Brak |
| ElementSelectedEvent | Zależy | Brak |
| ToggleStateProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| ValueProperty zdarzenie zmienione właściwości. | Zależy | Brak |