Tipo di controllo del calendario

  • Articolo

Questo argomento fornisce informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo Calendar. Un controllo calendario consente all'utente di determinare facilmente la data e selezionare altre date.

Le sezioni seguenti definiscono la struttura ad albero Automazione interfaccia utente, le proprietà, i modelli di controllo e gli eventi necessari per il tipo di controllo Calendario. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli del calendario in cui il framework dell'interfaccia utente/piattaforma integra Automazione interfaccia utente supporto per i tipi di controllo e i modelli di controllo.

In questo argomento sono contenute le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra una visualizzazione tipica del controllo e del contenuto dell'albero Automazione interfaccia utente che riguarda i controlli del calendario e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero Automazione interfaccia utente, vedere Panoramica dell'albero Automazione interfaccia utente.

Visualizzazione controlli Visualizzazione contenuto
  • Calendario
    • DataGrid
      • Header (0 o 1)
        • HeaderItem (0 o 7, quantità dipende dal numero di giorni visualizzati nelle colonne)
      • ListItem (la quantità dipende dal numero di giorni visualizzati)
      • Button (0 o 2; per la visualizzazione delle diverse pagine del calendario)
  • Calendario
    • ListItem (la quantità dipende dal numero di giorni visualizzati)

 

I controlli Calendario possono essere rappresentati in formati diversi all'interno dell'interfaccia utente. Gli unici controlli garantiti per essere nella visualizzazione di controllo dell'albero Automazione interfaccia utente sono la griglia dati, l'intestazione, l'elemento di intestazione e i controlli dell'elemento di elenco.

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o la definizione sono particolarmente rilevanti per il tipo di controllo Calendario. Per altre informazioni sulle proprietà Automazione interfaccia utente, vedere Recupero delle proprietà da elementi Automazione interfaccia utente.

Proprietà di automazione interfaccia utente 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 Automazione interfaccia utente.
UIA_BoundingRectanglePropertyId Vedere le note. Il rettangolo più esterno che contiene l'intero controllo.
UIA_ClickablePointPropertyId Vedere le note. Supportata se è presente un rettangolo di delimitazione. Se non ogni punto all'interno del rettangolo di selezione è selezionabile e l'elemento esegue test di hit test specializzati, override e fornisce un punto clickable.
UIA_ControlTypePropertyId Calendario Questo valore è uguale per tutti i framework dell'interfaccia utente.
UIA_IsContentElementPropertyId TRUE Il controllo calendario è sempre incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente.
UIA_IsControlElementPropertyId TRUE Il controllo calendario è sempre incluso nella visualizzazione controllo dell'albero Automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il controllo può ricevere lo stato attivo, 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 è "calendar" 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

Nella tabella seguente sono elencati i modelli di controllo 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.

Pattern di controllo/proprietà del pattern Supporto/valore Note
IGridProvider Necessario Il controllo calendario supporta sempre il modello di controllo Griglia perché i giorni entro un mese sono elementi che possono essere spostati nello spazio.
IScrollProvider Dipende da La maggior parte dei controlli Calendario supporta lo scorrimento della visualizzazione per pagina. Il modello di controllo Scroll è consigliato per supportare lo spostamento del paging.
ISelectionProvider Dipende da La maggior parte dei controlli del calendario mantiene un giorno, un mese o un anno specifico come selezione del sottoelemento. Alcuni calendari sono selezionabili e altri solo selezionabili a selezione singola. Il controllo calendario con sottoelementi selezionabili deve supportare il modello di controllo Selezione .
ITableProvider Necessario Poiché il controllo calendario ha sempre un'intestazione all'interno del relativo sottoalbero per i giorni della settimana, è necessario supportare il modello di controllo Tabella .
IValueProvider No Il modello di controllo Valore non è necessario per i controlli del calendario perché l'elemento non può impostare il valore direttamente sul controllo. Se una data specifica è associata al controllo, le informazioni devono essere fornite dal modello di controllo Selezione .

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per il supporto dei controlli del calendario. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.

Automazione interfaccia utente evento Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento modificato dalla proprietà.
UIA_IsEnabledPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento.
UIA_IsOffscreenPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento.
UIA_LayoutInvalidatedEventId
UIA_MultipleViewCurrentViewPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà CurrentView del modello di controllo MultipleView , deve supportare questo evento.
UIA_StructureChangedEventId
UIA_ScrollHorizontallyScrollablePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento.
UIA_ScrollHorizontalScrollPercentPropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento.
UIA_ScrollHorizontalViewSizePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento.
UIA_ScrollVerticalScrollPercentPropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento.
UIA_ScrollVerticallyScrollablePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento.
UIA_ScrollVerticalViewSizePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento.
UIA_Selection_InvalidatedEventId

 

Informazioni concettuali

Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente

Cenni preliminari su automazione interfaccia utente