Tipo di controllo tabulazione

  • Articolo

Questo argomento fornisce informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo Tab.

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 Automazione interfaccia utente, le proprietà, i modelli di controllo e gli eventi necessari per il tipo di controllo Tab. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli tabulazioni in cui il framework dell'interfaccia utente/piattaforma integra Automazione interfaccia utente supporto per i tipi di controllo e i modelli di controllo.

In questo argomento sono contenute le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra una visualizzazione tipica del controllo e del contenuto dell'albero Automazione interfaccia utente che riguarda i controlli tabulazioni e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero Automazione interfaccia utente, vedere Panoramica dell'albero Automazione interfaccia utente.

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

 

I controlli tabulazioni hanno elementi figlio Automazione interfaccia utente in base al tipo di controllo TabItem. Quando gli elementi di tabulazione vengono raggruppati ,ad esempio nelle applicazioni di Microsoft Office, il tipo di controllo Tab può ospitare anche i tipi di controllo Gruppi per gli elementi della scheda raggruppati, come illustrato nella struttura ad albero seguente.

Visualizzazione controlli Visualizzazione contenuto
  • Scheda
    • TabItem (1 o più)
    • Group (0 o più)
      • TabItem (0 o più)
    • ScrollBar (0 o 1)
      • Button (0 o 2)
  • Scheda
    • TabItem (1 o più)
    • Group (0 o più)
      • TabItem (0 o più)

 

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli tabulazioni. Per altre informazioni sulle proprietà Automazione interfaccia utente, vedere Recupero delle proprietà da elementi Automazione interfaccia utente.

Proprietà di automazione interfaccia utente Valore Note
UIA_AutomationIdPropertyId Vedere le note. Il valore di questa proprietà deve essere univoco tra tutti gli elementi peer nella visualizzazione non elaborata dell'albero Automazione interfaccia utente.
UIA_BoundingRectanglePropertyId Vedere le note. Il rettangolo più esterno che contiene l'intero controllo.
UIA_ClickablePointPropertyId No Il controllo tabulazioni non dispone di punti selezionabili.
UIA_ControlTypePropertyId TAB
UIA_IsContentElementPropertyId TRUE Il controllo tabulazioni è sempre incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente.
UIA_IsControlElementPropertyId TRUE Il controllo tabulazioni è sempre incluso nella visualizzazione controllo dell'albero Automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId TRUE Il tipo di controllo Tab deve essere in grado di ricevere lo stato attivo. In genere, un client Automazione interfaccia utente chiama IUIAutomationElement::SetFocus in un controllo tabulazione e uno dei relativi elementi inoltra lo stato attivo della tastiera al controllo tabulazione. È possibile che alcuni contenitori di schede assumano lo stato attivo senza che lo stato attivo venga impostato su uno dei relativi elementi.
UIA_LabeledByPropertyId Vedere le note. I controlli Struttura a schede in genere includono un'etichetta di testo statico che viene esposta tramite questa proprietà.
UIA_LocalizedControlTypePropertyId Vedere le note. Stringa localizzata corrispondente al tipo di controllo Tab . Il valore predefinito è "tab" per en-US o inglese (Stati Uniti).
UIA_NamePropertyId Vedere le note. Il controllo tabulazioni richiede raramente una proprietà Name .
UIA_OrientationPropertyId Vedere le note. Il controllo Struttura a schede deve sempre indicare se è posizionato orizzontalmente o verticalmente.

 

Modelli di controllo obbligatori

Nella tabella seguente sono elencati i modelli di controllo Automazione interfaccia utente necessari per essere supportati da tutti i controlli tabulazioni. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.

Pattern di controllo/proprietà del pattern Supporto/valore Note
ISelectionProvider Necessario Tutti i controlli tabulazioni devono supportare il modello di controllo Selezione .
IsSelectionRequired TRUE I controlli Struttura a schede richiedono sempre una selezione.
CanSelectMultiple FALSE I controlli Struttura a schede sono sempre contenitori a selezione singola.
IScrollProvider Dipende da Il modello di controllo Scroll deve essere supportato se il controllo tabulazioni include widget che consentono di scorrere un set di elementi di tabulazioni.

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per supportare i controlli tabulazioni. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.

Automazione interfaccia utente evento Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento modificato dalla proprietà.
UIA_IsEnabledPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento.
UIA_IsOffscreenPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento.
UIA_ScrollHorizontallyScrollablePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento.
UIA_ScrollHorizontalScrollPercentPropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento.
UIA_ScrollHorizontalViewSizePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento.
UIA_ScrollVerticallyScrollablePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento.
UIA_ScrollVerticalScrollPercentPropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento.
UIA_ScrollVerticalViewSizePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Scroll , deve supportare questo evento.
UIA_StructureChangedEventId

 

Informazioni concettuali

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

Cenni preliminari su automazione interfaccia utente