Condividi tramite

Tipo di controllo Struttura a schede

  • Articolo

In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo scheda.

Un controllo struttura a schede è analogo ai divisori in un notebook o alle etichette in un file cab. Usando un controllo struttura a schede, un'applicazione può definire più pagine per la stessa area di una finestra o di 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 scheda. I requisiti di automazione interfaccia utente si applicano a tutti i controlli struttura a schede in cui il framework o la piattaforma dell'interfaccia utente integra il supporto di Automazione interfaccia utente per i tipi di controllo e i pattern di controllo.

Questo argomento contiene le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero di automazione interfaccia utente che riguarda i controlli struttura a schede e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.

Visualizzazione controlli 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 di automazione interfaccia utente in base al tipo di controllo TabItem. Quando gli elementi di tabulazione sono raggruppati (ad esempio, come nelle applicazioni di Microsoft Office) il tipo di controllo tabulazione può ospitare anche gruppi tipi di controllo per gli elementi di tabulazione raggruppati, come illustrato nella struttura ad albero seguente.

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

 

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli struttura a schede. Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Recupero delle proprietà dagli elementi di automazione interfaccia utente.

Ui Automation, proprietà 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 di automazione interfaccia utente.
UIA_BoundingRectanglePropertyId Vedere le note. Rettangolo più esterno che contiene l'intero controllo.
UIA_ClickablePointPropertyId No Il controllo struttura a schede non dispone di punti selezionabili.
UIA_ControlTypePropertyId tabulazioni
UIA_IsContentElementPropertyId VERO Il controllo struttura a schede è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente.
UIA_IsControlElementPropertyId VERO Il controllo struttura a schede è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId VERO Il tipo di controllo Tab deve essere in grado di ricevere lo stato attivo della tastiera. In genere, un client di automazione interfaccia utente chiama IUIAutomationElement::SetFocus in un controllo struttura a schede e uno dei relativi elementi inoltra lo stato attivo della tastiera al controllo struttura a schede. È possibile che alcuni contenitori di schede prendano lo stato attivo senza impostare lo stato attivo su uno dei relativi elementi.
UIA_LabeledByPropertyId Vedere le note. I controlli Struttura a schede hanno in genere un'etichetta di testo statica 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 struttura a schede 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

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 Obbligatorio Tutti i controlli struttura a schede devono supportare il pattern di controllo 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 Il Scroll pattern di controllo deve essere supportato se il controllo Struttura a schede include widget che consentono lo scorrimento di un set di elementi di tabulazioni.

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente necessari per supportare i controlli struttura a schede. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .

Evento di automazione interfaccia utente Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento di modifica delle proprietà.
UIA_IsEnabledPropertyId evento di modifica delle proprietà. Se il controllo supporta la proprietàIsEnabled, deve supportare questo evento.
UIA_IsOffscreenPropertyId evento di modifica delle proprietà. Se il controllo supporta la proprietàIsOffscreen, deve supportare questo evento.
UIA_ScrollHorizontallyScrollablePropertyId evento di modifica delle proprietà. Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento.
UIA_ScrollHorizontalScrollPercentPropertyId evento di modifica delle proprietà. Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento.
UIA_ScrollHorizontalViewSizePropertyId evento di modifica delle proprietà. Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento.
UIA_ScrollVerticallyScrollablePropertyId evento di modifica delle proprietà. Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento.
UIA_ScrollVerticalScrollPercentPropertyId evento di modifica delle proprietà. Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento.
UIA_ScrollVerticalViewSizePropertyId evento di modifica delle proprietà. Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento.
UIA_StructureChangedEventId

 

concettuale

panoramica dei tipi di controllo di automazione interfaccia utente

panoramica dell'automazione interfaccia utente