Udostępnij za pośrednictwem


Obsługa automatyzacji interfejsu użytkownika dla kontrolek typu okno

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 Okno. 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.

Kontrolka okna składa się z ramki okna, która zawiera obiekty podrzędne, takie jak pasek tytułu, klient i inne obiekty.

Wymagania automatyzacja interfejsu użytkownika w poniższych sekcjach dotyczą wszystkich kontrolek implementujących typ kontrolki Okna, 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 okien 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
Window Window

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 okien. 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. Kontrolka okna musi mieć punkt umożliwiający klikanie, co spowoduje, że okno zostanie wybrane lub niezaznaczone.
ControlTypeProperty Window Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika.
IsContentElementProperty Prawda Kontrolka okna musi zawsze być zawartością.
IsControlElementProperty Prawda Kontrolka okna musi zawsze być kontrolką.
IsKeyboardFocusableProperty Zobacz uwagi. Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość.
LabeledByProperty null Kontrolki okna nie mają statycznej etykiety okna.
LocalizedControlTypeProperty "okno" Zlokalizowany ciąg odpowiadający typowi kontrolki Okno.
NameProperty Zobacz uwagi. Kontrolka okna zawsze zawiera podstawowy element okna, który odnosi się do tego, co użytkownik skojarzy jako najbardziej semantyczny identyfikator elementu.

Wymagane wzorce kontrolek automatyzacja interfejsu użytkownika

W poniższej tabeli wymieniono wzorce kontrolek automatyzacja interfejsu użytkownika wymagane do obsługi przez kontrolki okien. 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
IDockProvider Warunkowe Musi być obsługiwany, jeśli okno ma możliwość zadokowania.
ITransformProvider Wymagania Umożliwia przenoszenie, zmienianie rozmiaru lub obracanie okna na ekranie.
IWindowProvider Wymagania Włącza określone operacje dla okna.

Wymagane zdarzenia automatyzacja interfejsu użytkownika

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

zdarzenie automatyzacja interfejsu użytkownika Pomoc techniczna Uwagi
AsyncContentLoadedEvent Wymagania Brak
AutomationFocusChangedEvent Wymagania Brak
BoundingRectangleProperty zdarzenie zmienione właściwości. Wymagania Brak
IsEnabledProperty zdarzenie zmienione właściwości. Wymagania Brak
IsOffscreenProperty zdarzenie zmienione właściwości. Wymagania Brak
LayoutInvalidatedEvent Wymagania Brak
NameProperty zdarzenie zmienione właściwości. Wymagania Brak
StructureChangedEvent Wymagania Brak
HorizontallyScrollableProperty zdarzenie zmienione właściwości. Zależy Brak
HorizontalScrollPercentProperty zdarzenie zmienione właściwości. Zależy Brak
HorizontalViewSizeProperty zdarzenie zmienione właściwości. Zależy Brak
VerticalScrollPercentProperty zdarzenie zmienione właściwości. Zależy Brak
VerticallyScrollableProperty zdarzenie zmienione właściwości. Zależy Brak
VerticalViewSizeProperty zdarzenie zmienione właściwości. Zależy Brak
WindowClosedEvent Wymagania Brak
WindowOpenedEvent Wymagania Brak
WindowVisualStateProperty zdarzenie zmienione właściwości. Zależy Brak

Zobacz też