Condividi tramite


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

Vedi anche