Supporto per l'automazione dell'interfaccia utente del tipo di controllo ToolTip

Nota
La presente documentazione è destinata agli sviluppatori di .NET Framework che desiderano utilizzare le classi UI Automation gestite definite nello spazio dei nomi System.Windows.Automation.Per informazioni aggiornate sull'UI Automation, vedere Windows Automation API: Automazione interfaccia utente (la pagina potrebbe essere in inglese).

In questo argomento vengono fornite informazioni sul supporto di UI Automation per il tipo di controllo ToolTip. Nell'UI Automation, 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 UI Automation, i valori delle proprietà di UI Automation e i pattern di controllo.

I controlli di descrizione comandi sono finestre popup contenenti del testo.

Nelle sezioni riportate di seguito vengono definiti la struttura ad albero, le proprietà, i pattern di controllo e gli eventi di UI Automation richiesti per il tipo di controllo ToolTip. I requisiti di UI Automation si applicano a tutti i controlli ToolTip, Windows Presentation Foundation (WPF), Win32 e Windows Forms.

Nel presente argomento sono contenute le seguenti sezioni.

• Struttura ad albero dell'automazione interfaccia utente richiesta
• Proprietà di automazione interfaccia utente richieste
• Pattern di controllo di automazione interfaccia utente obbligatori
• Eventi di Automazione interfaccia utente obbligatori
• Argomenti correlati

Struttura ad albero dell'automazione interfaccia utente richiesta

Nella tabella seguente vengono illustrate la visualizzazione controlli e la visualizzazione contenuto della struttura ad albero di UI Automation relative ai controlli ToolTip e viene descritto il contenuto consentito per ogni visualizzazione. Per ulteriori informazioni sulla struttura ad albero di UI Automation, vedere Cenni preliminari sulla struttura ad albero di automazione dell'interfaccia utente.

Visualizzazione controlli	Visualizzazione contenuto
ToolTip Text (0 o più) Image (0 o più)	ToolTip

I controlli ToolTip vengono visualizzati solo nella visualizzazione contenuto della struttura ad albero di UI Automation se sono in grado di ricevere lo stato attivo. In caso contrario, tutte le informazioni relative alla descrizione comando sono disponibili in HelpTextProperty nell'elemento di UI Automation a cui fa riferimento la descrizione comando.

Le descrizioni comandi dovrebbero essere visualizzate sotto il controllo al quale si riferiscono le relative informazioni. I client devono restare in ascolto di ToolTipOpenedEvent per garantire che le informazioni contenute nelle descrizioni comandi vengano ottenute in modo coerente.

Proprietà di automazione interfaccia utente richieste

Nella tabella seguente sono elencate le proprietà dell'UI Automation il cui valore o la cui definizione è particolarmente rilevante per i controlli di descrizione comandi. Per ulteriori informazioni sulle proprietà dell'oggetto UI Automation, vedere Proprietà di automazione interfaccia utente per i client.

Proprietà di UI Automation	Valore	Note
AutomationIdProperty	Vedere le note.	Il valore di questa proprietà deve essere univoco per tutti i controlli di un'applicazione.
BoundingRectangleProperty	Vedere le note.	Rettangolo più esterno che contiene l'intero controllo.
ClickablePointProperty	Vedere le note.	Il punto selezionabile deve corrispondere alla parte della descrizione comandi che consente di chiudere il controllo. In alcune descrizioni comandi tale funzionalità non è disponibile e pertanto non esisterà alcun punto su cui fare clic.
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 descrizione comandi corrisponde al testo visualizzato all'interno della descrizione stessa.
LabeledByProperty	Null	I controlli di descrizione comandi dispongono sempre di un'etichetta generata automaticamente in base al relativo contenuto.
ControlTypeProperty	ToolTip	Questo valore è identico per tutti i framework dell'interfaccia utente.
LocalizedControlTypeProperty	"descrizione comandi"	Stringa localizzata che corrisponde al tipo di controllo ToolTip.
IsContentElementProperty	A seconda dei casi	Se il controllo di descrizione comandi può ricevere lo stato attivo, tale stato deve essere ricevuto nella visualizzazione contenuto della struttura ad albero. Se si tratta unicamente di testo, questo sarà disponibile come HelpTextProperty dal controllo che l'ha generato.
IsControlElementProperty	True	Il controllo descrizione comandi deve essere sempre un controllo.

Pattern di controllo di automazione interfaccia utente obbligatori

Nella tabella riportata di seguito sono elencati i pattern di controllo dell'UI Automation che i controlli di descrizione comandi dovranno supportare. Per ulteriori informazioni sui pattern di controllo, vedere Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente.

Pattern di controllo	Supporto	Note
IWindowProvider	A seconda dei casi	Le descrizioni comandi che è possibile chiudere facendo clic su un elemento dell'interfaccia utente devono supportare WindowPattern, in modo da poter essere chiuse automaticamente.
ITextProvider	A seconda dei casi	Per offrire una migliore accessibilità, un controllo ToolTip può supportare il pattern di controllo Text, anche se ciò non è obbligatorio. Il pattern di controllo Text è utile quando il testo dispone di attributi e stile formattati (ad esempio, colore, grassetto e corsivo).

Eventi di Automazione interfaccia utente obbligatori

I controlli descrizione comandi devono generare l'evento ToolTipOpenedEvent nel momento in cui vengono visualizzati sullo schermo. L'evento include un riferimento all'elemento dell'UI Automation della descrizione comandi stessa.

Nella tabella riportata di seguito sono elencati gli eventi di UI Automation che devono essere supportati da tutti i controlli di descrizione comandi. Per ulteriori informazioni sugli eventi, vedere Cenni preliminari sugli eventi di automazione interfaccia utente.

Evento UI Automation	Supporto	Note
TextSelectionChangedEvent	A seconda dei casi	Nessuno
TextChangedEvent	A seconda dei casi	Nessuno
WindowClosedEvent	A seconda dei casi	Nessuno
WindowOpenedEvent	A seconda dei casi	Nessuno
ToolTipOpenedEvent	Obbligatorio	Nessuno
ToolTipClosedEvent	Obbligatorio	Nessuno
Evento di proprietà modificata BoundingRectangleProperty.	Obbligatorio	Nessuno
Evento di proprietà modificata IsOffscreenProperty.	Obbligatorio	Nessuno
Evento di proprietà modificata IsEnabledProperty.	Obbligatorio	Nessuno
Evento di proprietà modificata NameProperty.	Obbligatorio	Nessuno
Evento di proprietà modificata WindowVisualStateProperty.	A seconda dei casi	Nessuno
AutomationFocusChangedEvent	Obbligatorio	Nessuno
StructureChangedEvent	Obbligatorio	Nessuno

Vedere anche

Riferimenti

ToolTip

Concetti

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

Cenni preliminari su automazione interfaccia utente