Udostępnij za pomocą

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

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.

Ten temat zawiera informacje o wsparciu dla automatyzacji interfejsu użytkownika dla typu kontrolki tekstowej. 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ą konkretne wytyczne dotyczące struktury drzewa automatyzacji interfejsu użytkownika, wartości właściwości automatyzacji interfejsu użytkownika i wzorców kontrolek.

Kontrolki tekstu to podstawowy element interfejsu użytkownika reprezentujący fragment tekstu na ekranie.

W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Tekst. Wymagania automatyzacji 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 automatyzacji interfejsu użytkownika

W poniższej tabeli przedstawiono widok kontrolki i widok zawartości drzewa automatyzacji 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 automatyzacji interfejsu użytkownika, zobacz Omówienie drzewa automatyzacji interfejsu użytkownika.

Widok sterowania Widok zawartości
Tekst 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:

  • Element listy

  • TreeItem

  • DataItem

Kontrolki tekstu mogą nie znajdować się w widoku zawartości drzewa automatyzacji 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 automatyzacji 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 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 tekstu. 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. Obsługiwane, jeśli istnieje prostokąt ograniczenia. Jeśli nie każdy punkt w prostokącie ograniczającym jest klikalny i wykonujesz wyspecjalizowane testowanie trafień, zapewnij punkt, który jest 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 tekstem, który wyświetla.
LabeledByProperty Null Kontrolki tekstu nie mają statycznej etykiety tekstowej.
ControlTypeProperty Tekst 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 odpowiednia, jeśli zawiera informacje, których nie ujawnia właściwość NameProperty innej kontrolki.
IsControlElementProperty Prawda Kontrolka tekstu musi zawsze być kontrolką.

Wymagane wzorce kontrolek automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi przez kontrolki tekstu. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.

Wzorzec kontrolki Wsparcie Notatki
IValueProvider Nigdy Tekst nigdy nie obsługuje 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 bogaty styl i atrybuty (na przykład kolor, pogrubienie i kursywa). Zależy od frameworka.
ITableItemProvider Zależy Jeśli element tekstowy znajduje się w kontrolce tabeli, musi być obsługiwany.
IRangeValueProvider Zależy Jeśli element tekstowy znajduje się w kontrolce tabeli, musi być obsługiwany.

Wymagane zdarzenia automatyzacji interfejsu użytkownika

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

Zdarzenie automatyzacji interfejsu użytkownika Wsparcie Notatki
TextSelectionChangedEvent Wymagane Żaden
TextChangedEvent Wymagane Ż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
NameProperty zdarzenie zmiany właściwości. Wymagane Żaden
ValueProperty zdarzenie zmiany właściwości. Nigdy Żaden
AutomationFocusChangedEvent Wymagane Żaden
StructureChangedEvent Wymagane Żaden

Zobacz także

  • Last updated on