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 per l'automazione interfaccia utente del tipo di controllo ToolTip. Nell'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 dell'automazione interfaccia utente, i valori di proprietà dell'automazione interfaccia utente 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 automazione interfaccia utente richiesti per il tipo di controllo ToolTip. I requisiti di automazione interfaccia utente si applicano a tutti i controlli ToolTip, Windows Presentation Foundation (WPF), Win32 e Windows Form.
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 dell'automazione interfaccia utente richiesti
- Eventi di automazione interfaccia utente richiesti
- Argomenti correlati
Struttura ad albero dell'automazione interfaccia utente richiesta
Nella tabella riportata di seguito vengono illustrate la visualizzazione controlli e la visualizzazione contenuto della struttura ad albero dell'automazione interfaccia utente relative ai controlli descrizione comandi e viene descritto il contenuto consentito per ciascuna visualizzazione. Per ulteriori informazioni sulla struttura ad albero dell'automazione interfaccia utente, vedere Cenni preliminari sulla struttura di automazione dell'interfaccia utente.
Visualizzazione controlli |
Visualizzazione contenuto |
|---|---|
|
|
I controlli di descrizione comandi vengono visualizzati solo nella visualizzazione contenuto della struttura ad albero dell'automazione interfaccia utente se sono in grado di ricevere lo stato attivo. In caso contrario, tutte le informazioni relative alla descrizione comandi sono disponibili in HelpTextProperty nell'elemento dell'automazione interfaccia utente a cui la descrizione comandi fa riferimento.
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'automazione interfaccia utente il cui valore o la cui definizione è particolarmente rilevante per i controlli di descrizione comandi. Per ulteriori informazioni sulle proprietà dell'automazione interfaccia utente, vedere Proprietà di automazione interfaccia utente per i client.
Proprietà automazione interfaccia utente |
Value |
Note |
|---|---|---|
AutomationIdProperty() |
Vedere le note. |
Il valore di questa proprietà deve essere univoco per tutti i controlli di un'applicazione. |
Vedere le note. |
Rettangolo più esterno che contiene l'intero controllo. |
|
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. |
|
Vedere le note. |
Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
|
Vedere le note. |
Il nome del controllo di descrizione comandi corrisponde al testo visualizzato all'interno della descrizione stessa. |
|
Null |
I controlli di descrizione comandi dispongono sempre di un'etichetta generata automaticamente in base al relativo contenuto. |
|
ToolTip |
Questo valore è identico per tutti i framework dell'interfaccia utente. |
|
"descrizione comandi" |
Stringa localizzata che corrisponde al tipo di controllo ToolTip. |
|
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. |
|
True |
Il controllo descrizione comandi deve essere sempre un controllo. |
|
Null |
Il valore della proprietà HelpText sarà sempre null per un controllo descrizione comandi. |
Pattern di controllo dell'automazione interfaccia utente richiesti
Nella tabella riportata di seguito sono elencati i pattern di controllo dell'automazione interfaccia utente 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/proprietà pattern |
Supporto/valore |
Note |
|---|---|---|
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. |
|
A seconda dei casi |
Non tutti i provider di automazione dell'interfaccia utente saranno in grado di esporre TextPattern per i controlli di descrizione comandi. |
Eventi di automazione interfaccia utente richiesti
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'automazione interfaccia utente della descrizione comandi stessa.
Nella tabella riportata di seguito sono elencati gli eventi di automazione interfaccia utente 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 di automazione interfaccia utente. |
Supporto |
Note |
|---|---|---|
A seconda dei casi |
Nessuno |
|
A seconda dei casi |
Nessuno |
|
A seconda dei casi |
Nessuno |
|
A seconda dei casi |
Nessuno |
|
TooltipOpenedEvent() |
Richiesto |
Nessuno |
TooltipClosedEvent() |
Richiesto |
Nessuno |
Evento di modifica della proprietà BoundingRectangleProperty. |
Richiesto |
Nessuno |
Evento di modifica della proprietà IsOffscreenProperty. |
Richiesto |
Nessuno |
Evento di modifica della proprietà IsEnabledProperty. |
Richiesto |
Nessuno |
Evento di modifica della proprietà NameProperty. |
Richiesto |
Nessuno |
Evento di modifica della proprietà WindowVisualStateProperty. |
A seconda dei casi |
Nessuno |
Richiesto |
Nessuno |
|
Richiesto |
Nessuno |
Vedere anche
Concetti
Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente
Cenni preliminari su automazione interfaccia utente