Typ kontrolki drzewa
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla typu formantu Tree.
Typ kontrolki drzewa jest używany dla kontenerów, których zawartość ma znaczenie jako hierarchia węzłów, podobnie jak w przypadku wyświetlania plików i folderów w lewym okienku Eksploratora 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. Kontrolka widok-drzewa systemu Windows (zidentyfikowana przez WC_TREEVIEW) jest przykładem kontrolki należącej do typu kontrolki Tree.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Drzewa. Wymagania automatyzacji interfejsu użytkownika dotyczą wszystkich kontrolek elementów drzewa, w których platforma/platforma interfejsu użytkownika integruje obsługę automatyzacji interfejsu użytkownika dla typów kontrolek i wzorców kontrolek.
Ten temat zawiera następujące sekcje.
- typowa struktura drzewa
- odpowiednie właściwości
- wymagane wzorce kontrolek
- wymagane zdarzenia
- Tematy pokrewne
Typowa struktura drzewa
W poniższej tabeli przedstawiono typowy widok kontrolki i 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 kontrolki | Widok zawartości |
|---|---|
|
|
Widok sterowania drzewa automatyzacji interfejsu użytkownika składa się z następujących elementów:
- Zero wielu elementów w kontenerze (elementy mogą być oparte na typach kontrolek TreeItem lub DataItem).
- Zero, jeden lub dwa kontrolki paska 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 typach kontrolek TreeItem lub DataItem).
Odpowiednie właściwości
W poniższej tabeli wymieniono właściwości automatyzacji interfejsu użytkownika, których wartość lub definicja jest szczególnie istotna dla typu kontrolki Tree. Aby uzyskać więcej informacji na temat właściwości automatyzacji interfejsu użytkownika, zobacz Pobieranie właściwości z elementów automatyzacji interfejsu użytkownika.
| Właściwość automatyzacji interfejsu użytkownika | Wartość | Notatki |
|---|---|---|
| UIA_AutomationIdPropertyId | Zobacz uwagi. | Wartość tej właściwości musi być unikatowa wśród wszystkich elementów równorzędnych w nieprzetworzonym widoku drzewa automatyzacji interfejsu użytkownika. |
| UIA_BoundingRectanglePropertyId | Zobacz uwagi. | Najbardziej oddalony prostokąt, który zawiera całą kontrolkę. |
| UIA_ClickablePointPropertyId | Zobacz uwagi. | Kontrolki drzewa mają klikalny punkt, który powoduje, że drzewo lub jeden z elementów w kontenerze drzewa odbiera fokus. Kontrolka drzewa może mieć punkt możliwy do kliknięcia tylko wtedy, gdy można kliknąć lokalizację w drzewie bez spowodowania wybrania elementu lub odebrania fokusu. |
| UIA_ControlTypePropertyId | drzewa | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| UIA_IsContentElementPropertyId | PRAWDZIWY | Kontrolka drzewa jest zawsze uwzględniana w widoku zawartości drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka drzewa jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsKeyboardFocusablePropertyId | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| UIA_LabeledByPropertyId | Zobacz uwagi. | Jeśli kontrolka drzewa ma skojarzona etykietę, ta właściwość zwraca wskaźnik IUIAutomationElement dla tej etykiety. W przeciwnym razie właściwość zwraca odwołanie o wartości null. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki drzewa . Wartość domyślna to "tree" dla en-US lub angielski (Stany Zjednoczone). |
| UIA_NamePropertyId | Zobacz uwagi. | Wartość właściwości name kontrolki drzewa zwykle pochodzi z tekstu, który etykietuje kontrolkę. Jeśli nie ma etykiety tekstowej, musisz podać wartość dla tej właściwości. |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi wszystkich kontrolek drzewa. 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 |
|---|---|---|
| IScrollProvider | Zależy | Zaimplementuj wzorzec kontrolki przewijania , jeśli elementy w kontenerze drzewa można przewijać. |
| ISelectionProvider | Zależy | Kontrolki drzewa zawierające zestaw elementów do wyboru muszą implementować wzorzec kontrolki Selection. Nie trzeba go implementować, jeśli wybranie elementu nie przekazuje użytkownikowi żadnych 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. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika, które muszą obsługiwać wszystkie kontrolki drzewa. Aby uzyskać więcej informacji na temat zdarzeń, zobacz Omówienie zdarzeń automatyzacji interfejsu użytkownika.
| Zdarzenie automatyzacji interfejsu użytkownika | Notatki |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId zdarzenie zmienione właściwości. | |
| UIA_IsEnabledPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsEnabled, musi obsługiwać to zdarzenie. |
| UIA_IsOffscreenPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsOffscreen, musi obsługiwać to zdarzenie. |
| UIA_ScrollHorizontallyScrollablePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie. |
| UIA_ScrollHorizontalScrollPercentPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie. |
| UIA_ScrollHorizontalViewSizePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie. |
| UIA_ScrollVerticalScrollPercentPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie. |
| UIA_ScrollVerticallyScrollablePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie. |
| UIA_ScrollVerticalViewSizePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie. |
| UIA_Selection_InvalidatedEventId | Jeśli kontrolka obsługuje wzorzec kontrolki Selection, musi obsługiwać to zdarzenie. |
| UIA_StructureChangedEventId |
Tematy pokrewne