Obsługa automatyzacji interfejsu użytkownika dla typu formantu ToolTip
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 Etykietka narzędzia. 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 porad narzędzi to wyskakujące okna zawierające tekst.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Etykietka narzędzia. Wymagania dotyczące automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek porad narzędzi, 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 porad narzędzi 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 |
|---|---|
| ToolTip - Tekst (co najmniej 0) - Obraz (co najmniej 0) |
ToolTip |
Kontrolki porad narzędzi są wyświetlane tylko w widoku zawartości drzewa automatyzacja interfejsu użytkownika, jeśli mogą odbierać fokus klawiatury. W przeciwnym razie wszystkie informacje porady narzędzia są dostępne z HelpTextProperty elementu na automatyzacja interfejsu użytkownika, do którego odwołuje się porada narzędzia.
Wskazówki dotyczące narzędzi powinny pojawić się pod kontrolką, do których odwołują się informacje. Klienci muszą nasłuchiwać informacji ToolTipOpenedEvent , aby zapewnić spójne uzyskiwanie informacji zawartych w poradach dotyczących narzędzi.
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 porad narzędzi. 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. | Punkt klikalny powinien być częścią wskazówki narzędzia, która odrzuci kontrolkę. Niektóre porady dotyczące narzędzi 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 kontrolki porada narzędzia to tekst wyświetlany w poradzie narzędzia. |
| LabeledByProperty | Null |
Kontrolki porad narzędzi są zawsze oznaczone etykietami własnymi. |
| ControlTypeProperty | ToolTip | 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 tekstem, jest on dostępny jako właściwość HelpTextProperty z kontrolki, która ją podniosła. |
| IsControlElementProperty | Prawda | Kontrolka porada narzędzia 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 porad narzędzi. 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 |
|---|---|---|
| IWindowProvider | Zależy | Porady dotyczące narzędzi, które można zamknąć, klikając element interfejsu użytkownika, musi obsługiwać element WindowPattern, aby można było je zamknąć automatycznie. |
| ITextProvider | Zależy | Aby uzyskać lepszą dostępność, kontrolka porad narzędzi może obsługiwać wzorzec kontrolki Tekst, chociaż 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 automatyzacja interfejsu użytkownika
Kontrolki porad narzędzi muszą podnieść ToolTipOpenedEvent wartość po wyświetleniu na ekranie. Zdarzenie będzie zawierać odwołanie do automatyzacja interfejsu użytkownika elementu samej porady narzędzia.
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki porad dotyczących narzędzi. 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 | Zależy | Brak |
| TextChangedEvent | Zależy | Brak |
| WindowClosedEvent | Zależy | Brak |
| WindowOpenedEvent | Zależy | Brak |
| ToolTipOpenedEvent | Wymagania | Brak |
| ToolTipClosedEvent | 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 |
| WindowVisualStateProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| AutomationFocusChangedEvent | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |