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 dell'Automazione Interfaccia Utente per il tipo di controllo Modifica. 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 modifica consentono a un utente di visualizzare e modificare una semplice riga di testo senza supporto per la formattazione avanzata.
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 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 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 modifica e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.
| Vista di controllo | Visualizzazione contenuto |
|---|---|
| Redigere | Redigere |
I controlli che implementano il tipo di controllo Modifica non avranno mai barre di scorrimento nella visualizzazione controlli dell'albero UI Automation poiché è un controllo a riga singola. La singola riga di testo può essere disposta in alcuni scenari di layout. Il tipo di controllo Modifica è più adatto per contenere piccole quantità di testo modificabile o selezionabile.
Proprietà di automazione interfaccia utente necessarie
La tabella seguente elenca le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per modificare i controlli. 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. | Il controllo di modifica deve avere un punto selezionabile che fornisce lo stato attivo per l'input alla parte di modifica del controllo quando un utente fa clic sul mouse. |
| 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 di modifica viene in genere generato da un'etichetta di testo statica. Se non è presente un'etichetta di testo statico, è necessario che un valore di proprietà per Name sia assegnato dallo sviluppatore dell'applicazione. La Name proprietà non deve mai contenere il contenuto testuale del controllo di modifica. |
| LabeledByProperty | Vedere le note. | Se al controllo è associata un'etichetta di testo statica, questa proprietà deve esporre un riferimento a tale controllo. Se il controllo di testo è un sottocomponente di un altro controllo, non avrà un LabeledBy set di proprietà. |
| ControlTypeProperty | Redigere | Questo valore è lo stesso per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "modifica" | Stringa localizzata corrispondente al tipo di controllo di modifica. |
| IsContentElementProperty | Vero | Il controllo di modifica è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente. |
| IsControlElementProperty | Vero | Il controllo di modifica è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente. |
| IsPasswordProperty | Vedere le note. | Deve essere impostato su true nei controlli di modifica che contengono password. Se un controllo di modifica contiene il contenuto della password, questa proprietà può essere utilizzata da un'utilità per la lettura dello schermo per determinare se le sequenze di tasti devono essere lette come digitate dall'utente. |
Schemi di controllo e proprietà necessari per l'automazione interfaccia utente
Nella tabella seguente sono elencati i pattern di controllo necessari per 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 Testo perché le informazioni dettagliate sul testo devono essere sempre disponibili per i client. |
| IValueProvider | Dipende da | Tutti i controlli di modifica che accettano una stringa devono esporre il modello Value. |
| IsReadOnly | Vedere le note. | Questa proprietà deve essere impostata per indicare se il controllo può avere un valore impostato a livello di codice o modificabile dall'utente. |
| Value | Vedere le note. | Questa proprietà restituirà il contenuto testuale del controllo di modifica.
IsPasswordProperty Se è impostato su true, questa proprietà deve generare un oggetto InvalidOperationException quando richiesto. |
| IRangeValueProvider | Dipende da | Tutti i controlli di modifica che accettano un intervallo numerico devono esporre il pattern di controllo Range Value. |
| Minimum | Vedere le note. | Questa proprietà deve essere il valore più piccolo su cui è possibile impostare il contenuto del controllo di modifica. |
| Maximum | Vedere le note. | Questa proprietà deve essere il valore più grande su cui è possibile impostare il contenuto del controllo di modifica. |
| SmallChange | Vedere le note. | Questa proprietà deve indicare il numero di posizioni decimali su cui è possibile impostare il valore. Se la modifica accetta solo numeri interi, deve SmallChangeProperty essere 1. Se la modifica accetta un intervallo compreso tra 1,0 e 2.0, deve SmallChangeProperty essere 0,1. Se il controllo di modifica accetta un intervallo compreso tra 1.00 e 2.00, deve SmallChangeProperty essere 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 Minimum proprietà e Maximum , la proprietà Value verrà arrotondata automaticamente al valore accettato più vicino. |
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 modifica. Per ulteriori informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di automazione interfaccia utente | Assistenza | Note |
|---|---|---|
| InvalidatedEvent | Obbligatorio | Nessuno |
| 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. | Dipende da | Nessuno |
| Evento di cambiamento della proprietà HorizontallyScrollableProperty. | Mai | Nessuno |
| Evento di cambiamento della proprietà HorizontalScrollPercentProperty. | Mai | Nessuno |
| Evento di cambiamento della proprietà HorizontalViewSizeProperty. | Mai | Nessuno |
| Evento di cambiamento della proprietà VerticalScrollPercentProperty. | Mai | Nessuno |
| Evento di cambiamento della proprietà VerticallyScrollableProperty. | Mai | Nessuno |
| Evento di cambiamento della proprietà VerticalViewSizeProperty. | Mai | Nessuno |
| Evento di cambiamento della proprietà ValueProperty. | Dipende da | Se il controllo supporta il pattern di controllo Range Value, deve supportare questo evento. |
| AutomationFocusChangedEvent | Obbligatorio | Nessuno |
| StructureChangedEvent | Obbligatorio | Nessuno |