Obsługa automatyzacji interfejsu użytkownika dla formantów typu drzewo
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 Drzewo. 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 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 automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Drzewo. Wymagania dotyczące automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek 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 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 |
|---|---|
Drzewa
|
Drzewa
|
Widok sterowania drzewa automatyzacja interfejsu użytkownika składa się z następujących elementów:
Zero 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 automatyzacja 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 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. | 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ąć gdzieś, co nie powoduje wybrania/uzyskania fokusu jednego z elementów. |
| ControlTypeProperty | Drzewa | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| IsContentElementProperty | Prawda | Kontrolka drzewa jest zawsze uwzględniana w widoku zawartości drzewa automatyzacja interfejsu użytkownika. |
| IsControlElementProperty | Prawda | Kontrolka drzewa jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacja 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 ciąg odpowiadający typowi kontrolki 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 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 |
|---|---|---|
| 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żna przewijać zawartość kontenera drzewa. |
Wymagane zdarzenia automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki 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 |
|---|---|---|
| InvalidatedEvent | Zależy | 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 |
| HorizontallyScrollableProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| HorizontalScrollPercentProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| HorizontalViewSizeProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| VerticalScrollPercentProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| VerticallyScrollableProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| VerticalViewSizeProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| AutomationFocusChangedEvent | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |