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.
Aggiornamento: novembre 2007
In questo argomento vengono fornite informazioni sul supporto di automazione interfaccia utente per il tipo di controllo Edit. In automazione interfaccia utente un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare al fine di utilizzare la proprietà ControlTypeProperty. Le condizioni includono linee guida specifiche per la struttura ad albero di automazione interfaccia utente, i valori delle proprietà automazione interfaccia utente e i pattern di controllo.
I controlli di modifica sono un esempio di controlli che implementano il tipo di controllo Edit. Questi controlli consentono agli utenti di visualizzare e modificare una singola riga di testo.
Nelle sezioni riportate di seguito vengono definiti la struttura ad albero, le proprietà, i pattern di controllo e gli eventi di automazione interfaccia utente necessari per il tipo di controllo Edit. I requisiti di automazione interfaccia utente si applicano a tutti i controlli di modifica, sia Windows Presentation Foundation (WPF), Win32 che Windows Form.
Nel presente argomento sono contenute le seguenti sezioni.
- Struttura ad albero di automazione interfaccia utente obbligatoria
- Proprietà di automazione interfaccia utente obbligatorie
- Pattern di controllo di automazione interfaccia utente obbligatori
- Eventi di automazione interfaccia utente obbligatori
- Argomenti correlati
Struttura ad albero di automazione interfaccia utente obbligatoria
Nella tabella riportata di seguito vengono illustrate la visualizzazione controlli e la visualizzazione contenuto della struttura ad albero di automazione interfaccia utente relativamente ai controlli di modifica e viene descritto il contenuto di ogni visualizzazione. Per ulteriori informazioni sulla struttura ad albero di automazione interfaccia utente, vedere Cenni preliminari sulla struttura di automazione dell'interfaccia utente.
Visualizzazione controlli |
Visualizzazione contenuto |
|---|---|
|
|
I controlli che implementano il tipo di controllo Edit non includeranno mai le barre di scorrimento nella visualizzazione controlli della struttura ad albero di automazione interfaccia utente, perché si tratta di controlli a riga singola. In alcuni scenari di layout è possibile che venga eseguito il wrapping della singola riga di testo. Il tipo di controllo Edit deve essere utilizzato solo per piccole quantità di testo modificabile.
Proprietà di automazione interfaccia utente obbligatorie
Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli di modifica. Per ulteriori 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 per tutti i controlli di un'applicazione. |
Vedere le note. |
Il rettangolo più esterno che contiene l'intero controllo. |
|
Vedere le note. |
Il controllo di modifica deve includere un punto selezionabile che fornisce lo stato attivo per l'input alla parte modificabile del controllo quando l'utente vi fa clic con il mouse. |
|
Vedere le note. |
Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
|
Vedere le note. |
Il nome del controllo di modifica è solitamente generato da un'etichetta di testo statica. Se non è disponibile alcuna etichetta di testo statica, lo sviluppatore dell'applicazione deve assegnare un valore di proprietà per Name. La proprietà Name non deve mai contenere il contenuto testuale del controllo di modifica. |
|
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 includerà una proprietà LabeledBy. |
|
Edit |
Questo valore è identico per tutti i framework dell'interfaccia utente. |
|
"modifica" |
Stringa localizzata che corrisponde al tipo di controllo Edit. |
|
True |
Il controllo di modifica è sempre incluso nella visualizzazione contenuto della struttura ad albero di automazione interfaccia utente. |
|
True |
Il controllo di modifica è sempre incluso nella visualizzazione controlli della struttura ad albero di automazione interfaccia utente. |
|
Vedere le note. |
Deve essere impostata su true per i controlli di modifica che contengono password. Se un controllo di modifica non contiene contenuto Password, questa proprietà può essere utilizzata da un'utilità per la lettura dello schermo per determinare se le sequenze di tasti devono essere lette mentre l'utente le digita. |
Pattern di controllo di automazione interfaccia utente obbligatori
Nella tabella seguente sono elencati i pattern di controllo che devono essere supportati da tutti i controlli di modifica. Per ulteriori informazioni sui pattern di controllo, vedere Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente.
Pattern di controllo/Proprietà pattern di controllo |
Supporto/Valore |
Note |
|---|---|---|
Obbligatorio |
Tutti i controlli di modifica devono supportare il pattern di controllo Text, perché è necessario che siano sempre disponibili informazioni dettagliate per i client di Assistive Technology. |
|
A seconda dei casi |
Tutti i controlli di modifica che accettano una stringa devono esporre il modello Value. |
|
Vedere le note. |
Questa proprietà deve essere impostata per indicare se per il controllo è possibile impostare un valore a livello di codice. |
|
Vedere le note. |
Questa proprietà restituirà il contenuto testuale del controllo di modifica. Se la proprietà IsPasswordProperty è impostata su true, questa proprietà deve generare un'eccezione InvalidOpertaionException quando richiesto. |
|
A seconda dei casi |
Tutti i controlli di modifica che accettano un intervallo numerico devono esporre il pattern di controllo Range Value. |
|
Vedere le note. |
Questa proprietà deve corrispondere al valore più piccolo su cui è possibile impostare il contenuto del controllo di modifica. |
|
Vedere le note. |
Questa proprietà deve corrispondere al valore più grande su cui è possibile impostare il contenuto del controllo di modifica. |
|
Vedere le note. |
Questa proprietà deve indicare il numero di posizioni decimali su cui è possibile impostare il valore. Se il controllo di modifica accetta solo numeri interi, la proprietà SmallChangeProperty deve essere 1. Se il controllo di modifica accetta un intervallo compreso tra 1,0 e 2,0, SmallChangeProperty deve essere 0,1. Se il controllo di modifica accetta un intervallo compreso tra 1,00 e 2,00, SmallChangeProperty deve essere 0,001. |
|
Null |
Questa proprietà non deve necessariamente essere esposta su un controllo di modifica. |
|
Vedere le note. |
Questa proprietà indicherà il contenuto numerico del controllo di modifica. Quando un client di automazione interfaccia utente imposta un valore più preciso compreso negli intervalli specificati nelle proprietà Minimum e Maximum, la proprietà Value verrà automaticamente arrotondata al valore accettato più vicino. |
Eventi di automazione interfaccia utente obbligatori
Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente che devono essere supportati da tutti i controlli di modifica. Per ulteriori informazioni sugli eventi, vedere Cenni preliminari sugli eventi di automazione interfaccia utente.
Evento di automazione interfaccia utente |
Supporto |
Note |
|---|---|---|
Obbligatorio |
Nessuna |
|
Obbligatorio |
Nessuna |
|
Obbligatorio |
Nessuna |
|
Evento di proprietà modificata BoundingRectangleProperty. |
Obbligatorio |
Nessuna |
Evento di proprietà modificata IsOffscreenProperty. |
Obbligatorio |
Nessuna |
Evento di proprietà modificata IsEnabledProperty. |
Obbligatorio |
Nessuna |
Evento di proprietà modificata NameProperty. |
Obbligatorio |
Nessuna |
Evento di proprietà modificata ValueProperty. |
A seconda dei casi |
Nessuna |
Evento di proprietà modificata HorizontallyScrollableProperty. |
Mai |
Nessuna |
Evento di proprietà modificata HorizontalScrollPercentProperty. |
Mai |
Nessuna |
Evento di proprietà modificata HorizontalViewSizeProperty. |
Mai |
Nessuna |
Evento di proprietà modificata VerticalScrollPercentProperty. |
Mai |
Nessuna |
Evento di proprietà modificata System.Windows.Automation.ScrollPatternIdentifiers.VerticallyScrollableProperty. |
Mai |
Nessuna |
Evento di proprietà modificata VerticalViewSizeProperty. |
Mai |
Nessuna |
Evento di proprietà modificata ValueProperty. |
A seconda dei casi |
Se il controllo supporta il pattern di controllo Value, deve supportare questo evento. |
Obbligatorio |
Nessuna |
|
Obbligatorio |
Nessuna |
Vedere anche
Concetti
Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente
Cenni preliminari su automazione interfaccia utente