Tipo di controllo ToolTip

  • Articolo

In questo argomento vengono fornite informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo ToolTip. I controlli descrizione comando sono finestre popup che contengono testo.

Le sezioni seguenti definiscono la struttura ad albero Automazione interfaccia utente, le proprietà, i pattern di controllo e gli eventi necessari per il tipo di controllo ToolTip. I requisiti Automazione interfaccia utente si applicano a tutti i controlli della descrizione comando 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 descrizione comando 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
  • ToolTip
    • Text (0 o più)
    • Image (0 o più)
  • ToolTip

 

I controlli descrizione comando vengono visualizzati solo nella visualizzazione contenuto dell'albero 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 comando 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

Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per il tipo di controllo ToolTip. 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 punto selezionabile deve essere la parte della descrizione comando che ignora il controllo. Alcune descrizioni comando non hanno questa capacità e non avranno un punto selezionabile.
UIA_ControlTypePropertyId ToolTip
UIA_IsContentElementPropertyId Dipende da 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 l'ha generata.
UIA_IsControlElementPropertyId True Il controllo descrizione comando è 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_LabeledByPropertyId NULL I controlli descrizione comando vengono sempre etichettati automaticamente 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 english (Stati Uniti).
UIA_NamePropertyId Vedere le note. Il nome del controllo descrizione comando è il testo visualizzato all'interno della descrizione comando.

 

Pattern di controllo obbligatori

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

Pattern di controllo Supporto Note
ITextProvider Dipende da Per migliorare l'accessibilità, un controllo descrizione comando può supportare il pattern di controllo Text , anche se non è obbligatorio. Il pattern di controllo Text è utile quando il testo ha stili di formattazione e attributi, ad esempio colore, grassetto e corsivo.
IWindowProvider Dipende da Le descrizioni comando che possono essere chiuse facendo clic su un elemento dell'interfaccia utente devono supportare il pattern di controllo Window in modo che possano essere chiuse 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.

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

evento Automazione interfaccia utente Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento modificato dalla proprietà.
UIA_IsEnabledPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento.
UIA_IsOffscreenPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento.
UIA_NamePropertyId evento modificato dalla proprietà.
UIA_Text_TextChangedEventId Se il controllo supporta il modello di controllo Testo , deve supportare questo evento.
UIA_ToolTipClosedEventId
UIA_ToolTipOpenedEventId
UIA_StructureChangedEventId
UIA_Window_WindowClosedEventId Se il controllo supporta il modello di controllo Window , deve supportare questo evento.
UIA_Window_WindowOpenedEventId Se il controllo supporta il modello di controllo Window , deve supportare questo evento.
UIA_WindowWindowVisualStatePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Window , deve supportare questo evento.

 

Informazioni concettuali

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

Cenni preliminari su automazione interfaccia utente