Modifica tipo di controllo

  • Articolo

In questo argomento vengono fornite informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo Modifica.

I controlli di modifica consentono a un utente di visualizzare e modificare una semplice riga di testo senza il supporto del formato RTF.

Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i pattern di controllo e gli eventi necessari Automazione interfaccia utente per il tipo di controllo di modifica. I requisiti Automazione interfaccia utente si applicano a tutti i controlli di modifica in cui il framework o la piattaforma dell'interfaccia utente si integra Automazione interfaccia utente supporto per i tipi di controllo e i pattern di controllo.

In questo argomento sono contenute le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero 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 Panoramica dell'albero di Automazione interfaccia utente.

Visualizzazione controlli Visualizzazione contenuto
  • Modifica
  • Modifica

 

I controlli che implementano il tipo di controllo Modifica avranno sempre barre di scorrimento zero nella visualizzazione controllo dell'albero 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 Modifica è destinato solo a piccole quantità di testo.

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà 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 di proprietà da elementi Automazione interfaccia utente.

Proprietà di automazione interfaccia utente 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 Automazione interfaccia utente.
UIA_BoundingRectanglePropertyId Vedere le note. Il rettangolo più esterno che contiene l'intero controllo.
UIA_ClickablePointPropertyId 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.
UIA_ControlTypePropertyId Modifica
UIA_IsContentElementPropertyId TRUE Il controllo di modifica viene sempre incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente.
UIA_IsControlElementPropertyId TRUE Il controllo di modifica è sempre incluso nella visualizzazione controllo dell'albero Automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà.
UIA_IsPasswordPropertyId Vedere le note. Deve essere impostato 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.
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 set di proprietà LabeledBy .
UIA_LocalizedControlTypePropertyId Vedere le note. Stringa localizzata corrispondente al tipo di controllo Modifica . Il valore predefinito è "edit" per en-US o english (Stati Uniti).
UIA_NamePropertyId Vedere le note. Il nome del controllo di modifica viene in genere generato da un'etichetta di testo statico. Se non è presente un'etichetta di testo statica, è necessario assegnare un valore di proprietà per Name allo sviluppatore dell'applicazione. La proprietà Name non deve mai contenere il contenuto testuale del controllo di modifica.

 

Pattern di controllo obbligatori

Nella tabella seguente sono elencati i pattern di controllo Automazione interfaccia utente necessari per essere supportati dai controlli di modifica. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.

Pattern di controllo/proprietà del pattern Supporto/valore Note
IRangeValueProvider Dipende da Tutti i controlli di modifica che accettano un intervallo numerico devono esporre il pattern di controllo RangeValue .
Minimo Vedere le note. Questa proprietà deve essere il valore più piccolo al quale è 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 cifre decimali che è possibile impostare per 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 Automazione interfaccia utente all'interno degli intervalli specificati nelle proprietà Minimum e Maximum, la proprietà Value viene arrotondata automaticamente al valore accettato più vicino.
ITextProvider Necessario 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 da 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, la query sulla proprietà Value deve restituire un errore.

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per supportare i controlli di modifica. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.

evento Automazione interfaccia utente Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento di modifica della proprietà.
UIA_IsEnabledPropertyId evento di modifica della proprietà. Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento.
UIA_IsOffscreenPropertyId evento di modifica della proprietà. Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento.
UIA_NamePropertyId evento di modifica della proprietà.
UIA_RangeValueValuePropertyId evento di modifica della proprietà. Se il controllo supporta il pattern di controllo RangeValue , deve supportare questo evento.
UIA_ScrollHorizontallyScrollablePropertyId evento di modifica della proprietà. Un controllo di modifica non supporta mai il pattern di controllo Scroll .
UIA_ScrollHorizontalScrollPercentPropertyId evento di modifica della proprietà. Un controllo di modifica non supporta mai il pattern di controllo Scroll .
UIA_ScrollHorizontalViewSizePropertyId evento di modifica della proprietà. Un controllo di modifica non supporta mai il pattern di controllo Scroll .
UIA_ScrollVerticallyScrollablePropertyId evento di modifica della proprietà. Un controllo di modifica non supporta mai il pattern di controllo Scroll .
UIA_ScrollVerticalScrollPercentPropertyId evento di modifica della proprietà. Un controllo di modifica non supporta mai il pattern di controllo Scroll .
UIA_ScrollVerticalViewSizePropertyId evento di modifica della 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.

 

Commenti

Un controllo di modifica può essere utilizzato come campo di testo di sola lettura che non supporta la selezione o la modifica del testo. Tale controllo di modifica 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 segnali, 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 si tratta di HelpText perché è un indirizzo programmatico che può essere usato o modificato dall'utente.

Informazioni concettuali

Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente

Cenni preliminari su automazione interfaccia utente