Obsługa automatyzacji interfejsu użytkownika dla kontrolek typu tekst
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 Tekst. 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.
Kontrolki tekstu to podstawowy element interfejsu użytkownika reprezentujący fragment tekstu na ekranie.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Tekst. Wymagania automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek tekstu, 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 tekstu 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 |
|---|---|
| Text | Tekst (jeśli zawartość) |
Kontrolka tekstu może być używana samodzielnie jako etykieta lub jako tekst statyczny w formularzu. Może być również zawarty w strukturze elementu :
Listitem
Treeitem
Dataitem
Kontrolki tekstu mogą nie znajdować się w widoku zawartości drzewa automatyzacja interfejsu użytkownika, ponieważ tekst jest często wyświetlany za pomocą NameProperty innej kontrolki. Na przykład tekst używany do etykietowania kontrolki Pole kombi jest uwidaczniony za pomocą wartości kontrolki NameProperty . Ponieważ kontrolka Pole kombi znajduje się w widoku zawartości drzewa automatyzacja interfejsu użytkownika, nie jest konieczne, aby kontrolka tekstu była tam dostępna. Kontrolki tekstu zawsze mają 0 elementów podrzędnych w widoku zawartości
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 tekstu. 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. | Obsługiwane, jeśli istnieje prostokąt ograniczenia. Jeśli nie każdy punkt w prostokątze ograniczenia jest klikalny, i wykonujesz wyspecjalizowane testowanie trafień, przesłoń i zapewnia punkt możliwy do kliknięcia. |
| IsKeyboardFocusableProperty | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| NameProperty | Zobacz uwagi. | Nazwa kontrolki paska tekstowego jest zawsze wyświetlanym txt. |
| LabeledByProperty | Null |
Kontrolki tekstu nie mają statycznej etykiety tekstowej. |
| ControlTypeProperty | Text | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| LocalizedControlTypeProperty | "tekst" | Zlokalizowany ciąg odpowiadający typowi kontrolki tekstu. |
| IsContentElementProperty | Zależy | Kontrolka tekstu będzie zawartością, jeśli zawiera informacje, które nie są uwidocznione w właściwości NameProperty innej kontrolki. |
| IsControlElementProperty | Prawda | Kontrolka tekstu musi zawsze być kontrolką. |
Wymagane wzorce kontrolek automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono wzorce kontrolek automatyzacja interfejsu użytkownika wymagane do obsługi przez kontrolki tekstu. 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 |
|---|---|---|
| IValueProvider | Nigdy | Tekst nigdy nie obsługuje wartości ValuePattern. Jeśli tekst jest edytowalny, jest to typ kontrolki Edytuj. |
| ITextProvider | Zależy | Tekst powinien obsługiwać wzorzec kontrolki Tekst w celu zapewnienia lepszej dostępności; jednak nie jest to wymagane. Wzorzec kontrolki Tekst jest przydatny, gdy tekst ma styl sformatowany i atrybuty (na przykład kolor, pogrubienie i kursywa). Zależy od platformy. |
| ITableItemProvider | Zależy | Jeśli element tekstowy znajduje się w kontrolce Tabela, musi być obsługiwany. |
| IRangeValueProvider | Zależy | Jeśli element tekstowy znajduje się w kontrolce tabeli, musi być obsługiwany. |
Wymagane zdarzenia automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki tekstu. Aby uzyskać więcej informacji na temat zdarzeń, zobacz omówienie zdarzeń automatyzacja interfejsu użytkownika.
| zdarzenie automatyzacja interfejsu użytkownika | Pomoc techniczna | Uwagi |
|---|---|---|
| TextSelectionChangedEvent | Wymagania | Brak |
| TextChangedEvent | 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 |
| NameProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| ValueProperty zdarzenie zmienione właściwości. | Nigdy | Brak |
| AutomationFocusChangedEvent | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |