Condividi tramite

Tipo di controllo testo

  • Articolo

Questo argomento fornisce informazioni sul supporto di Microsoft Automazione interfaccia utente 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 Automazione interfaccia utente, le proprietà, i modelli 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 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 di testo 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
  • Testo
  • Testo (se contenuto)

 

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

I controlli di testo potrebbero non essere visualizzati nella visualizzazione contenuto dell'albero Automazione interfaccia utente perché il testo viene spesso visualizzato tramite la proprietà Name di un altro controllo. Ad esempio, il testo usato 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 Automazione interfaccia utente, il controllo di testo non deve essere presente. I controlli di testo possono avere elementi figlio nella visualizzazione contenuto se è presente un oggetto incorporato, ad esempio un collegamento ipertestuale.

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o la definizione sono particolarmente rilevanti per i controlli di testo. 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 Vedere le note. Supportata se è presente un rettangolo di delimitazione. Se non ogni punto all'interno del rettangolo di selezione è selezionabile e l'elemento esegue test di hit test specializzati, override e fornisce un punto clickable.
UIA_ControlTypePropertyId Text
UIA_IsContentElementPropertyId Dipende da Il controllo di testo è contenuto se contiene informazioni non esposte nella proprietà Name di un altro controllo.
UIA_IsControlElementPropertyId TRUE Il controllo testo deve essere sempre un controllo.
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà.
UIA_LabeledByPropertyId NULL I controlli Text non hanno un'etichetta di testo statico.
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 di 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

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

Pattern di controllo Supporto Note
IGridItemProvider Dipende da Se il controllo di testo è contenuto all'interno di un controllo tabella, è necessario supportare il modello di controllo GridItem .
ITableItemProvider Dipende da Se il controllo di testo è contenuto all'interno di un controllo tabella, è necessario supportare il modello di controllo TableItem .
ITextProvider Dipende da Il testo deve supportare il modello di controllo testo per migliorare l'accessibilità; tuttavia, non è obbligatorio. Il pattern di controllo Text è utile quando il testo ha stili di formattazione e attributi, ad esempio colore, grassetto e corsivo.
IValueProvider Mai Un controllo di testo non supporta mai il modello di controllo Valore . Se il testo è modificabile, è il tipo di controllo Modifica .

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per il supporto dei controlli di testo. 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_NamePropertyId evento modificato dalla proprietà.
UIA_StructureChangedEventId
UIA_Text_TextChangedEventId Se il controllo supporta il modello di controllo Testo , deve supportare questo evento.

 

Informazioni concettuali

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

Cenni preliminari su automazione interfaccia utente