Obsługa automatyzacji interfejsu użytkownika dla kontrolek typu okienko
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 Okienko. 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 Okienko służy do reprezentowania obiektu w oknie ramki lub dokumentu. Użytkownicy mogą nawigować między kontrolkami okienka i w zawartości bieżącego okienka, ale nie mogą nawigować między elementami w różnych okienkach. W związku z tym kontrolki okienka reprezentują poziom grupowania niższy niż okna lub dokumenty, ale powyżej poszczególnych kontrolek. Użytkownik przechodzi między okienkami, naciskając klawisz TAB, F6 lub CTRL+TAB, w zależności od kontekstu. Typ kontrolki Okienko nie wymaga określonej nawigacji za pomocą klawiatury.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Okienko. Wymagania dotyczące automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek listy, 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 okienka 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 |
|---|---|
| Pane | Pane |
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 jest szczególnie istotna dla kontrolek okienka. 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ę. |
| IsKeyboardFocusableProperty | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| NameProperty | Zobacz uwagi. | Wartość tej właściwości musi zawsze być jasnym, zwięzłym i znaczącym tytułem. |
| ClickablePointProperty | Zobacz uwagi. | Ta właściwość uwidacznia klikalny punkt kontrolki okienka, który powoduje, że okienko staje się skoncentrowane po kliknięciu. |
| LabeledByProperty | Zobacz uwagi. | Kontrolki okienka zwykle nie mają etykiety statycznej. Jeśli istnieje statyczna etykieta tekstowa, powinna zostać uwidoczniona za pośrednictwem tej właściwości. |
| ControlTypeProperty | Pane | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| LocalizedControlTypeProperty | "okienko" | Zlokalizowany ciąg odpowiadający typowi kontrolki Okienko. |
| IsContentElementProperty | Prawda | Kontrolki okienka są zawsze uwzględniane w widoku zawartości drzewa automatyzacja interfejsu użytkownika. |
| IsControlElementProperty | Prawda | Kontrolki okienka są zawsze uwzględniane w widoku kontrolki drzewa automatyzacja interfejsu użytkownika. |
| HelpTextProperty | "" | Tekst pomocy dla kontrolek okienka powinien wyjaśnić, dlaczego przeznaczenie ramki i jak odnosi się do innych ramek. Opis jest niezbędny, jeśli cel i relacja ramek nie jest jasna z wartości NameProperty. " |
| AccessKeyProperty | Zobacz uwagi. | Jeśli określona kombinacja klawiszy koncentruje się na okienku, informacje te powinny być uwidocznione za pośrednictwem 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 wszystkie kontrolki okienka. 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 kontrolki | Pomoc techniczna | Uwagi |
|---|---|---|
| ITransformProvider | Zależy | Zaimplementuj ten wzorzec kontrolki, jeśli kontrolka okienka może zostać przeniesiona, zmieniona lub obrócona na ekranie. |
| IWindowProvider | Nigdy | Jeśli musisz zaimplementować ten wzorzec kontrolki, kontrolka powinna być oparta na typie kontrolki Window . |
| IDockProvider | Zależy | Zaimplementuj ten wzorzec kontrolki, jeśli kontrolka okienka może być zadokowana. |
| IScrollProvider | Zależy | Zaimplementuj ten wzorzec kontrolki, jeśli można przewijać kontrolkę okienka. |
Wymagane zdarzenia automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki okienka. Aby uzyskać więcej informacji na temat zdarzeń, zobacz omówienie zdarzeń automatyzacja interfejsu użytkownika.
| zdarzenie automatyzacja interfejsu użytkownika | Pomoc techniczna/wartość | Uwagi |
|---|---|---|
| WindowClosedEvent | Nigdy | Brak |
| WindowOpenedEvent | Nigdy | Brak |
| AsyncContentLoadedEvent | Wymagania | 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 |
| WindowVisualStateProperty zdarzenie zmienione właściwości. | Nigdy | Brak |
| AutomationFocusChangedEvent | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |
Przykładowy typ kontrolki okienka
Na poniższej ilustracji przedstawiono kontrolkę, która implementuje typ kontrolki Okienko.
| drzewo automatyzacja interfejsu użytkownika — widok sterowania | drzewo automatyzacja interfejsu użytkownika — widok zawartości |
|---|---|
|
-Okienku - Drzewo (wzór przewijania) -Treeitem - ... Okienku -Edytuj - (Wzorzec przewijania) |