Supporto di automazione interfaccia utente per il tipo di controllo Calendar
Nota
Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di Automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su Automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente per il tipo di controllo Calendario. In Automazione interfaccia utente, un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare per poter utilizzare la proprietà ControlTypeProperty. Le condizioni includono linee guida specifiche per la struttura ad albero di Automazione interfaccia utente con i rispettivi valori, i modelli di controllo e gli eventi.
I controlli Calendario consentono all'utente di determinare la data e selezionare altre date in modo semplice e rapido.
Le seguenti sezioni definiscono la struttura ad albero, le proprietà, i criteri di controllo e gli eventi di Automazione interfaccia necessari per il tipo di controllo Calendario. I requisiti di automazione interfaccia utente si applicano a tutti i controlli del calendario, indipendentemente da Windows Presentation Foundation (WPF), Win32 o Windows Form.
Struttura ad albero di automazione interfaccia utente obbligatoria
La tabella seguente illustra la vista controllo e la vista contenuto dell'albero di Automazione interfaccia utente che riguarda i controlli barra menu e descrive cosa può essere contenuto in ogni vista. Per maggiori informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell’albero di Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
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 nella vista controlli dell'albero di Automazione interfaccia utente sono i controlli griglia dati, intestazione, elemento intestazione ed elemento elenco.
Proprietà di automazione interfaccia utente obbligatorie
La seguente tabella elenca le proprietà di Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli barra menu. Per maggiori 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 in tutti i controlli in un'applicazione. |
| BoundingRectangleProperty | Vedere le note. | Il rettangolo più esterno che contiene l'intero controllo. |
| ClickablePointProperty | Vedere le note. | Supportata se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili ed è stato eseguito un processo di hit testing specializzato, eseguire l'override e implementare un punto selezionabile. |
| ControlTypeProperty | Calendario | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| IsContentElementProperty | Vero | Il controllo barra menu è sempre incluso nella vista contenuto dell'albero di Automazione interfaccia utente. |
| IsControlElementProperty | Vero | Il controllo calendario è sempre incluso nella vista controllo dell'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. | Etichetta del controllo del documento. In genere, viene usato il titolo del documento. |
| LocalizedControlTypeProperty | "calendar" | Stringa localizzata corrispondente al tipo di controllo Calendar. |
| NameProperty | Vedere le note. | Il controllo Calendario assume in genere il nome dalla data del giorno corrente. |
Pattern di controllo obbligatori per l'automazione interfaccia utente
La seguente tabella elenca i criteri di controllo di Automazione interfaccia utente che devono essere supportati da tutti i controlli calendario. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo/proprietà del pattern | Supporto tecnico | Note |
|---|---|---|
| IGridProvider | Sì | Il controllo Calendario supporta sempre il pattern Grid perché i giorni all'interno di un mese sono elementi che possono essere visualizzati dal punto di vista dello spazio. |
| IScrollProvider | Dipende da | La maggior parte dei controlli Calendario supporta lo scorrimento della visualizzazione per pagina. È consigliabile usare il pattern Scroll per supportare la navigazione tra diverse pagine. |
| ISelectionProvider | Dipende da | La maggior parte dei controlli Calendario conserva un determinato giorno, mese o anno come selezione del sottoelemento. Alcuni calendari supportano selezioni multiple, mentre altri supportano solo una selezione singola. |
| ITableProvider | Sì | Il Controllo calendario ha sempre un'intestazione all'interno del relativo sottoalbero per i giorni della settimana. Per tale motivo, il pattern Table deve essere supportato. |
| IValueProvider | No | Il pattern di controllo Value non è necessario per i controlli Calendario perché non è possibile impostare il valore direttamente nel controllo. Se al controllo è associata una data specifica, le informazioni devono essere fornite dal pattern di controllo Selection. |
Eventi di automazione interfaccia utente obbligatori
La seguente tabella elenca gli eventi di Automazione interfaccia utente che devono essere supportati da tutti i controlli calendario. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di Automazione interfaccia utente | Supporto tecnico | Note |
|---|---|---|
| AutomationFocusChangedEvent | Richiesto | None |
| Evento di modifica della proprietàBoundingRectangleProperty . | Richiesto | None |
| Evento di modifica della proprietàIsEnabledProperty . | Richiesto | None |
| Evento di modifica della proprietàIsOffscreenProperty . | Richiesto | None |
| LayoutInvalidatedEvent | Richiesto | None |
| StructureChangedEvent | Richiesto | None |
| Evento di modifica della proprietàCurrentViewProperty . | Dipende da | None |
| Evento di modifica della proprietàHorizontallyScrollableProperty . | Dipende da | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| Evento di modifica della proprietàHorizontalScrollPercentProperty . | Dipende da | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| Evento di modifica della proprietàHorizontalViewSizeProperty . | Dipende da | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| Evento di modifica della proprietàVerticalScrollPercentProperty . | Dipende da | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| Evento di modifica della proprietàVerticallyScrollableProperty . | Dipende da | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| Evento di modifica della proprietàVerticalViewSizeProperty . | Dipende da | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| InvalidatedEvent | Richiesto | None |