Supporto di automazione interfaccia utente per il tipo di controllo Text
Nota
Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di Automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su Automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
Questo argomento fornisce informazioni sul supporto per Automazione interfaccia utente per il tipo di controllo Text. In Automazione interfaccia utente, un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare per poter utilizzare la proprietà ControlTypeProperty. Le condizioni includono linee guida specifiche per la struttura ad albero di Automazione interfaccia utente, i valori delle proprietà di Automazione interfaccia utente e i criteri di controllo.
I controlli Text sono l'elemento di base dell'interfaccia utente che rappresenta una parte di testo sullo schermo.
Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i criteri di controllo e gli eventi di Automazione interfaccia utente previsti per il tipo di controllo Text. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli testo, siano essi Windows Presentation Foundation (WPF), Win32 o Windows Form.
Struttura ad albero di automazione interfaccia utente obbligatoria
La tabella seguente mostra la vista controllo e la vista contenuto dell'albero di Automazione interfaccia utente che riguarda i controlli testo e descrive cosa può essere contenuto in ogni vista. Per altre informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di 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 un oggetto:
ListItem
TreeItem
DataItem
I controlli testo potrebbero non essere presenti nella vista contenuto dell'albero di Automazione interfaccia utente perché il testo è spesso visualizzato attraverso l'oggetto NameProperty di un altro controllo. Ad esempio, il testo usato per assegnare un'etichetta a una casella combinata viene esposto con il valore NameProperty del controllo. Poiché la casella combinata si trova nella visualizzazione contenuto dell'albero di automazione interfaccia utente, non è necessario che il controllo di testo si trovi in tale visualizzazione. I controlli Text hanno sempre 0 elementi figlio nella visualizzazione contenuto.
Proprietà di automazione interfaccia utente obbligatorie
La tabella seguente elenca le proprietà di Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli testo. Per maggiori informazioni sulle proprietà di Automazione interfaccia utente, vedere Proprietà di Automazione interfaccia utente per i client.
| Proprietà di automazione interfaccia utente | Valore | Note |
|---|---|---|
| AutomationIdProperty | Vedere le note. | Il valore di questa proprietà deve essere univoco in tutti i controlli in un'applicazione. |
| BoundingRectangleProperty | Vedere le note. | Il rettangolo più esterno che contiene l'intero controllo. |
| ClickablePointProperty | Vedere le note. | Supportata se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili ed è stato eseguito un processo di hit testing specializzato, eseguire l'override e implementare un punto selezionabile. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| NameProperty | Vedere le note. | Il nome del controllo barra di testo è sempre il testo visualizzato. |
| LabeledByProperty | Null |
I controlli Text non hanno un'etichetta di testo statico. |
| ControlTypeProperty | Testo | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "text" | Stringa localizzata corrispondente al tipo di controllo testo. |
| IsContentElementProperty | Dipende da | Il controllo testo sarà un contenuto se contiene informazioni non esposte nel valore NameProperty di un altro controllo. |
| IsControlElementProperty | Vero | Il controllo testo deve essere sempre un controllo. |
Pattern di controllo obbligatori per l'automazione interfaccia utente
La tabella seguente elenca i criteri di controllo di Automazione interfaccia utente che devono essere supportati dai controlli testo. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo | Supporto tecnico | Note |
|---|---|---|
| IValueProvider | Mai | Il testo non supporta mai ValuePattern. Se il testo è modificabile, il tipo di controllo è Edit. |
| ITextProvider | Dipende da | È opportuno che il testo supporti il pattern di controllo Text per una migliore accessibilità, ma non è obbligatorio. Il pattern di controllo Text è utile quando il testo ha stili di formattazione e attributi, ad esempio colore, grassetto e corsivo. Dipende dal framework. |
| ITableItemProvider | Dipende da | Se l'elemento di testo è contenuto in un controllo Table, questo deve essere supportato. |
| IRangeValueProvider | Dipende da | Se l'elemento di testo è contenuto in un controllo Table, questo deve essere supportato. |
Eventi di automazione interfaccia utente obbligatori
La tabella seguente elenca gli eventi di Automazione interfaccia utente che devono essere supportati da tutti i controlli testo. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di Automazione interfaccia utente | Supporto tecnico | Note |
|---|---|---|
| TextSelectionChangedEvent | Richiesto | None |
| TextChangedEvent | Richiesto | None |
| Evento di modifica della proprietàBoundingRectangleProperty . | Richiesto | None |
| Evento di modifica della proprietàIsOffscreenProperty . | Richiesto | None |
| Evento di modifica della proprietàIsEnabledProperty . | Richiesto | None |
| Evento di modifica della proprietàNameProperty . | Richiesto | None |
| Evento di modifica della proprietàValueProperty . | Mai | None |
| AutomationFocusChangedEvent | Richiesto | None |
| StructureChangedEvent | Richiesto | None |