Obsługa automatyzacji interfejsu użytkownika dla kontrolek typu miniatura
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 Thumb. 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 kciuka zapewniają funkcjonalność umożliwiającą przenoszenie kontrolki (lub przeciąganie), takie jak przycisk paska przewijania lub zmiana rozmiaru, na przykład widżet zmiany rozmiaru okna. Kontrolki kciuka można również zaimplementować jako ruchome obramowania okienek. Należy pamiętać, że nie zapewnia funkcji przeciągania i upuszczania. Kontrolki kciuka mogą odbierać fokus myszy, ale zwykle nie fokus klawiatury. Deweloper kontrolki musi zaimplementować kontrolkę, aby działał odpowiednio (można przeciągnąć lub zmienić jej rozmiar).
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Thumb. Wymagania dotyczące automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek kciuka, 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 kciuka 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 |
|---|---|
| Thumb | - Nie dotyczy |
Kontrolki kciuka nigdy nie są wyświetlane w widoku zawartości, ponieważ istnieją tylko do manipulowania myszą. Ich funkcjonalność jest widoczna, choć inny wzorzec kontrolki, taki jak Wzorzec przewijania, Wzorzec transformacji lub Wzorzec RangeValue, jest obsługiwany w kontenerze Thumb.
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 kciuka. 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. | Dowolny punkt w widocznym obszarze klienta kontrolki Thumb. |
| IsKeyboardFocusableProperty | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| NameProperty | Null |
Kontrolka Thumb nie jest dostępna w widoku zawartości drzewa automatyzacja interfejsu użytkownika, więc nie wymaga nazwy. |
| LabeledByProperty | Null |
Kontrolki kciuka nigdy nie mają etykiety. |
| ControlTypeProperty | Thumb | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| LocalizedControlTypeProperty | "kciuk" | Zlokalizowany ciąg odpowiadający typowi kontrolki Thumb. |
| IsContentElementProperty | Fałsz | Kontrolka Thumb nigdy nie jest zawartością. |
| IsControlElementProperty | Prawda | Kontrolka Thumb 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 kciuka. 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/wzorzec kontrolki, właściwość | Pomoc techniczna/wartość | Uwagi |
|---|---|---|
| ITransformProvider | Wymagania | Umożliwia przeniesienie kontrolki kciuka na ekranie. |
Wymagane zdarzenia automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki kciuka. Aby uzyskać więcej informacji na temat zdarzeń, zobacz omówienie zdarzeń automatyzacja interfejsu użytkownika.
| zdarzenie automatyzacja interfejsu użytkownika | Pomoc techniczna | Uwagi |
|---|---|---|
| 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 |
| AutomationFocusChangedEvent | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |