Supporto di automazione interfaccia utente per il tipo di controllo Tab
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.
Questo argomento fornisce informazioni sul supporto per Automazione interfaccia utente per il tipo di controllo Tab. 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, i valori delle proprietà di Automazione interfaccia utente e Automazione interfaccia utente. .
Un controllo Struttura a schede è simile ai separatori in un blocco per appunti o alle etichette in un archivio. L'uso del controllo Struttura a schede consente a un'applicazione di definire più pagine per la stessa area di una finestra o una finestra di dialogo.
Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i criteri di controllo e gli eventi di Automazione interfaccia utente previsti per il tipo di controllo Tab. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli scheda, siano essi Windows Presentation Foundation (WPF), Win32 o Windows Form.
Struttura ad albero di automazione interfaccia utente obbligatoria
La tabella seguente mostra la vista controllo e la vista contenuto dell'albero di Automazione interfaccia utente che riguarda i controlli scheda e descrive cosa può essere contenuto in ogni vista. Per altre informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
Tab
|
Tab - TabItem (1 o più) |
I controlli scheda includono elementi figlio di Automazione interfaccia utente in base al tipo di controllo TabItem. Quando gli elementi della struttura a schede vengono raggruppati, ad esempio nelle applicazioni di Microsoft Office 2007, il tipo di controllo Tab può ospitare anche tipi di controllo Groups per gli elementi della struttura a schede raggruppati, come illustrato nella struttura ad albero seguente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
Tab
|
Tab
|
Proprietà di automazione interfaccia utente obbligatorie
La tabella seguente elenca le proprietà di Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per il tipo di controllo Tab. 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. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| NameProperty | Vedere le note. | Il controllo Struttura a schede raramente richiede una proprietà Name. |
| ClickablePointProperty | No | Il controllo Struttura a schede non dispone di un punto selezionabile. |
| LabeledByProperty | Vedere le note. | I controlli Struttura a schede in genere includono un'etichetta di testo statico che viene esposta tramite questa proprietà. |
| ControlTypeProperty | Tab | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "tab" | Stringa localizzata corrispondente al tipo di controllo Tab. |
| IsKeyboardFocusableProperty | Vero | Il tipo di controllo Tab deve essere in grado di ricevere lo stato attivo. In genere, un client di Automazione interfaccia utente chiama SetFocus su un controllo scheda e uno dei suoi elementi trasferirà lo stato attivo della tastiera al controllo scheda. È possibile che alcuni contenitori di schede assumano lo stato attivo senza che lo stato attivo venga impostato su uno dei relativi elementi. |
| IsContentElementProperty | Vero | Il controllo scheda è sempre incluso nella vista contenuto dell'albero di Automazione interfaccia utente. |
| IsControlElementProperty | Vero | Il controllo scheda è sempre incluso nella vista controllo dell'albero di Automazione interfaccia utente. |
| OrientationProperty | Vedere le note. | Il controllo Struttura a schede deve sempre indicare se è posizionato orizzontalmente o verticalmente. |
Pattern di controllo e proprietà obbligatori per l'automazione interfaccia utente
La tabella seguente elenca i criteri di controllo di Automazione interfaccia utente che devono essere supportati da tutti i controlli scheda. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo/proprietà del pattern | Supporto/valore | Note |
|---|---|---|
| ISelectionProvider | Sì | Tutti i controlli Struttura a schede devono supportare il pattern Selection. |
| IsSelectionRequired | Vero | I controlli Struttura a schede richiedono sempre una selezione. |
| CanSelectMultiple | Falso | I controlli Struttura a schede sono sempre contenitori a selezione singola. |
| IScrollProvider | Dipende da | Il pattern Scroll deve essere supportato nel controllo Struttura a schede contenente widget che consentono lo scorrimento di un set di elementi della struttura a schede. |
Eventi di automazione interfaccia utente obbligatori
La tabella seguente elenca gli eventi di Automazione interfaccia utente che devono essere supportati da tutti i controlli scheda. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di Automazione interfaccia utente | Supporto tecnico | Note |
|---|---|---|
| Evento di modifica della proprietàBoundingRectangleProperty . | Richiesto | None |
| Evento di modifica della proprietàIsOffscreenProperty . | Richiesto | None |
| Evento di modifica della proprietàIsEnabledProperty . | Richiesto | None |
| Evento di modifica della proprietàHorizontallyScrollableProperty . | Dipende da | None |
| Evento di modifica della proprietàHorizontalScrollPercentProperty . | Dipende da | None |
| Evento di modifica della proprietàHorizontallyScrollableProperty . | Dipende da | None |
| Evento di modifica della proprietàHorizontalViewSizeProperty . | Dipende da | None |
| Evento di modifica della proprietàVerticalScrollPercentProperty . | Dipende da | None |
| Evento di modifica della proprietàVerticalViewSizeProperty . | Dipende da | None |
| AutomationFocusChangedEvent | Richiesto | None |
| StructureChangedEvent | Richiesto | None |