Tipo di controllo calendario
Questo argomento fornisce informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo Calendario. Un controllo calendario consente all'utente di determinare facilmente la data e selezionare altre date.
Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i pattern di controllo e gli eventi necessari per il Calendario tipo di controllo. I requisiti di automazione interfaccia utente si applicano a tutti i controlli del calendario in cui il framework o la piattaforma dell'interfaccia utente integra il supporto di Automazione interfaccia utente per i tipi di controllo e i pattern di controllo.
Questo argomento contiene le sezioni seguenti.
- struttura ad albero tipica
- proprietà rilevanti
- modelli di controllo necessari
- eventi obbligatori
- argomenti correlati
Struttura ad albero tipica
La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero di automazione interfaccia utente che riguarda i controlli del calendario e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
|
|
I controlli calendario possono essere rappresentati in molti moduli diversi all'interno dell'interfaccia utente. Gli unici controlli garantiti nella visualizzazione controllo dell'albero di Automazione interfaccia utente sono i controlli griglia dati, intestazione, elemento di intestazione e elemento di elenco.
Proprietà pertinenti
Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per il tipo di controllo Calendario. Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Recupero delle proprietà dagli elementi di automazione interfaccia utente.
| Ui Automation, proprietà | Valore | Note |
|---|---|---|
| UIA_AutomationIdPropertyId | Vedere le note. | Il valore di questa proprietà deve essere univoco tra tutti gli elementi peer nella visualizzazione non elaborata dell'albero di automazione interfaccia utente. |
| UIA_BoundingRectanglePropertyId | Vedere le note. | Rettangolo più esterno che contiene l'intero controllo. |
| UIA_ClickablePointPropertyId | Vedere le note. | Supportato se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e l'elemento esegue un hit testing specializzato, eseguire l'override e fornire un punto selezionabile. |
| UIA_ControlTypePropertyId | Calendario | Questo valore è lo stesso per tutti i framework dell'interfaccia utente. |
| UIA_IsContentElementPropertyId | VERO | Il controllo calendario è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente. |
| UIA_IsControlElementPropertyId | VERO | Il controllo calendario è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente. |
| UIA_IsKeyboardFocusablePropertyId | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. |
| UIA_LabeledByPropertyId | Vedere le note. | Il valore di questa proprietà deve essere l'etichetta del controllo documento. In genere, viene usato il titolo del documento. |
| UIA_LocalizedControlTypePropertyId | Vedere le note. | Stringa localizzata corrispondente al tipo di controllo Calendario. Il valore predefinito è "calendario" per en-US o inglese (Stati Uniti). |
| UIA_NamePropertyId | Vedere le note. | Il controllo calendario ottiene in genere il nome dalla data corrente. |
Modelli di controllo obbligatori
La tabella seguente elenca i pattern di controllo di automazione interfaccia utente necessari per essere supportati da tutti i controlli del calendario. Per altre informazioni sui pattern di controllo, vedere ui Automation Control Patterns Overview.For more information on control patterns, see UI Automation Control Patterns Overview.
| Pattern di controllo/pattern, proprietà | Supporto/valore | Note |
|---|---|---|
| IGridProvider | Obbligatorio | Il controllo calendario supporta sempre il pattern di controllo Grid perché i giorni entro un mese sono elementi che possono essere spostati nello spazio. |
| IScrollProvider | Dipende | La maggior parte dei controlli del calendario supporta lo scorrimento della visualizzazione per pagina. Per supportare lo spostamento tramite paging, è consigliabile usare il pattern di controllo Scroll. |
| ISelectionProvider | Dipende | La maggior parte dei controlli del calendario mantiene un giorno, un mese o un anno specifico come selezione del sottoelemento. Alcuni calendari sono selezionabili in più e altri solo selezionabili a selezione singola. Il controllo calendario con sottoelementi selezionabili deve supportare il pattern di controllo Selection. |
| ITableProvider | Obbligatorio | Poiché il controllo calendario ha sempre un'intestazione all'interno del relativo sottoalbero per i giorni della settimana, è necessario supportare il pattern di controllo tabella. |
| IValueProvider | No | Il pattern di controllo Value non è necessario per i controlli calendario perché l'elemento non può impostare il valore direttamente sul controllo. Se al controllo è associata una data specifica, le informazioni devono essere fornite dal pattern di controllo selezione. |
Eventi obbligatori
Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente necessari per supportare i controlli del calendario. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .
| Evento di automazione interfaccia utente | Note |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento di modifica delle proprietà. | |
| UIA_IsEnabledPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietàIsEnabled, deve supportare questo evento. |
| UIA_IsOffscreenPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietàIsOffscreen, deve supportare questo evento. |
| UIA_LayoutInvalidatedEventId | |
| UIA_MultipleViewCurrentViewPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietàCurrentView del pattern di controllo MultipleView, deve supportare questo evento. |
| UIA_StructureChangedEventId | |
| UIA_ScrollHorizontallyScrollablePropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| UIA_ScrollHorizontalScrollPercentPropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| UIA_ScrollHorizontalViewSizePropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| UIA_ScrollVerticalScrollPercentPropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| UIA_ScrollVerticallyScrollablePropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| UIA_ScrollVerticalViewSizePropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| UIA_Selection_InvalidatedEventId |
Argomenti correlati