Condividi tramite

Tipo di controllo testo

  • Articolo

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

Un controllo di testo è un elemento dell'interfaccia utente di base che rappresenta una parte di testo sullo schermo.

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 testo. I requisiti di automazione interfaccia utente si applicano a tutti i controlli ad albero 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 di testo 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
  • Testo
  • Testo (se contenuto)

 

Un controllo di testo può essere usato da solo come etichetta o come testo statico in un modulo. Può anche essere contenuta all'interno della struttura di uno degli elementi seguenti:

I controlli di testo potrebbero non essere visualizzati nella visualizzazione contenuto dell'albero di automazione interfaccia utente perché il testo viene spesso visualizzato tramite la proprietà Nome di un altro controllo. Ad esempio, il testo utilizzato per etichettare un controllo casella combinata viene esposto tramite la proprietà Name del controllo. Poiché il controllo casella combinata si trova nella visualizzazione contenuto dell'albero di automazione interfaccia utente, il controllo di testo non deve essere presente. I controlli di testo possono includere elementi figlio nella visualizzazione contenuto se è presente un oggetto incorporato, ad esempio un collegamento ipertestuale.

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli di testo. 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 Vedere le note. Supportato se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e l'elemento esegue un hit testing specializzato, eseguire l'override e fornire un punto selezionabile.
UIA_ControlTypePropertyId testo
UIA_IsContentElementPropertyId Dipende Il controllo di testo è contenuto se contiene informazioni non esposte nella proprietà Name di un altro controllo.
UIA_IsControlElementPropertyId VERO Il controllo di testo deve essere sempre un controllo .
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà.
UIA_LabeledByPropertyId NULLO I controlli di testo non hanno un'etichetta di testo statica.
UIA_LocalizedControlTypePropertyId Vedere le note. Stringa localizzata corrispondente al tipo di controllo text. Il valore predefinito è "text" per en-US o inglese (Stati Uniti).
UIA_NamePropertyId Vedere le note. Il nome di un controllo di testo può essere il testo visualizzato. Tuttavia, se il controllo supporta anche il modello testo e il testo è esteso, non usare il contenuto full-text come valore nome. Specificare invece un valore Name più breve, derivato da altre proprietà del controllo.

 

Modelli di controllo obbligatori

La tabella seguente elenca i pattern di controllo di automazione interfaccia utente necessari per essere supportati dai controlli di testo. 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 Appoggiare Note
IGridItemProvider Dipende Se il controllo di testo è contenuto all'interno di un controllo tabella, è necessario supportare il GridItem pattern di controllo.
ITableItemProvider Dipende Se il controllo di testo è contenuto all'interno di un controllo tabella, è necessario supportare TableItem pattern di controllo.
ITextProvider Dipende Il testo deve supportare il pattern di controllo testo per migliorare l'accessibilità; tuttavia, non è obbligatorio. Il pattern di controllo Testo è utile quando il testo ha uno stile e attributi avanzati (ad esempio, colore, grassetto e corsivo).
IValueProvider Mai Un controllo di testo non supporta mai il pattern di controllo Value. Se il testo è modificabile, è il tipo di controllo Modifica.

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente necessari per supportare i controlli di testo. 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_NamePropertyId evento di modifica delle proprietà.
UIA_StructureChangedEventId
UIA_Text_TextChangedEventId Se il controllo supporta il pattern di controllo text, deve supportare questo evento.

 

concettuale

panoramica dei tipi di controllo di automazione interfaccia utente

panoramica dell'automazione interfaccia utente