Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Annotazioni
Questa documentazione è destinata agli sviluppatori .NET Framework che vogliono usare le classi di automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per le informazioni più recenti sull'automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
In questo argomento vengono fornite informazioni sul supporto all'automazione dell'interfaccia utente per il tipo di controllo Text. In Automazione interfaccia utente un tipo di controllo è un set di condizioni che un controllo deve soddisfare per usare la ControlTypeProperty proprietà . 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 pattern di controllo.
I controlli di testo sono l'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 Text. I requisiti di automazione interfaccia utente si applicano a tutti i controlli di testo, ovvero Windows Presentation Foundation (WPF), Win32 o Windows Form.
Struttura ad albero necessaria per l'automazione UI
La tabella seguente illustra la visualizzazione controlli e la visualizzazione contenuto dell'albero di automazione interfaccia utente che riguarda i controlli di testo e descrive cosa può essere contenuto in ogni visualizzazione. Per ulteriori informazioni sull'albero di automazione dell'interfaccia utente, vedere Panoramica dell'albero di automazione interfaccia utente.
| Vista di controllo | 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 un oggetto :
Elemento della lista
TreeItem
DataItem
I controlli di testo potrebbero non trovarsi nella visualizzazione contenuto dell'albero di automazione interfaccia utente perché il testo viene spesso visualizzato tramite l'oggetto NameProperty di un altro controllo. Ad esempio, il testo utilizzato per etichettare un controllo Combo Box viene esposto attraverso il valore del controllo NameProperty. Poiché il controllo Casella combinata si trova nella visualizzazione del contenuto dell'albero di automazione dell'interfaccia utente, non è necessario che il controllo del testo sia lì. I controlli di testo hanno sempre 0 figli nella visualizzazione dei contenuti
Proprietà di automazione interfaccia utente necessarie
La tabella seguente elenca 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 Proprietà di automazione interfaccia utente per i client.
| Ui Automation, proprietà | Valore | Note |
|---|---|---|
| AutomationIdProperty | Vedere le note. | Il valore di questa proprietà deve essere univoco in tutti i controlli di un'applicazione. |
| BoundingRectangleProperty | Vedere le note. | Rettangolo più esterno che contiene l'intero controllo. |
| ClickablePointProperty | Vedere le note. | Supportato se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e si eseguono hit testing specializzati, eseguire l'override e fornire un punto selezionabile. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. |
| NameProperty | Vedere le note. | Il nome del controllo barra di testo è sempre il txt visualizzato. |
| LabeledByProperty | Null |
I controlli di testo non hanno un'etichetta di testo statica. |
| ControlTypeProperty | Testo | Questo valore è lo stesso per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "testo" | Stringa localizzata corrispondente al tipo di controllo del testo. |
| IsContentElementProperty | Dipende da | Il controllo di testo sarà contenuto se contiene informazioni non esposte in NameProperty di un altro controllo. |
| IsControlElementProperty | Vero | Il controllo di testo deve essere sempre un controllo . |
Modelli di controllo di automazione interfaccia utente necessari
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 | Assistenza | Note |
|---|---|---|
| IValueProvider | Mai | Il testo non supporta mai il ValuePattern. Se il testo è modificabile, si tratta del tipo di controllo Modifica. |
| ITextProvider | Dipende da | Il testo dovrebbe supportare il modello di controllo del testo per una migliore accessibilità; tuttavia, non è strettamente necessario. Il pattern di controllo Testo è utile quando il testo ha uno stile e attributi avanzati (ad esempio, colore, grassetto e corsivo). Dipende dal framework. |
| ITableItemProvider | Dipende da | Se l'elemento di testo è contenuto all'interno di un controllo Table, deve essere supportato. |
| IRangeValueProvider | Dipende da | Se l'elemento di testo è contenuto all'interno di un controllo tabella, deve essere supportato. |
Eventi di automazione interfaccia utente necessari
La tabella seguente elenca gli eventi di automazione interfaccia utente che devono essere supportati da tutti i controlli di testo. Per ulteriori informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di automazione interfaccia utente | Assistenza | Note |
|---|---|---|
| TextSelectionChangedEvent | Obbligatorio | Nessuno |
| TextChangedEvent | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà BoundingRectangleProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsOffscreenProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsEnabledProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà NameProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà ValueProperty. | Mai | Nessuno |
| AutomationFocusChangedEvent | Obbligatorio | Nessuno |
| StructureChangedEvent | Obbligatorio | Nessuno |