Obsługa automatyzacji interfejsu użytkownika dla kontrolek typu edycja
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 Edycja. 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.
Kontrolki edycji umożliwiają użytkownikowi wyświetlanie i edytowanie prostego wiersza tekstu bez obsługi formatowania sformatowanego.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Edytuj. Wymagania dotyczące automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek edycji, 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 edycji 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 |
|---|---|
| Edytuj | Edytuj |
Kontrolki, które implementują typ kontrolki Edytuj, zawsze będą miały zero pasków przewijania w widoku sterowania drzewa automatyzacja interfejsu użytkownika, ponieważ jest to kontrolka jednowierszowa. Pojedynczy wiersz tekstu może opakowuje się w niektórych scenariuszach układu. Typ kontrolki Edytuj najlepiej nadaje się do przechowywania małych ilości edytowalnego lub wybieranego tekstu.
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 w przypadku kontrolek edycji. 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. | Kontrolka edycji musi mieć punkt z możliwością kliknięcia, który daje fokus wejściowy do edycji części kontrolki, gdy użytkownik kliknie tam mysz. |
| IsKeyboardFocusableProperty | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| NameProperty | Zobacz uwagi. | Nazwa kontrolki edycji jest zwykle generowana na podstawie statycznej etykiety tekstowej. Jeśli nie ma statycznej etykiety tekstowej, wartość Name właściwości musi zostać przypisana przez dewelopera aplikacji. Właściwość Name nigdy nie powinna zawierać zawartości tekstowej kontrolki edycji. |
| LabeledByProperty | Zobacz uwagi. | Jeśli istnieje statyczna etykieta tekstowa skojarzona z kontrolką, ta właściwość musi uwidocznić odwołanie do tej kontrolki. Jeśli kontrolka tekstu jest podskładem innej kontrolki, nie będzie miała ustawionej LabeledBy właściwości. |
| ControlTypeProperty | Edytuj | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| LocalizedControlTypeProperty | "edytuj" | Zlokalizowany ciąg odpowiadający typowi kontrolki Edytuj. |
| IsContentElementProperty | Prawda | Kontrolka edycji jest zawsze uwzględniana w widoku zawartości drzewa automatyzacja interfejsu użytkownika. |
| IsControlElementProperty | Prawda | Kontrolka edycji jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacja interfejsu użytkownika. |
| IsPasswordProperty | Zobacz uwagi. | Należy ustawić wartość true dla kontrolek edycji, które zawierają hasła. Jeśli kontrolka edycji zawiera zawartość hasła, ta właściwość może być używana przez czytnik zawartości ekranu w celu określenia, czy naciśnięcia klawiszy powinny być odczytywane, gdy użytkownik je wpisze. |
Wymagane wzorce i właściwości kontrolek automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono wzorce kontrolek wymagane do obsługi przez wszystkie kontrolki edycji. 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/wzorzec kontrolki | Pomoc techniczna/wartość | Uwagi |
|---|---|---|
| ITextProvider | Zależy | Kontrolki edycji powinny obsługiwać wzorzec kontrolki Tekst, ponieważ szczegółowe informacje tekstowe powinny być zawsze dostępne dla klientów. |
| IValueProvider | Zależy | Wszystkie kontrolki edycji, które przyjmują ciąg, muszą uwidocznić wzorzec wartości. |
| IsReadOnly | Zobacz uwagi. | Ta właściwość musi być ustawiona tak, aby wskazywała, czy kontrolka może mieć ustawiony programowo, czy też może być edytowana przez użytkownika. |
| Value | Zobacz uwagi. | Ta właściwość zwróci tekstową zawartość kontrolki edycji. Jeśli właściwość jest ustawiona IsPasswordProperty na true, ta właściwość musi zgłosić InvalidOperationException żądanie. |
| IRangeValueProvider | Zależy | Wszystkie kontrolki edycji, które przyjmują zakres liczbowy, muszą uwidocznić wzorzec kontrolki Wartość zakresu. |
| Minimum | Zobacz uwagi. | Ta właściwość musi być najmniejszą wartością, na którą można ustawić zawartość kontrolki edycji. |
| Maximum | Zobacz uwagi. | Ta właściwość musi być największą wartością, na którą można ustawić zawartość kontrolki edycji. |
| SmallChange | Zobacz uwagi. | Ta właściwość musi wskazywać liczbę miejsc dziesiętnych, na które można ustawić wartość. Jeśli edycja ma tylko liczby całkowite, SmallChangeProperty wartość musi mieć wartość 1. Jeśli edycja przyjmuje zakres od 1.0 do 2.0, SmallChangeProperty musi to być wartość 0.1. Jeśli kontrolka edycji przyjmuje zakres od 1,00 do 2,00, SmallChangeProperty musi to być wartość 0,001. |
| LargeChange | Null |
Ta właściwość nie musi być uwidoczniona w kontrolce edycji. |
| Value | Zobacz uwagi. | Ta właściwość będzie wskazywać zawartość liczbową kontrolki edycji. Gdy bardziej precyzyjna wartość jest ustawiana przez klienta automatyzacja interfejsu użytkownika w zakresach określonych we Minimum właściwościach iMaximum, właściwość Value zostanie automatycznie zaokrąglona do najbliższej zaakceptowanej wartości. |
Wymagane zdarzenia automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki edycji. 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 | Wymagania | Brak |
| 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. | Zależy | Brak |
| HorizontallyScrollableProperty zdarzenie zmienione właściwości. | Nigdy | Brak |
| HorizontalScrollPercentProperty zdarzenie zmienione właściwości. | Nigdy | Brak |
| HorizontalViewSizeProperty zdarzenie zmienione właściwości. | Nigdy | Brak |
| VerticalScrollPercentProperty zdarzenie zmienione właściwości. | Nigdy | Brak |
| VerticallyScrollableProperty zdarzenie zmienione właściwości. | Nigdy | Brak |
| VerticalViewSizeProperty zdarzenie zmienione właściwości. | Nigdy | Brak |
| ValueProperty zdarzenie zmienione właściwości. | Zależy | Jeśli kontrolka obsługuje wzorzec kontrolki Wartość zakresu, musi obsługiwać to zdarzenie. |
| AutomationFocusChangedEvent | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |