Obsługa automatyzacji interfejsu użytkownika dla formantów typu kalendarz
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 Kalendarz. 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ą określone wytyczne dotyczące struktury drzewa automatyzacja interfejsu użytkownika, automatyzacja interfejsu użytkownika wartości właściwości, wzorców kontrolek i zdarzeń automatyzacja interfejsu użytkownika.
Kontrolki kalendarza umożliwiają użytkownikowi łatwe określenie daty i wybranie innych dat.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Kalendarz. Wymagania dotyczące automatyzacja interfejsu użytkownika mają zastosowanie do wszystkich kontrolek kalendarza, 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 kalendarza 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 |
|---|---|
Calendar
|
Calendar - ListItem (ilość zależy od liczby dni wyświetlania) |
Kontrolki kalendarza mogą być reprezentowane w wielu różnych formularzach w interfejsie użytkownika. Jedynymi gwarantowanymi kontrolkami w widoku sterowania drzewa automatyzacja interfejsu użytkownika są kontrolki siatki danych, nagłówka, elementu nagłówka i elementu listy.
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 są szczególnie istotne dla kontrolek kalendarza. 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. | Obsługiwane, jeśli istnieje prostokąt ograniczenia. Jeśli nie każdy punkt w prostokątze ograniczenia jest klikalny, i wykonujesz wyspecjalizowane testowanie trafień, przesłoń i zapewnia punkt możliwy do kliknięcia. |
| ControlTypeProperty | Calendar | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| IsContentElementProperty | Prawda | Kontrolka kalendarza jest zawsze uwzględniana w widoku zawartości drzewa automatyzacja interfejsu użytkownika. |
| IsControlElementProperty | Prawda | Kontrolka kalendarza jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacja interfejsu użytkownika. |
| IsKeyboardFocusableProperty | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| LabeledByProperty | Zobacz uwagi. | Etykieta kontrolki dokumentu. Zazwyczaj jest używany tytuł dokumentu. |
| LocalizedControlTypeProperty | "kalendarz" | Zlokalizowany ciąg odpowiadający typowi kontrolki Kalendarz. |
| NameProperty | Zobacz uwagi. | Kontrolka kalendarza zazwyczaj pobiera nazwę z daty bieżącego dnia. |
Wymagane wzorce kontrolek automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono wzorce kontrolek automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki kalendarza. 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 | Uwagi |
|---|---|---|
| IGridProvider | Tak | Kontrolka kalendarza zawsze obsługuje wzorzec siatki, ponieważ dni w ciągu miesiąca to elementy, które można poruszać przestrzennie. |
| IScrollProvider | Zależy | Większość kontrolek kalendarza obsługuje przerzucanie widoku według strony. Wzorzec przewijania jest zalecany w celu obsługi nawigacji stronicowania. |
| ISelectionProvider | Zależy | Większość kontrolek kalendarza zachowuje określony dzień, miesiąc lub rok jako wybór elementu podrzędnego. Niektóre kalendarze można wybierać z wieloma opcjami, a inne można wybierać tylko jednokrotnie. |
| ITableProvider | Tak | Kontrolka kalendarza zawsze zawiera nagłówek w poddrzewie w dniach tygodnia, więc wzorzec tabeli musi być obsługiwany. |
| IValueProvider | Nie. | Wzorzec kontrolki Wartość nie jest konieczny dla kontrolek kalendarza, ponieważ nie można ustawić wartości bezpośrednio w kontrolce. Jeśli określona data jest skojarzona z kontrolką, informacje powinny być dostarczane przez wzorzec kontrolki Wybór. |
Wymagane zdarzenia automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki kalendarza. Aby uzyskać więcej informacji na temat zdarzeń, zobacz omówienie zdarzeń automatyzacja interfejsu użytkownika.
| zdarzenie automatyzacja interfejsu użytkownika | Pomoc techniczna | Uwagi |
|---|---|---|
| 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 |
| StructureChangedEvent | Wymagania | Brak |
| CurrentViewProperty zdarzenie zmienione właściwości. | Zależy | Brak |
| HorizontallyScrollableProperty zdarzenie zmienione właściwości. | Zależy | Jeśli kontrolka obsługuje wzorzec kontrolki Przewijanie, musi obsługiwać to zdarzenie. |
| HorizontalScrollPercentProperty zdarzenie zmienione właściwości. | Zależy | Jeśli kontrolka obsługuje wzorzec kontrolki Przewijanie, musi obsługiwać to zdarzenie. |
| HorizontalViewSizeProperty zdarzenie zmienione właściwości. | Zależy | Jeśli kontrolka obsługuje wzorzec kontrolki Przewijanie, musi obsługiwać to zdarzenie. |
| VerticalScrollPercentProperty zdarzenie zmienione właściwości. | Zależy | Jeśli kontrolka obsługuje wzorzec kontrolki Przewijanie, musi obsługiwać to zdarzenie. |
| VerticallyScrollableProperty zdarzenie zmienione właściwości. | Zależy | Jeśli kontrolka obsługuje wzorzec kontrolki Przewijanie, musi obsługiwać to zdarzenie. |
| VerticalViewSizeProperty zdarzenie zmienione właściwości. | Zależy | Jeśli kontrolka obsługuje wzorzec kontrolki Przewijanie, musi obsługiwać to zdarzenie. |
| InvalidatedEvent | Wymagania | Brak |