Supporto di automazione interfaccia utente per il tipo di controllo Tab

Nota
La presente documentazione è destinata agli sviluppatori di .NET Framework che desiderano utilizzare le classi UI Automation gestite definite nello spazio dei nomi System.Windows.Automation.Per informazioni aggiornate sull'UI Automation, vedere Windows Automation API: Automazione interfaccia utente (la pagina potrebbe essere in inglese).

In questo argomento vengono fornite informazioni sul supporto di UI Automation per il tipo di controllo Tab. In UI Automation 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 UI Automation, i valori delle proprietà di UI Automation e i pattern di controllo di UI Automation.

Un controllo scheda è analogo ai divisori di un quaderno o alle etichette di uno schedario. Utilizzando un controllo scheda, un'applicazione può definire più pagine per la stessa area di una finestra o finestra di dialogo.

Nelle sezioni seguenti vengono definiti la struttura ad albero, le proprietà, i pattern di controllo e gli eventi di UI Automation necessari per il tipo di controllo Tab. I requisiti di UI Automation si applicano a tutti i controlli scheda, sia Windows Presentation Foundation (WPF), Win32 che Windows Forms.

Nel presente argomento sono contenute le seguenti sezioni.

• Struttura ad albero di automazione interfaccia utente obbligatoria
• Proprietà di automazione interfaccia utente richieste
• Proprietà e 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 UI Automation relativamente ai controlli scheda e viene descritto il contenuto di ogni visualizzazione. Per ulteriori informazioni sulla struttura ad albero di UI Automation, vedere Cenni preliminari sulla struttura ad albero di automazione dell'interfaccia utente.

Visualizzazione controlli	Visualizzazione contenuto
Tab TabItem (1 o più) ScrollBar (0 o 1) Button (0 o 2)	Tab TabItem (1 o più)

I controlli scheda includono elementi figlio di UI Automation basati sul tipo di controllo Tab Item. Quando gli elementi della scheda sono raggruppati (ad esempio, come nelle applicazioni Microsoft Office 2007, il tipo di controllo Tab può anche contenere tipi di controllo di Group per gli elementi della scheda raggruppati, come illustrato nella struttura ad albero seguente.

Visualizzazione controlli	Visualizzazione contenuto
Tab TabItem (1 o più) Gruppo (0 o più) TabItem (0 o più) ScrollBar (0 o più) Button (0 o 2)	Tab TabItem (1 o più) Gruppo (0 o più) TabItem (0 o più)

Proprietà di automazione interfaccia utente richieste

Nella tabella seguente sono elencate le proprietà di UI Automation il cui valore o la cui definizione è particolarmente rilevante per il tipo di controllo Tab. Per ulteriori informazioni sulle proprietà dell'UI Automation, vedere Proprietà di automazione interfaccia utente per i client.

Proprietà di UI Automation	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.
IsKeyboardFocusableProperty	Vedere le note.	Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà.
NameProperty	Vedere le note.	Il controllo scheda raramente richiede una proprietà Name.
ClickablePointProperty	No	Il controllo scheda non ha un punto selezionabile.
LabeledByProperty	Vedere le note.	I controlli scheda includono in genere un'etichetta di testo statica esposta tramite questa proprietà.
ControlTypeProperty	Tab	Questo valore è identico per tutti i framework dell'interfaccia utente.
LocalizedControlTypeProperty	"scheda"	Stringa localizzata che corrisponde al tipo di controllo Tab.
IsKeyboardFocusableProperty	True	Il tipo di controllo Tab deve essere in grado di ricevere lo stato attivo. In genere, un client di UI Automation chiama SetFocus su un controllo scheda e uno dei relativi elementi inoltra lo stato attivo al controllo scheda. È possibile che alcuni contenitori di schede ricevano lo stato attivo senza impostarlo su uno dei relativi elementi.
IsContentElementProperty	True	Il controllo scheda è sempre incluso nella visualizzazione contenuto della struttura ad albero di UI Automation.
IsControlElementProperty	True	Il controllo scheda è sempre incluso nella visualizzazione controlli della struttura ad albero di UI Automation.
OrientationProperty	Vedere le note.	Il controllo scheda deve sempre indicare se è posizionato orizzontalmente o verticalmente.

Proprietà e pattern di controllo di automazione interfaccia utente obbligatori

Nella tabella seguente sono elencati i pattern di controllo di UI Automation che devono essere supportati da tutti i controlli scheda. 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
ISelectionProvider	Sì	Tutti i controlli scheda devono supportare il modello Selection.
IsSelectionRequired	True	I controlli scheda richiedono sempre che sia eseguita una selezione.
CanSelectMultiple	False	I controlli scheda sono sempre contenitori a selezione singola.
IScrollProvider	A seconda dei casi	Il modello Scroll deve essere supportato se il controllo scheda include widget che consentono di scorrere un insieme di elementi della scheda.

Eventi di automazione interfaccia utente obbligatori

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

Evento UI Automation	Supporto	Note
Evento di proprietà modificata BoundingRectangleProperty.	Obbligatorio	Nessuno
Evento di proprietà modificata IsOffscreenProperty.	Obbligatorio	Nessuno
Evento di proprietà modificata IsEnabledProperty.	Obbligatorio	Nessuno
Evento di proprietà modificata HorizontallyScrollableProperty.	A seconda dei casi	Nessuno
Evento di proprietà modificata HorizontalScrollPercentProperty.	A seconda dei casi	Nessuno
Evento di proprietà modificata HorizontallyScrollableProperty.	A seconda dei casi	Nessuno
Evento di proprietà modificata HorizontalViewSizeProperty.	A seconda dei casi	Nessuno
Evento di proprietà modificata VerticalScrollPercentProperty.	A seconda dei casi	Nessuno
Evento di proprietà modificata VerticalViewSizeProperty.	A seconda dei casi	Nessuno
AutomationFocusChangedEvent	Obbligatorio	Nessuno
StructureChangedEvent	Obbligatorio	Nessuno

Vedere anche

Riferimenti

Tab

Concetti

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

Cenni preliminari su automazione interfaccia utente