Udostępnij za pomocą

Wsparcie automatyzacji interfejsu użytkownika dla typów kontrolek okiennych

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 Automatyzacji interfejsu użytkownika dla typu kontrolki okna. 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.

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

Wymagania automatyzacji 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 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 okien 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
Okno Okno

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 okien. 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. Kontrolka okna musi mieć punkt umożliwiający klikanie, co spowoduje, że okno zostanie wybrane lub niezaznaczone.
ControlTypeProperty Okno Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika.
IsContentElementProperty Prawda Kontrolka okna musi zawsze być zadowolona.
IsControlElementProperty Prawda Kontrolka do sterowania oknem musi zawsze pozostać 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 dla typu 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 automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi przez kontrolki okien. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.

Wzorzec kontrolki Wsparcie Notatki
IDockProvider Warunkowy Musi być obsługiwany, jeśli okno ma możliwość zadokowania.
ITransformProvider Wymagane Umożliwia przenoszenie, zmienianie rozmiaru lub obracanie okna na ekranie.
IWindowProvider Wymagane Włącza określone operacje dla okna.

Wymagane zdarzenia automatyzacji interfejsu użytkownika

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

Zdarzenie automatyzacji interfejsu użytkownika Wsparcie Notatki
AsyncContentLoadedEvent Wymagane Żaden
AutomationFocusChangedEvent Wymagane Żaden
BoundingRectangleProperty zdarzenie zmiany właściwości. Wymagane Żaden
IsEnabledProperty zdarzenie zmiany właściwości. Wymagane Żaden
IsOffscreenProperty zdarzenie zmiany właściwości. Wymagane Żaden
LayoutInvalidatedEvent Wymagane Żaden
NameProperty zdarzenie zmiany właściwości. Wymagane Żaden
StructureChangedEvent Wymagane Żaden
HorizontallyScrollableProperty zdarzenie zmiany właściwości. Zależy Żaden
HorizontalScrollPercentProperty zdarzenie zmiany właściwości. Zależy Żaden
HorizontalViewSizeProperty zdarzenie zmiany właściwości. Zależy Żaden
VerticalScrollPercentProperty zdarzenie zmiany właściwości. Zależy Żaden
VerticallyScrollableProperty zdarzenie zmiany właściwości. Zależy Żaden
VerticalViewSizeProperty zdarzenie zmiany właściwości. Zależy Żaden
WindowClosedEvent Wymagane Żaden
WindowOpenedEvent Wymagane Żaden
WindowVisualStateProperty zdarzenie zmiany właściwości. Zależy Żaden

Zobacz także

  • Last updated on