Udostępnij przez


Obsługa automatyzacji interfejsu użytkownika dla typu kontrolki „thumb”

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.

Temat ten przedstawia informacje na temat wsparcia Automatyzacji Interfejsu Użytkownika dla typu kontrolki Kciuk. 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ą określone wytyczne dotyczące struktury drzewa automatyzacji interfejsu użytkownika, wartości właściwości automatyzacji interfejsu użytkownika 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 automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Thumb. Wymagania automatyzacji 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 automatyzacji interfejsu użytkownika

W poniższej tabeli przedstawiono widok kontrolki i widok zawartości drzewa automatyzacji 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 automatyzacji interfejsu użytkownika, zobacz Omówienie drzewa automatyzacji interfejsu użytkownika.

Widok sterowania Widok zawartości
Kciuk - Nie dotyczy

Kontrolki kciuka nigdy nie są wyświetlane w widoku zawartości, ponieważ istnieją tylko do manipulowania myszą. Ich funkcjonalność jest ujawniona poprzez inny wzorzec kontrolki, taki jak wzorzec przewijania, wzorzec transformacji lub wzorzec RangeValue, który jest obsługiwany w kontenerze Thumb.

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 kciuka. 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. Dowolny punkt w widocznym obszarze roboczym 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 automatyzacji interfejsu użytkownika, więc nie wymaga nazwy.
LabeledByProperty Null Kontrolki kciuka nigdy nie mają etykiety.
ControlTypeProperty Kciuk Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika.
LocalizedControlTypeProperty "kciuk" Zlokalizowany ciąg odpowiadający typowi kontrolki Thumb.
IsContentElementProperty Nieprawda Sterowanie Thumb nigdy nie jest zadowolone.
IsControlElementProperty Prawda Kontrolka Thumb 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 kciuka. 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
ITransformProvider Wymagane Umożliwia przeniesienie kontrolki kciuka na ekranie.

Wymagane zdarzenia automatyzacji interfejsu użytkownika

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

Zdarzenie automatyzacji interfejsu użytkownika Wsparcie Notatki
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
AutomationFocusChangedEvent Wymagane Żaden
StructureChangedEvent Wymagane Żaden

Zobacz także