Tipo di controllo ToolTip
In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo tooltip. I controlli descrizione comando sono finestre popup che contengono testo.
Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i pattern di controllo e gli eventi necessari per la descrizione comando tipo di controllo. I requisiti di automazione interfaccia utente si applicano a tutti i controlli della descrizione comando 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
- 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 descrizione comando 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 descrizione comando vengono visualizzati solo nella visualizzazione contenuto dell'albero di automazione interfaccia utente se possono ricevere lo stato attivo della tastiera. In caso contrario, tutte le informazioni della descrizione comando sono disponibili dalla proprietà IUIAutomationElement::CurrentHelpText (o CachedHelpText) sull'elemento a cui fa riferimento la descrizione comando.
Le descrizioni comandi devono essere visualizzate sotto il controllo a cui fanno riferimento le informazioni. I client devono restare in ascolto del UIA_ToolTipOpenedEventId per assicurarsi che ottengano in modo coerente le informazioni contenute nelle descrizioni comando.
Proprietà pertinenti
La tabella seguente elenca le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per il tipo di controllo descrizione comando. 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 punto selezionabile deve essere la parte della descrizione comando che chiude il controllo. Alcune descrizioni comando non hanno questa capacità e non avranno un punto selezionabile. |
| UIA_ControlTypePropertyId | tooltip | |
| UIA_IsContentElementPropertyId | Dipende | Se il controllo descrizione comando può ricevere lo stato attivo della tastiera, deve essere visualizzato nella visualizzazione contenuto dell'albero. Se è solo testo, è disponibile come proprietà IUIAutomationElement::CurrentHelpText (o CachedHelpText) dal controllo che lo ha generato. |
| UIA_IsControlElementPropertyId | Vero | Il controllo descrizione comando è 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_LabeledByPropertyId | NULLO | I controlli descrizione comando sono sempre auto-etichettati in base al relativo contenuto. |
| UIA_LocalizedControlTypePropertyId | Vedere le note. | Stringa localizzata corrispondente al tipo di controllo ToolTip. Il valore predefinito è "tooltip" per en-US o inglese (Stati Uniti). |
| UIA_NamePropertyId | Vedere le note. | Il nome del controllo descrizione comando è il testo visualizzato all'interno della descrizione comando. |
Modelli di controllo obbligatori
La tabella seguente elenca i pattern di controllo di automazione interfaccia utente necessari per essere supportati dai controlli descrizione comando. 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 | Appoggiare | Note |
|---|---|---|
| ITextProvider | Dipende | Per una migliore accessibilità, un controllo descrizione comando può supportare il pattern di controllo testo, anche se non è obbligatorio. Il pattern di controllo Testo è utile quando il testo ha uno stile e attributi avanzati (ad esempio, colore, grassetto e corsivo). |
| IWindowProvider | Dipende | Le descrizioni comando che possono essere chiuse facendo clic su un elemento dell'interfaccia utente devono supportare il pattern di controllo finestra in modo che possano essere chiusi automaticamente. |
Eventi obbligatori
I controlli descrizione comando devono generare l'evento UIA_ToolTipOpenedEventId quando vengono visualizzati sullo schermo. L'evento includerà un riferimento all'elemento automazione interfaccia utente della descrizione comando stessa.
La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per supportare i controlli descrizione comando. 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_Text_TextChangedEventId | Se il controllo supporta il pattern di controllo text, deve supportare questo evento. |
| UIA_ToolTipClosedEventId | |
| UIA_ToolTipOpenedEventId | |
| UIA_StructureChangedEventId | |
| UIA_Window_WindowClosedEventId | Se il controllo supporta il pattern di controllo Window, deve supportare questo evento. |
| UIA_Window_WindowOpenedEventId | Se il controllo supporta il pattern di controllo Window, deve supportare questo evento. |
| UIA_WindowWindowVisualStatePropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Window, deve supportare questo evento. |
Argomenti correlati