Supporto di automazione interfaccia utente per il tipo di controllo Calendar

Aggiornamento: novembre 2007

In questo argomento vengono fornite informazioni sul supporto di automazione interfaccia utente per il tipo di controllo Calendar. In automazione interfaccia utente un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare al fine di utilizzare la proprietà ControlTypeProperty. Le condizioni includono linee guida specifiche per la struttura ad albero di automazione interfaccia utente, i valori delle proprietà di automazione interfaccia utente, i pattern di controllo e gli eventi di automazione interfaccia utente.

I controlli calendario consentono di determinare facilmente la data e di selezionare altre date.

Nelle sezioni seguenti vengono definiti la struttura ad albero, le proprietà, i pattern di controllo e gli eventi di automazione interfaccia utente necessari per il tipo di controllo Calendar. I requisiti di automazione interfaccia utente si applicano a tutti i controlli calendario, sia Windows Presentation Foundation (WPF), Win32 che Windows Form.

Nel presente argomento sono contenute le seguenti sezioni.

Struttura ad albero di automazione interfaccia utente obbligatoria
Proprietà di automazione interfaccia utente obbligatorie
Pattern di controllo di automazione interfaccia utente obbligatori
Eventi di automazione interfaccia utente obbligatori
Argomenti correlati

Struttura ad albero di automazione interfaccia utente obbligatoria

Nella tabella riportata di seguito vengono illustrate la visualizzazione controlli e la visualizzazione contenuto della struttura ad albero di automazione interfaccia utente relativamente ai controlli calendario e viene descritto il contenuto di ogni visualizzazione. Per ulteriori informazioni sulla struttura ad albero di automazione interfaccia utente, vedere Cenni preliminari sulla struttura di automazione dell'interfaccia utente.

Visualizzazione controlli	Visualizzazione contenuto
Calendar DataGrid Header (elemento figlio di DataGrid) HeaderItem (elemento figlio di Header; la quantità dipende dal numero di giorni visualizzati) ListItem (elemento figlio di Header; la quantità dipende dal numero di giorni visualizzati) Button (elemento figlio di DataGrid; 0 o 2)	Calendar ListItem (la quantità dipende dal numero di giorni visualizzati)

I controlli calendario possono essere rappresentati in molte forme diverse all'interno dell'interfaccia utente. Gli unici controlli sempre presenti nella visualizzazione controlli di automazione interfaccia utente sono i controlli griglia dei dati, voce di intestazione e elemento dell'elenco.

Proprietà di automazione interfaccia utente obbligatorie

Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o la cui definizione è particolarmente rilevante per i controlli calendario. Per ulteriori informazioni sulle proprietà di automazione interfaccia utente, vedere Proprietà di automazione interfaccia utente per i client.

Proprietà di automazione interfaccia utente	Valore	Note
AutomationIdProperty()	Vedere le note.	Il valore di questa proprietà deve essere univoco per tutti i controlli di un'applicazione.
BoundingRectangleProperty	Vedere le note.	Il rettangolo più esterno che contiene l'intero controllo.
ClickablePointProperty	Vedere le note.	Supportata se esiste un rettangolo di delimitazione. Se non è possibile fare clic su ogni punto all'interno del rettangolo di delimitazione e vengono eseguiti hit test speciali, eseguire l'override e fornire un punto selezionabile.
ControlTypeProperty	Calendar	Questo valore è identico per tutti i framework dell'interfaccia utente.
IsContentElementProperty	True	Il controllo calendario è sempre incluso nella visualizzazione contenuto della struttura ad albero di automazione interfaccia utente.
IsControlElementProperty	True	Il controllo calendario è sempre incluso nella visualizzazione controlli della struttura ad albero di automazione interfaccia utente.
IsKeyboardFocusableProperty	Vedere le note.	Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà.
LabeledByProperty	Vedere le note.	Se è presente un'etichetta di testo statica, questa proprietà deve esporre un riferimento a tale controllo.
LocalizedControlTypeProperty	"calendario"	Stringa localizzata che corrisponde al tipo di controllo Calendar.
NameProperty	Vedere le note.	Il controllo calendario ottiene in genere il nome dalla data odierna.

Pattern di controllo di automazione interfaccia utente obbligatori

Nella tabella seguente sono elencati i pattern di controllo di automazione interfaccia utente che devono essere supportati da tutti i controlli calendario. Per ulteriori informazioni sui pattern di controllo, vedere Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente.

Pattern di controllo/Proprietà pattern	Supporto/Valore	Note
IGridProvider	Sì	Il controllo calendario supporta sempre il modello Grid perché i giorni all'interno di un mese sono elementi in cui è possibile spostarsi spazialmente.
IScrollProvider	A seconda dei casi	La possibilità di scorrere il calendario varia a seconda che consenta o meno lo spostamento ad altri mesi senza modificare lo stato del controllo.
ISelectionProvider	Sì	Tutti i controlli calendario contengono elementi che rappresentano i giorni della settimana che sono selezionabili. Alcuni calendari consentono selezioni multiple, mentre altri una selezione singola.
ITableProvider	Sì	Il controllo calendario include sempre un'intestazione all'interno del proprio sottoalbero per i giorni della settimana, pertanto il modello Table deve essere supportato.
IValueProvider	No	Il modello Value non è necessario per i controlli calendario, perché non è possibile impostare direttamente il valore sul controllo. Tutte le informazioni sono fornite dal modello Selection.

Eventi di automazione interfaccia utente obbligatori

Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente che devono essere supportati da tutti i controlli calendario. Per ulteriori informazioni sugli eventi, vedere Cenni preliminari sugli eventi di automazione interfaccia utente.

Evento di automazione interfaccia utente	Supporto/Valore	Note
AutomationFocusChangedEvent	Obbligatorio	Nessuna
Evento di proprietà modificata BoundingRectangleProperty.	Obbligatorio	Nessuna
Evento di proprietà modificata IsEnabledProperty.	Obbligatorio	Nessuna
Evento di proprietà modificata IsOffscreenProperty.	Obbligatorio	Nessuna
LayoutInvalidatedEvent	Obbligatorio	Nessuna
StructureChangedEvent	Obbligatorio	Nessuna
Evento di proprietà modificata CurrentViewProperty.	A seconda dei casi	Nessuna
Evento di proprietà modificata HorizontallyScrollableProperty.	A seconda dei casi	Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento.
Evento di proprietà modificata HorizontalScrollPercentProperty.	A seconda dei casi	Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento.
Evento di proprietà modificata HorizontalViewSizeProperty.	A seconda dei casi	Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento.
Evento di proprietà modificata VerticalScrollPercentProperty.	A seconda dei casi	Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento.
Evento di proprietà modificata VerticallyScrollableProperty.	A seconda dei casi	Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento.
Evento di proprietà modificata VerticalViewSizeProperty.	A seconda dei casi	Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento.
InvalidatedEvent	Obbligatorio	Nessuna

Vedere anche

Concetti

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

Cenni preliminari su automazione interfaccia utente

Riferimenti

Calendar

Last updated on 2008-09-12