Udostępnij za pomocą

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

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.

Temat ten zawiera informacje na temat obsługi automatyzacji interfejsu użytkownika dla typu kontrolki Drzewo. 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ą określone wytyczne dotyczące struktury drzewa automatyzacji interfejsu użytkownika, wartości właściwości automatyzacji interfejsu użytkownika i wzorców kontrolek.

Typ kontrolki Drzewo jest używany dla kontenerów, których zawartość ma znaczenie jako hierarchia węzłów, podobnie jak sposób wyświetlania plików i folderów w okienku po lewej stronie Eksploratora Microsoft Windows. 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 Drzewo. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek drzewa, niezależnie od tego, czy są to 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 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
Drzewo

  • DataItem (co najmniej 0)
  • TreeItem (co najmniej 0)

    • TreeItem (0 lub więcej)• ...
  • Pasek przewijania (0, 1, 2)
 Drzewo

  • DataItem (co najmniej 0)
  • TreeItem (co najmniej 0)

    • TreeItem (0 lub więcej)• ...

Widok sterowania drzewa automatyzacji interfejsu użytkownika składa się z następujących elementów:

  • Od zera do wielu elementów w kontenerze (elementy mogą być oparte na elemencie drzewa, elemencie danych lub innym typie kontrolki).

  • Zero, jeden lub dwa paski przewijania.

Widok zawartości drzewa automatyzacji interfejsu użytkownika składa się z zera lub wielu elementów w kontenerze (elementy mogą być oparte na elemencie drzewa, elemencie danych lub innym typie kontrolki).

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. Kontrolki drzewa mają punkt możliwy do kliknięcia, który spowoduje, że drzewo lub jeden element w kontenerze drzewa ma ustawiony fokus. Otrzymasz punkt z możliwością kliknięcia dla drzewa tylko wtedy, gdy możesz kliknąć w miejsce, które nie powoduje wybrania/uzyskania fokusu jednego z elementów.
ControlTypeProperty Drzewo Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika.
IsContentElementProperty Prawda Kontrolka drzewa jest zawsze uwzględniana w widoku zawartości drzewa automatyzacji interfejsu użytkownika.
IsControlElementProperty Prawda Kontrolka drzewa jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacji interfejsu użytkownika.
IsKeyboardFocusableProperty Zobacz uwagi. Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość.
LabeledByProperty Zobacz uwagi. Jeśli kontrolka drzewa ma skojarzona etykietę, ta właściwość zwróci etykietę AutomationElement dla tej etykiety. W przeciwnym razie właściwość zwróci odwołanie o wartości null (Nothing w programie Microsoft Visual Basic .NET).
LocalizedControlTypeProperty "drzewo" Zlokalizowany tekst odpowiadający kontrolce typu Lista.
NameProperty Zobacz uwagi. Wartość właściwości name kontrolki drzewa zwykle pochodzi z tekstu, który etykietuje kontrolkę. Jeśli nie ma etykiety tekstowej, deweloper aplikacji musi podać wartość dla tej właściwości.

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
ISelectionProvider Zależy Kontrolki drzewa zawierające zestaw elementów do wyboru muszą implementować ten wzorzec kontrolki. Ten wzorzec kontrolki nie musi być implementowany, jeśli wybranie elementu nie przekazuje użytkownikowi znaczących informacji.
CanSelectMultiple Zobacz uwagi. Zaimplementuj tę właściwość, jeśli kontrolka drzewa obsługuje wybór wielokrotny (większość kontrolek drzewa nie obsługuje wielokrotnego zaznaczenia).
IsSelectionRequired Zobacz uwagi. Wartość tej właściwości jest uwidoczniona, jeśli kontrolka wymaga wybrania elementu.
IScrollProvider Zależy Zaimplementuj ten wzorzec kontrolki, jeśli możliwe jest scrollowanie zawartości kontenera drzewa.

Wymagane zdarzenia automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi przez wszystkie kontrole drzewa. Aby uzyskać więcej informacji na temat zdarzeń, zobacz Omówienie zdarzeń automatyzacji interfejsu użytkownika.

Zdarzenie automatyzacji interfejsu użytkownika Wsparcie Notatki
InvalidatedEvent Zależy Żaden
BoundingRectangleProperty zdarzenie zmiany właściwości. Wymagane Żaden
IsOffscreenProperty zdarzenie zmiany właściwości. Wymagane Żaden
IsEnabledProperty zdarzenie zmiany właściwości. Wymagane Żaden
HorizontallyScrollableProperty zdarzenie zmiany właściwości. Zależy Żaden
HorizontalScrollPercentProperty zdarzenie zmiany właściwości. Zależy Żaden
HorizontalViewSizeProperty zdarzenie zmiany właściwości. Zależy Żaden
VerticalScrollPercentProperty zdarzenie zmiany właściwości. Zależy Żaden
VerticallyScrollableProperty zdarzenie zmiany właściwości. Zależy Żaden
VerticalViewSizeProperty zdarzenie zmiany właściwości. Zależy Żaden
AutomationFocusChangedEvent Wymagane Żaden
StructureChangedEvent Wymagane Żaden

Zobacz także

  • Last updated on