Condividi tramite


Supporto dell'automazione dell'interfaccia utente per il tipo di controllo a schede

Annotazioni

Questa documentazione è destinata agli sviluppatori .NET Framework che vogliono usare le classi di automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per le informazioni più recenti sull'automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.

In questo argomento vengono fornite informazioni sul supporto dell'automazione interfaccia utente per il tipo di controllo Tab. In Automazione interfaccia utente un tipo di controllo è un set di condizioni che un controllo deve soddisfare per usare la ControlTypeProperty proprietà . Le condizioni includono linee guida specifiche per la struttura ad albero di automazione interfaccia utente, i valori delle proprietà di automazione interfaccia utente e l'automazione interfaccia utente. modelli di controllo.

Un controllo struttura a schede è analogo ai divisori in un notebook o alle etichette in un file cab. 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 di automazione interfaccia utente, le proprietà, i pattern di controllo e gli eventi necessari per il tipo di controllo Tab. I requisiti di automazione interfaccia utente si applicano a tutti i controlli struttura a schede, ovvero Windows Presentation Foundation (WPF), Win32 o Windows Form.

Struttura ad albero necessaria per l'automazione UI

La tabella seguente illustra la vista di controllo e la vista di contenuto dell'albero di automazione dell'interfaccia utente relativa ai controlli delle schede e descrive cosa può essere contenuto in ogni vista. Per ulteriori informazioni sull'albero di automazione dell'interfaccia utente, vedere Panoramica dell'albero di automazione interfaccia utente.

Vista di controllo Visualizzazione contenuto
Scheda

  • TabItem (1 o più)
  • ScrollBar (0 o 1)

    • Pulsante (0 o 2)
Scheda

- TabItem (1 o più)

I controlli Tab hanno elementi figlio dell'Automazione interfaccia utente basati sul tipo di controllo Tab Item. Quando gli elementi di tabulazione sono raggruppati (ad esempio, come nelle applicazioni di Microsoft Office 2007), il tipo di controllo Tab può ospitare anche i tipi di controllo Gruppi per gli elementi di tabulazione raggruppati, come illustrato nella struttura ad albero seguente.

Vista di controllo Visualizzazione contenuto
Scheda

  • TabItem (1 o più)
  • Gruppo (0 o più)

    • TabItem (0 o più)
  • ScrollBar (0 o più)

    • Pulsante (0 o 2)
Scheda

  • TabItem (1 o più)
  • Gruppo (0 o più)

    • TabItem (0 o più)

Proprietà di automazione interfaccia utente necessarie

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

Ui Automation, proprietà Valore Note
AutomationIdProperty Vedere le note. Il valore di questa proprietà deve essere univoco in tutti i controlli di un'applicazione.
BoundingRectangleProperty Vedere le note. Rettangolo più esterno che contiene l'intero controllo.
IsKeyboardFocusableProperty Vedere le note. Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà.
NameProperty Vedere le note. Il controllo schede richiede raramente la proprietà Name.
ClickablePointProperty NO Il controllo schede non dispone di un punto cliccabile.
LabeledByProperty Vedere le note. I controlli Struttura a schede hanno in genere un'etichetta di testo statica esposta tramite questa proprietà.
ControlTypeProperty Scheda Questo valore è lo stesso per tutti i framework dell'interfaccia utente.
LocalizedControlTypeProperty scheda Stringa localizzata corrispondente al tipo di controllo Tab.
IsKeyboardFocusableProperty Vero Il tipo di controllo Tab deve essere in grado di ricevere lo stato attivo della tastiera. Di solito, un client di automazione dell'interfaccia utente chiama SetFocus su un controllo a schede e uno dei relativi elementi inoltra lo stato attivo della tastiera al controllo a schede. È possibile che alcuni contenitori di schede prendano lo stato attivo senza impostare lo stato attivo su uno dei relativi elementi.
IsContentElementProperty Vero Il controllo struttura a schede è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente.
IsControlElementProperty Vero Il controllo struttura a schede è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente.
OrientationProperty Vedere le note. Il controllo struttura a schede deve sempre indicare se è posizionato orizzontalmente o verticalmente.

Schemi di controllo e proprietà necessari per l'automazione interfaccia utente

La tabella seguente elenca i pattern di controllo di automazione interfaccia utente necessari per essere supportati da tutti i controlli struttura a schede. Per altre informazioni sui pattern di controllo, vedere ui Automation Control Patterns Overview.For more information on control patterns, see UI Automation Control Patterns Overview.

Pattern di controllo/pattern, proprietà Supporto/valore Note
ISelectionProvider Tutti i controlli a schede devono supportare il Pattern di selezione.
IsSelectionRequired Vero I controlli Tab richiedono sempre che venga effettuata una selezione.
CanSelectMultiple Falso I controlli Tab sono sempre contenitori a selezione singola.
IScrollProvider Dipende da Il pattern Scroll deve essere supportato nel controllo a schede, che ha widget che consentono lo scorrimento attraverso un insieme di elementi di scheda.

Eventi di automazione interfaccia utente necessari

La tabella seguente elenca gli eventi di automazione interfaccia utente che devono essere supportati da tutti i controlli struttura a schede. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .

Evento di automazione interfaccia utente Assistenza Note
Evento di cambiamento della proprietà BoundingRectangleProperty. Obbligatorio Nessuno
Evento di cambiamento della proprietà IsOffscreenProperty. Obbligatorio Nessuno
Evento di cambiamento della proprietà IsEnabledProperty. Obbligatorio Nessuno
Evento di cambiamento della proprietà HorizontallyScrollableProperty. Dipende da Nessuno
Evento di cambiamento della proprietà HorizontalScrollPercentProperty. Dipende da Nessuno
Evento di cambiamento della proprietà HorizontallyScrollableProperty. Dipende da Nessuno
Evento di cambiamento della proprietà HorizontalViewSizeProperty. Dipende da Nessuno
Evento di cambiamento della proprietà VerticalScrollPercentProperty. Dipende da Nessuno
Evento di cambiamento della proprietà VerticalViewSizeProperty. Dipende da Nessuno
AutomationFocusChangedEvent Obbligatorio Nessuno
StructureChangedEvent Obbligatorio Nessuno

Vedere anche