Edytuj typ kontrolki
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla Edytowanie typu kontrolki.
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 automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki edycji. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek edycji, 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
- uwagi
- Tematy pokrewne
Typowa struktura drzewa
W poniższej tabeli przedstawiono typowy widok kontrolki i zawartości drzewa automatyzacji 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 automatyzacji interfejsu użytkownika, zobacz Omówienie drzewa automatyzacji interfejsu użytkownika.
| Widok kontrolki | Widok zawartości |
|---|---|
|
|
Kontrolki implementujące typ kontrolki Edit zawsze będą miały zero pasków przewijania w widoku sterowania drzewa automatyzacji interfejsu użytkownika, ponieważ jest to kontrolka jednowierszowa. Pojedynczy wiersz tekstu może opakowuje się w niektórych scenariuszach układu. Typ kontrolki edytuj edycji jest przeznaczony tylko dla małych ilości tekstu.
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 kontrolek edycji. 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. | 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. |
| UIA_ControlTypePropertyId | Edytowanie | |
| UIA_IsContentElementPropertyId | true | Kontrolka edycji jest zawsze uwzględniana w widoku zawartości drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsControlElementPropertyId | true | Kontrolka edycji 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_IsPasswordPropertyId | Zobacz uwagi. | Musi być ustawiona wartość true na kontrolkach edycji zawierających 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 powinny być odczytywane, gdy użytkownik je wpisze. |
| UIA_LabeledByPropertyId | 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 właściwości LabeledBy. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki Edit. Wartość domyślna to "edytuj" dla en-US lub angielski (Stany Zjednoczone). |
| UIA_NamePropertyId | Zobacz uwagi. | Nazwa kontrolki edycji jest zwykle generowana na podstawie statycznej etykiety tekstowej. Jeśli nie ma statycznej etykiety tekstowej, wartość właściwości Name musi zostać przypisana przez dewelopera aplikacji. Właściwość Name nigdy nie powinna zawierać zawartości tekstowej kontrolki edycji. |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi przez kontrolki edycji. 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 |
|---|---|---|
| IRangeValueProvider | Zależy | Wszystkie kontrolki edycji, które przyjmują zakres liczbowy, muszą uwidocznić wzorzec kontrolki RangeValue. |
| minimalna | Zobacz uwagi. | Ta właściwość musi być najmniejszą wartością, do której można ustawić zawartość kontrolki edycji. |
| maksymalna | Zobacz uwagi. | Ta właściwość musi być największą wartością, do której 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 kontrolka edycji przyjmuje tylko liczby całkowite, wartość właściwości SmallChange musi być 1. Jeśli kontrolka edycji przyjmuje zakres od 1.0 do 2.0, wartość właściwości SmallChange musi wynosić 0,1. Jeśli kontrolka edycji przyjmuje zakres od 1,00 do 2,00, wartość właściwości SmallChange musi wynosić 0,001. |
| LargeChange | null | Ta właściwość nie musi być uwidoczniona w kontrolce edycji. |
| wartości | Zobacz uwagi. | Ta właściwość wskazuje zawartość liczbową kontrolki edycji. Gdy bardziej precyzyjna wartość jest ustawiana przez klienta automatyzacji interfejsu użytkownika w zakresach określonych w minimum i właściwości Maksymalna, właściwość Wartość jest automatycznie zaokrąglona do najbliższej akceptowanej wartości. |
| ITextProvider | Wymagane | Wszystkie kontrolki edycji muszą obsługiwać wzorzec sterowania Tekst, ponieważ szczegółowe informacje muszą być zawsze dostępne dla klientów korzystających z technologii pomocniczych. |
| IValueProvider | Zależy | Wszystkie kontrolki edycji, które przyjmują ciąg, muszą uwidocznić wzorzec kontrolki Value. |
| 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. |
| wartości | Zobacz uwagi. | Ta właściwość zawiera tekstową zawartość kontrolki edycji. Jeśli właściwość UIA_IsPasswordPropertyId jest ustawiona na wartość true, wykonywanie zapytania względem właściwości Value musi zwrócić błąd. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi kontrolek edycji. 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_NamePropertyId zdarzenie zmienione właściwości. | |
| UIA_RangeValueValuePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki RangeValue, musi obsługiwać to zdarzenie. |
| UIA_ScrollHorizontallyScrollablePropertyId zdarzenie zmienione właściwości. | Kontrolka edycji nigdy nie obsługuje wzorca kontrolki przewijania. |
| UIA_ScrollHorizontalScrollPercentPropertyId zdarzenie zmienione właściwości. | Kontrolka edycji nigdy nie obsługuje wzorca kontrolki przewijania. |
| UIA_ScrollHorizontalViewSizePropertyId zdarzenie zmienione właściwości. | Kontrolka edycji nigdy nie obsługuje wzorca kontrolki przewijania. |
| UIA_ScrollVerticallyScrollablePropertyId zdarzenie zmienione właściwości. | Kontrolka edycji nigdy nie obsługuje wzorca kontrolki przewijania. |
| UIA_ScrollVerticalScrollPercentPropertyId zdarzenie zmienione właściwości. | Kontrolka edycji nigdy nie obsługuje wzorca kontrolki przewijania. |
| UIA_ScrollVerticalViewSizePropertyId zdarzenie zmienione właściwości. | Kontrolka edycji nigdy nie obsługuje wzorca kontrolki przewijania. |
| UIA_StructureChangedEventId | |
| UIA_Text_TextChangedEventId | Jeśli kontrolka obsługuje wzorzec kontrolki Text, musi obsługiwać to zdarzenie. |
| UIA_Text_TextSelectionChangedEventId | Jeśli kontrolka obsługuje wzorzec kontrolki Text, musi obsługiwać to zdarzenie. |
| UIA_ValueValuePropertyId zdarzenie zmienione właściwości . | Jeśli kontrolka obsługuje wzorzec kontrolki Value, musi obsługiwać to zdarzenie. |
Uwagi
Kontrolka edycji może służyć jako pole tekstowe tylko do odczytu, które nie obsługuje zaznaczenia ani edytowania tekstu. Taka kontrolka edycji zachowuje się jako obiekt pola, który ma określoną nazwę i wartość.
Jeśli kontrolka edycji zawiera tekst zastępczy (na przykład baner cue), tekst powinien być używany jako właściwość HelpText, chyba że tekst może być edytowany przez użytkownika, a następnie ponownie użyty jako tekst zastępczy. Na przykład pasek adresu programu Windows Internet Explorer zawiera tekst "about:Tabs" po otwarciu nowej karty. Nie jest to HelpText, ponieważ jest to adres programowy, który może być używany lub edytowany przez użytkownika.
Tematy pokrewne