Supporto di automazione interfaccia utente per il tipo di controllo Edit
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.
In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente per il tipo di controllo di modifica. 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 di modifica consentono a un utente di visualizzare e modificare una semplice riga di testo senza il supporto del formato RTF.
Le seguenti sezioni definiscono la struttura ad albero, le proprietà, i criteri di controllo e gli eventi di Automazione interfaccia utente necessari per il tipo di controllo di modifica. I requisiti di automazione interfaccia utente si applicano a tutti i controlli di modifica, ovvero 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 di modifica e descrive cosa può essere contenuto in ogni vista. Per maggiori informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell’albero di Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
| Modifica | Modifica |
I controlli che implementano il tipo di controllo di modifica non includeranno alcuna barra di scorrimento nella vista controllo dell'albero di Automazione interfaccia utente perché si tratta di un controllo a riga singola. In alcuni scenari di layout una singola riga di testo può essere interrotta da un ritorno a capo. Il tipo di controllo di modifica è ideale per contenere piccole quantità di testo modificabile o selezionabile.
Proprietà di automazione interfaccia utente obbligatorie
La seguente tabella elenca le proprietà di Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli di modifica. 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. | Il controllo di modifica deve disporre di un punto selezionabile che rende disponibile lo stato attivo per l'input alla parte di modifica del controllo quando un utente fa clic su tale punto. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| NameProperty | Vedere le note. | Il nome del controllo di modifica viene in genere generato da un'etichetta di testo statico. Se non è presente alcuna etichetta di testo statico, un valore di proprietà per Name deve essere assegnato dallo sviluppatore dell'applicazione. La proprietà Name non deve mai includere il contenuto testuale del controllo di modifica. |
| LabeledByProperty | Vedere le note. | Se è presente un'etichetta di testo statico associata al controllo, questa proprietà deve esporre un riferimento a tale controllo. Se il controllo testo è un sottocomponente di un altro controllo, non avrà una proprietà LabeledBy impostata. |
| ControlTypeProperty | Modifica | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "edit" | Stringa localizzata corrispondente al tipo di controllo Edit. |
| IsContentElementProperty | Vero | Il controllo di modifica è sempre incluso nella vista contenuto dell'albero di Automazione interfaccia utente. |
| IsControlElementProperty | Vero | Il controllo di modifica è sempre incluso nella vista controllo dell'albero di Automazione interfaccia utente. |
| IsPasswordProperty | Vedere le note. | Deve essere impostata su true nei controlli di modifica che contengono password. Se un controllo di modifica include contenuto di tipo Password, questa proprietà può essere usata da una utilità per la lettura dello schermo per determinare se le sequenze di tasti devono essere lette mentre l'utente digita il testo. |
Pattern di controllo e proprietà obbligatori per l'automazione interfaccia utente
La tabella seguente elenca i pattern di controllo che devono essere supportati da tutti i controlli di modifica. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo/proprietà del pattern di controllo | Supporto/valore | Note |
|---|---|---|
| ITextProvider | Dipende da | I controlli di modifica devono supportare il pattern di controllo Text in quanto le informazioni testuali dettagliate devono sempre essere disponibili per i client. |
| IValueProvider | Dipende da | Tutti i controlli di modifica che accettano una stringa devono esporre il pattern Value. |
| IsReadOnly | Vedere le note. | Questa proprietà deve essere impostata per indicare se il controllo può avere un valore impostato a livello di codice oppure se è modificabile dall'utente. |
| Value | Vedere le note. | Questa proprietà restituirà il contenuto testuale del controllo di modifica. Se IsPasswordProperty è impostata su true, questa proprietà deve generare InvalidOperationException quando richiesto. |
| IRangeValueProvider | Dipende da | Tutti i controlli di modifica che accettano un intervallo numerico devono esporre il pattern di controllo RangeValue. |
| Minimum | Vedere le note. | Questa proprietà deve essere il valore più piccolo su cui può essere impostato il contenuto del controllo di modifica. |
| Maximum | Vedere le note. | Questa proprietà deve essere il valore più grande su cui può essere impostato il contenuto del controllo di modifica. |
| SmallChange | Vedere le note. | Questa proprietà deve indicare il numero di cifre decimali che è possibile impostare per il valore. Se il controllo di modifica accetta solo valori integer, impostare SmallChangeProperty su 1. Se il controllo di modifica accetta un intervallo compreso tra 1,0 e 2,0, impostare SmallChangeProperty su 0,1. Se il controllo di modifica accetta un intervallo compreso tra 1,0 e 2,0, impostare SmallChangeProperty su 0,001. |
| LargeChange | Null |
Questa proprietà non deve essere esposta in un controllo di modifica. |
| Value | Vedere le note. | Questa proprietà indicherà il contenuto numerico del controllo di modifica. Quando un valore più preciso viene impostato da un client di Automazione interfaccia utente all'interno degli intervalli specificati nelle proprietà Minimum e Maximum, la proprietà Value verrà automaticamente arrotondata al valore accettato più vicino. |
Eventi di automazione interfaccia utente obbligatori
La seguente tabella elenca gli eventi di Automazione interfaccia utente che devono essere supportati da tutti i controlli di modifica. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di Automazione interfaccia utente | Supporto tecnico | Note |
|---|---|---|
| InvalidatedEvent | Richiesto | None |
| 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 . | Dipende da | None |
| Evento di modifica della proprietàHorizontallyScrollableProperty . | Mai | None |
| Evento di modifica della proprietàHorizontalScrollPercentProperty . | Mai | None |
| Evento di modifica della proprietàHorizontalViewSizeProperty . | Mai | None |
| Evento di modifica della proprietàVerticalScrollPercentProperty . | Mai | None |
| Evento di modifica della proprietàVerticallyScrollableProperty . | Mai | None |
| Evento di modifica della proprietàVerticalViewSizeProperty . | Mai | None |
| Evento di modifica della proprietàValueProperty . | Dipende da | Se il controllo supporta il pattern di controllo RangeValue, deve supportare questo evento. |
| AutomationFocusChangedEvent | Richiesto | None |
| StructureChangedEvent | Richiesto | None |