Udostępnij za pomocą

Obsługa automatyzacji interfejsu użytkownika dla typu kontrolki Etykietka narzędzia

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 obsłudze automatyzacji interfejsu użytkownika dla kontrolki typu Podpowiedź. 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.

Podpowiedzi narzędziowe to wyskakujące okna zawierające tekst.

W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki ToolTip. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek podpowiedzi narzędziowych, niezależnie od tego, czy Windows Presentation Foundation (WPF), Win32, czy Windows Forms.

Wymagana struktura drzewa automatyzacji interfejsu użytkownika

W poniższej tabeli przedstawiono widok sterowania i widok zawartości drzewa automatyzacji interfejsu użytkownika związanego z kontrolkami etykietek narzędziowych i opisano, co można znaleźć w każdym z widoków. 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
Podpowiedź

- Tekst (0 lub więcej)
- Obraz (0 lub więcej)		 Podpowiedź

Podpowiedzi narzędziowe są wyświetlane tylko w widoku zawartości drzewa automatyzacji interfejsu użytkownika, jeśli mogą przyjmować skupienie klawiatury. W przeciwnym razie wszystkie dane podpowiedzi są dostępne w ramach elementu automatyzacji UI, do którego odnosi się podpowiedź.

Wskazówki dotyczące narzędzi powinny pojawić się pod kontrolą, której dotyczą informacje. Klienci muszą być czujni na ToolTipOpenedEvent, aby konsekwentnie uzyskiwać informacje zawarte w poradach dotyczących narzędzi.

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 wskazówek narzędziowych. 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. Punkt klikalny powinien być częścią podpowiedzi, która zamknie kontrolkę. Niektóre podpowiedzi narzędziowe nie mają tej możliwości i nie będą miały punktu, który można kliknąć.
IsKeyboardFocusableProperty Zobacz uwagi. Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość.
NameProperty Zobacz uwagi. Nazwa elementu sterującego dymkiem narzędzia to tekst wyświetlany w dymku narzędzia.
LabeledByProperty Null Podpowiedzi narzędziowe są zawsze samoznakowane treścią.
ControlTypeProperty Podpowiedź Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika.
LocalizedControlTypeProperty "etykietka narzędzia" Zlokalizowany ciąg odpowiadający typowi kontrolki Etykietka narzędzia.
IsContentElementProperty Zależy Jeśli kontrolka porada narzędzia może odbierać fokus klawiatury, musi znajdować się w widoku zawartości drzewa. Jeśli jest tylko tekstowy, jest on dostępny jako właściwość HelpTextProperty z kontrolki, która go zgłosiła.
IsControlElementProperty Prawda Kontrolka dymku narzędzia 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 porad narzędzi. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.

Wzorzec kontrolki Wsparcie Notatki
IWindowProvider Zależy Porady dotyczące narzędzi, które można zamknąć, klikając element interfejsu użytkownika, muszą obsługiwać WindowPattern, żeby mogły być zamykane automatycznie.
ITextProvider Zależy Aby uzyskać większą dostępność, kontrolka porad narzędzi może obsługiwać wzorzec kontrolki Tekst, choć nie jest to wymagane. Wzorzec kontrolki Tekst jest przydatny, gdy tekst ma styl sformatowany i atrybuty (na przykład kolor, pogrubienie i kursywa).

Wymagane zdarzenia automatyzacji interfejsu użytkownika

Elementy sterujące podpowiedzi narzędziowych muszą wywołać ToolTipOpenedEvent po pojawieniu się na ekranie. Zdarzenie będzie zawierać odwołanie do elementu automatyzacji interfejsu użytkownika samej porady narzędzia.

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

Zdarzenie automatyzacji interfejsu użytkownika Wsparcie Notatki
TextSelectionChangedEvent Zależy Żaden
TextChangedEvent Zależy Żaden
WindowClosedEvent Zależy Żaden
WindowOpenedEvent Zależy Żaden
ToolTipOpenedEvent Wymagane Żaden
ToolTipClosedEvent 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
WindowVisualStateProperty zdarzenie zmiany właściwości. Zależy Żaden
AutomationFocusChangedEvent Wymagane Żaden
StructureChangedEvent Wymagane Żaden

Zobacz także

  • Last updated on