Udostępnij za pomocą

Obsługa automatyzacji interfejsu użytkownika dla typu kontrolki TreeItem

Uwaga / Notatka

Ta dokumentacja jest przeznaczona dla deweloperów programu .NET Framework, którzy chcą używać zarządzanych klas automatyzacji interfejsu użytkownika zdefiniowanych w przestrzeni nazw System.Windows.Automation. Aby uzyskać najnowsze informacje na temat automatyzacji interfejsu użytkownika, zobacz Windows Automation API: Automatyzacja interfejsu użytkownika.

Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika dla typu kontrolki TreeItem. W Automatyzacji interfejsu użytkownika typ kontrolki jest zestawem warunków, które musi spełniać kontrolka, aby korzystać z właściwości ControlTypeProperty. Warunki obejmują konkretne wytyczne dotyczące struktury drzewa automatyzacji interfejsu użytkownika, wartości właściwości automatyzacji interfejsu użytkownika i wzorców kontrolek.

Kontrolka typu 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 automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki TreeItem. Wymagania automatyzacji 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 automatyzacji interfejsu użytkownika

W poniższej tabeli przedstawiono widok kontrolki i widok zawartości drzewa automatyzacji interfejsu użytkownika odnoszący się do kontrolek elementów drzewa 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 sterowania 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 automatyzacji 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 sterowania ani w widoku zawartości, dopóki nie zostaną rozwinięte i widoczne (lub można je przewinąć 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 przewijane z ekranu będą wyświetlane zarówno w widokach kontrolki, jak i zawartości drzewa automatyzacji interfejsu użytkownika i powinny mieć ustawioną IsOffscreenProperty wartość true.

Wymagane właściwości automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono właściwości automatyzacji interfejsu użytkownika, których wartość lub definicja jest szczególnie istotna dla kontrolek listy. Aby uzyskać więcej informacji na temat właściwości automatyzacji interfejsu użytkownika, zobacz Właściwości automatyzacji interfejsu użytkownika dla klientów.

Właściwość automatyzacji interfejsu użytkownika Wartość Notatki
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 automatyzacji interfejsu użytkownika.
IsControlElementProperty Prawda Kontrolka listy jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacji 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 automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono wzorce automatyzacji interfejsu użytkownika, które muszą być obsługiwane przez kontrolki listy. 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
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ść posiadania aktywnego zaznaczenia, które jest utrzymywane, gdy użytkownik wróci do kontenera drzewa.
SelectionContainer Tak Ta właściwość udostępnia ten sam kontener wszystkim elementom w kontenerze.
IToggleProvider Zależy Zaimplementuj ten wzorzec kontrolki, jeśli element drzewa ma skojarzone pole wyboru.

Wymagane zdarzenia automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono zdarzenia automatyzacji 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ń automatyzacji interfejsu użytkownika.

Zdarzenie automatyzacji interfejsu użytkownika Wsparcie Notatki
AutomationFocusChangedEvent Wymagane Żaden
BoundingRectangleProperty zdarzenie zmiany właściwości. Wymagane Żaden
IsEnabledProperty zdarzenie zmiany właściwości. Wymagane Żaden
IsOffscreenProperty zdarzenie zmiany właściwości. Wymagane Żaden
ItemStatusProperty zdarzenie zmiany właściwości. Zależy Żaden
NameProperty zdarzenie zmiany właściwości. Wymagane Żaden
StructureChangedEvent Wymagane Żaden
ExpandCollapseStateProperty zdarzenie zmiany właściwości. Wymagane Żaden
InvokedEvent Zależy Żaden
CurrentViewProperty zdarzenie zmiany właściwości. Zależy Żaden
ElementAddedToSelectionEvent Zależy Żaden
ElementRemovedFromSelectionEvent Zależy Żaden
ElementSelectedEvent Zależy Żaden
ToggleStateProperty zdarzenie zmiany właściwości. Zależy Żaden
ValueProperty zdarzenie zmiany właściwości. Zależy Żaden

Zobacz także

  • Last updated on