Typ kontrolki kalendarza
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla typu kontrolki Kalendarz. Kontrolka kalendarza pozwala użytkownikowi łatwo określić datę i wybrać inne daty.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Kalendarz. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek kalendarza, w których platforma/platforma interfejsu użytkownika integruje obsługę automatyzacji interfejsu użytkownika dla typów kontrolek i wzorców kontrolek.
Ten temat zawiera następujące sekcje.
- typowa struktura drzewa
- odpowiednie właściwości
- wymagane wzorce kontrolek
- wymagane zdarzenia
- Tematy pokrewne
Typowa struktura drzewa
W poniższej tabeli przedstawiono typowy widok kontrolki i zawartości drzewa automatyzacji 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 automatyzacji interfejsu użytkownika, zobacz Omówienie drzewa automatyzacji interfejsu użytkownika.
| Widok kontrolki | Widok zawartości |
|---|---|
|
|
Kontrolki kalendarza mogą być reprezentowane w wielu różnych formularzach w interfejsie użytkownika. Jedynymi kontrolkami, które mają być w widoku sterowania drzewa automatyzacji interfejsu użytkownika, to kontrolki siatki danych, nagłówka, elementu nagłówka i elementu listy.
Odpowiednie właściwości
W poniższej tabeli wymieniono właściwości automatyzacji interfejsu użytkownika, których wartość lub definicja jest szczególnie istotna dla typu kontrolki Kalendarz. Aby uzyskać więcej informacji na temat właściwości automatyzacji interfejsu użytkownika, zobacz Pobieranie właściwości z elementów automatyzacji interfejsu użytkownika.
| Właściwość automatyzacji interfejsu użytkownika | Wartość | Notatki |
|---|---|---|
| UIA_AutomationIdPropertyId | Zobacz uwagi. | Wartość tej właściwości musi być unikatowa wśród wszystkich elementów równorzędnych w nieprzetworzonym widoku drzewa automatyzacji interfejsu użytkownika. |
| UIA_BoundingRectanglePropertyId | Zobacz uwagi. | Najbardziej oddalony prostokąt, który zawiera całą kontrolkę. |
| UIA_ClickablePointPropertyId | Zobacz uwagi. | Obsługiwane, jeśli istnieje prostokąt ograniczenia. Jeśli nie każdy punkt w obrębie prostokąta ograniczenia jest klikalny, a element wykonuje wyspecjalizowane testowanie trafień, przesłonięć i zapewnić punkt możliwy do kliknięcia. |
| UIA_ControlTypePropertyId | kalendarz | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| UIA_IsContentElementPropertyId | PRAWDZIWY | Kontrolka kalendarza jest zawsze uwzględniana w widoku zawartości drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka kalendarza jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsKeyboardFocusablePropertyId | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| UIA_LabeledByPropertyId | Zobacz uwagi. | Wartość tej właściwości powinna być etykietą kontrolki dokumentu. Zazwyczaj jest używany tytuł dokumentu. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki Calendar. Wartość domyślna to "kalendarz" dla en-US lub angielski (Stany Zjednoczone). |
| UIA_NamePropertyId | Zobacz uwagi. | Kontrolka kalendarza zazwyczaj pobiera nazwę z bieżącej daty. |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi wszystkich kontrolek kalendarza. 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 |
|---|---|---|
| IGridProvider | Wymagane | Kontrolka kalendarza zawsze obsługuje wzorzec kontrolki Grid, 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. Aby obsługiwać nawigację stronicowania, zaleca się wzorzec kontrolki przewijania . |
| ISelectionProvider | Zależy | Większość kontrolek kalendarza zachowuje określony dzień, miesiąc lub rok jako wybór podelementu. Niektóre kalendarze można wybierać z wieloma opcjami, a inne można wybierać tylko jednokrotnie. Kontrolka kalendarza z wybranymi podelementami powinna obsługiwać wzorzec kontrolki Selection. |
| ITableProvider | Wymagane | Ponieważ kontrolka kalendarza zawsze zawiera nagłówek w poddrzewie w dniach tygodnia, wzorzec kontrolki tabeli musi być obsługiwany. |
| IValueProvider | Nie | Wzorzec kontrolki Value nie jest konieczny dla kontrolek kalendarza, ponieważ element nie może ustawić wartości bezpośrednio na kontrolce. Jeśli określona data jest skojarzona z kontrolką, informacje powinny być udostępniane przez wzorzec kontrolki Selection. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi kontrolek kalendarza. Aby uzyskać więcej informacji na temat zdarzeń, zobacz Omówienie zdarzeń automatyzacji interfejsu użytkownika.
| Zdarzenie automatyzacji interfejsu użytkownika | Notatki |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId zdarzenie zmienione właściwości. | |
| UIA_IsEnabledPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsEnabled, musi obsługiwać to zdarzenie. |
| UIA_IsOffscreenPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsOffscreen, musi obsługiwać to zdarzenie. |
| UIA_LayoutInvalidatedEventId | |
| UIA_MultipleViewCurrentViewPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość CurrentView wzorca kontrolki MultipleView, musi obsługiwać to zdarzenie. |
| UIA_StructureChangedEventId | |
| UIA_ScrollHorizontallyScrollablePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie. |
| UIA_ScrollHorizontalScrollPercentPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie. |
| UIA_ScrollHorizontalViewSizePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie. |
| UIA_ScrollVerticalScrollPercentPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie. |
| UIA_ScrollVerticallyScrollablePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie. |
| UIA_ScrollVerticalViewSizePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki przewijania przewijania, musi obsługiwać to zdarzenie. |
| UIA_Selection_InvalidatedEventId |
Tematy pokrewne