Udostępnij za pomocą

Obsługa automatyzacji interfejsu użytkownika dla typu kontrolki nagłówka

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 zawiera informacje na temat obsługi automatyzacji interfejsu użytkownika dla typu kontrolki nagłówka. 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ą konkretne wytyczne dotyczące struktury drzewa automatyzacji interfejsu użytkownika, wartości właściwości automatyzacji interfejsu użytkownika i wzorców kontrolek.

Kontrolka nagłówka udostępnia kontener wizualny etykiet dla wierszy lub kolumn informacji.

W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Nagłówek. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek nagłówków, 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 nagłówka 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
Nagłówek

- HeaderItem (co najmniej 1)		 Żaden

Kontrolki nagłówka zawsze mają co najmniej 1 element podrzędny w widoku kontrolki drzewa automatyzacji interfejsu użytkownika.

Kontrolki nagłówka mają zero elementów podrzędnych w widoku zawartości drzewa automatyzacji interfejsu użytkownika.

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 nagłówka. 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. Obsługiwane, jeśli istnieje prostokąt ograniczenia. Jeśli nie każdy punkt w prostokącie ograniczającym jest klikalny i wykonujesz wyspecjalizowane testowanie trafień, zapewnij punkt, który jest możliwy do kliknięcia.
IsKeyboardFocusableProperty Zobacz uwagi. Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość.
NameProperty Zobacz uwagi. Kontrolka nagłówka wymaga nazwy, jeśli istnieje więcej niż jeden nagłówek wiersza lub więcej niż jeden nagłówek kolumny. Spowoduje to zidentyfikowanie informacji w nagłówku.
LabeledByProperty Null. Kontrolki nagłówka nie mają etykiety statycznej.
ControlTypeProperty Nagłówek Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika.
LocalizedControlTypeProperty "nagłówek" Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika.
OrientationProperty Poziomy Wartość tej właściwości uwidacznia położenie kontrolki nagłówka — niezależnie od tego, czy jest to nagłówek wiersza, czy nagłówek kolumny.
IsContentElementProperty Nieprawda Kontrolka nagłówka nie jest uwzględniona w widoku zawartości drzewa automatyzacji interfejsu użytkownika.
IsControlElementProperty Prawda Kontrolka nagłówka jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacji interfejsu użytkownika.

Wymagane wzorce kontrolek automatyzacji interfejsu użytkownika

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

Wzorzec kontrolki Wsparcie Notatki
ITransformProvider Zależy Zaimplementuj ten wzorzec kontrolki, jeśli można zmienić rozmiar kontrolki nagłówka.

Wymagane zdarzenia automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki nagłówka. 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

  • Last updated on