Modifica tipo di controllo
In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo Modifica.
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, le proprietà, i pattern di controllo e gli eventi necessari per il tipo di controllo di modifica. I requisiti di automazione interfaccia utente si applicano a tutti i controlli di modifica in cui il framework o la piattaforma dell'interfaccia utente integra il supporto di Automazione interfaccia utente per i tipi di controllo e i pattern di controllo.
Questo argomento contiene le sezioni seguenti.
- struttura ad albero tipica
- proprietà rilevanti
- modelli di controllo necessari
- eventi obbligatori
- osservazioni
- argomenti correlati
Struttura ad albero tipica
La tabella seguente illustra un controllo e una visualizzazione contenuto tipici 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.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
|
|
I controlli che implementano il Modifica tipo di controllo avranno sempre barre di scorrimento zero nella visualizzazione controllo dell'albero di automazione interfaccia utente perché si tratta di un controllo a riga singola. La singola riga di testo può essere disposta in alcuni scenari di layout. Il Modifica tipo di controllo è destinato solo a piccole quantità di testo.
Proprietà pertinenti
La tabella seguente elenca le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli di modifica. Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Recupero delle proprietà dagli elementi di automazione interfaccia utente.
| Ui Automation, proprietà | Valore | Note |
|---|---|---|
| UIA_AutomationIdPropertyId | Vedere le note. | Il valore di questa proprietà deve essere univoco tra tutti gli elementi peer nella visualizzazione non elaborata dell'albero di automazione interfaccia utente. |
| UIA_BoundingRectanglePropertyId | Vedere le note. | Rettangolo più esterno che contiene l'intero controllo. |
| UIA_ClickablePointPropertyId | 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. |
| UIA_ControlTypePropertyId | Modifica | |
| UIA_IsContentElementPropertyId | TRUE | Il controllo di modifica è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente. |
| UIA_IsControlElementPropertyId | TRUE | Il controllo di modifica è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente. |
| UIA_IsKeyboardFocusablePropertyId | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. |
| UIA_IsPasswordPropertyId | Vedere le note. | Deve essere impostato su TRUE nei controlli di modifica contenenti 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. |
| UIA_LabeledByPropertyId | 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 proprietà impostata. |
| UIA_LocalizedControlTypePropertyId | Vedere le note. | Stringa localizzata corrispondente al tipo di controllo Modifica. Il valore predefinito è "edit" per en-US o inglese (Stati Uniti). |
| UIA_NamePropertyId | 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 assegnare un valore della proprietà per Nome dallo sviluppatore dell'applicazione. La proprietà Nome non deve mai contenere il contenuto testuale del controllo di modifica. |
Modelli di controllo obbligatori
La tabella seguente elenca i modelli di controllo di automazione interfaccia utente necessari per essere supportati dai controlli di modifica. 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/pattern, proprietà | Supporto/valore | Note |
|---|---|---|
| IRangeValueProvider | Dipende | Tutti i controlli di modifica che accettano un intervallo numerico devono esporre il RangeValue pattern di controllo. |
| minima | Vedere le note. | Questa proprietà deve essere il valore più piccolo a cui è possibile impostare il contenuto del controllo di modifica. |
| massimo | Vedere le note. | Questa proprietà deve essere il valore più grande a 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 il controllo di modifica accetta solo numeri interi, il valore della proprietà SmallChange deve essere 1. Se il controllo di modifica accetta un intervallo compreso tra 1,0 e 2.0, il valore della proprietà smallchange deve essere 0,1. Se il controllo di modifica accetta un intervallo compreso tra 1,00 e 2,00, il valore della proprietà SmallChange deve essere 0,001. |
| LargeChange | NULL | Questa proprietà non deve essere esposta in un controllo di modifica. |
| valore | Vedere le note. | Questa proprietà indica 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 nell'minimo e proprietà Maximum, la proprietàvalueviene arrotondata automaticamente al valore accettato più vicino. |
| ITextProvider | Obbligatorio | Tutti i controlli di modifica devono supportare il pattern di controllo Text perché le informazioni dettagliate devono essere sempre disponibili per i client di assistive technology. |
| IValueProvider | Dipende | Tutti i controlli di modifica che accettano una stringa devono esporre il pattern di controllo 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 che può essere modificato dall'utente. |
| valore | Vedere le note. | Questa proprietà contiene il contenuto testuale del controllo di modifica. Se la proprietà UIA_IsPasswordPropertyId è impostata su TRUE, l'esecuzione di query sulla proprietàValuedeve restituire un errore. |
Eventi obbligatori
La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per supportare i controlli di modifica. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .
| Evento di automazione interfaccia utente | Note |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento di modifica delle proprietà. | |
| UIA_IsEnabledPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietàIsEnabled, deve supportare questo evento. |
| UIA_IsOffscreenPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietàIsOffscreen, deve supportare questo evento. |
| UIA_NamePropertyId evento di modifica delle proprietà. | |
| UIA_RangeValueValuePropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo RangeValue, deve supportare questo evento. |
| UIA_ScrollHorizontallyScrollablePropertyId evento di modifica delle proprietà. | Un controllo di modifica non supporta mai il pattern di controllo scroll. |
| UIA_ScrollHorizontalScrollPercentPropertyId evento di modifica delle proprietà. | Un controllo di modifica non supporta mai il pattern di controllo scroll. |
| UIA_ScrollHorizontalViewSizePropertyId evento di modifica delle proprietà. | Un controllo di modifica non supporta mai il pattern di controllo scroll. |
| UIA_ScrollVerticallyScrollablePropertyId evento di modifica delle proprietà. | Un controllo di modifica non supporta mai il pattern di controllo scroll. |
| UIA_ScrollVerticalScrollPercentPropertyId evento di modifica delle proprietà. | Un controllo di modifica non supporta mai il pattern di controllo scroll. |
| UIA_ScrollVerticalViewSizePropertyId evento di modifica delle proprietà. | Un controllo di modifica non supporta mai il pattern di controllo scroll. |
| UIA_StructureChangedEventId | |
| UIA_Text_TextChangedEventId | Se il controllo supporta il pattern di controllo text, deve supportare questo evento. |
| UIA_Text_TextSelectionChangedEventId | Se il controllo supporta il pattern di controllo text, deve supportare questo evento. |
| UIA_ValueValuePropertyId evento di modifica della proprietà . | Se il controllo supporta il pattern di controllo Value, deve supportare questo evento. |
Osservazioni
Un controllo di modifica può essere utilizzato come campo di testo di sola lettura che non supporta la selezione o la modifica del testo. Un controllo di modifica di questo tipo si comporta come un oggetto campo con un nome e un valore specifici.
Se un controllo di modifica contiene testo segnaposto (ad esempio, un banner di segnale), il testo deve essere utilizzato come proprietà HelpText, a meno che il testo non possa essere modificato dall'utente e quindi riutilizzato come testo segnaposto. Ad esempio, la barra degli indirizzi di Windows Internet Explorer contiene il testo "about:Tabs" quando viene aperta una nuova scheda. Non è HelpText perché è un indirizzo programmatico che può essere usato o modificato dall'utente.
Argomenti correlati