Supporto per l'automazione dell'interfaccia utente del tipo di controllo ToolTip
Nota
Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di Automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su Automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
Questo argomento fornisce informazioni sul supporto per Automazione interfaccia utente per il tipo di controllo ToolTip. In Automazione interfaccia utente, un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare per poter utilizzare la proprietà ControlTypeProperty. Le condizioni includono linee guida specifiche per la struttura ad albero di Automazione interfaccia utente, i valori delle proprietà di Automazione interfaccia utente e i criteri di controllo.
I controlli descrizione comando sono finestre popup contenenti testo.
Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i criteri di controllo e gli eventi di Automazione interfaccia utente previsti per il tipo di controllo ToolTip. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli descrizione comando, siano essi Windows Presentation Foundation (WPF), Win32 o Windows Form.
Struttura ad albero di automazione interfaccia utente obbligatoria
La tabella seguente mostra la vista controllo e la vista contenuto dell'albero di Automazione interfaccia utente che riguarda i controlli descrizione comando e descrive cosa può essere contenuto in ogni vista. Per altre informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
| ToolTip - Testo (0 o più) - Immagine (0 o più) |
ToolTip |
I controlli descrizione comando vengono visualizzati solo nella vista 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 in HelpTextProperty sull'elemento di Automazione interfaccia utente a cui la descrizione comando fa riferimento.
Le descrizioni comandi devono essere visualizzate sotto il controllo a cui si riferiscono le relative informazioni. I client devono attendere l'evento ToolTipOpenedEvent per garantire che le informazioni contenute nelle descrizioni comandi vengano recuperate in modo coerente.
Proprietà di automazione interfaccia utente obbligatorie
La tabella seguente elenca le proprietà di Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli descrizione comando. Per altre informazioni sulle proprietà di Automazione interfaccia utente, vedere Proprietà di Automazione interfaccia utente per i client.
| Proprietà di automazione interfaccia utente | Valore | Note |
|---|---|---|
| AutomationIdProperty | Vedere le note. | Il valore di questa proprietà deve essere univoco in tutti i controlli in un'applicazione. |
| BoundingRectangleProperty | Vedere le note. | Il rettangolo più esterno che contiene l'intero controllo. |
| ClickablePointProperty | Vedere le note. | Il punto selezionabile deve essere parte della descrizione comando che consente di chiudere il controllo. Alcune descrizioni comandi non dispongono di questa funzione e non avranno un punto selezionabile. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| NameProperty | Vedere le note. | Il nome del controllo descrizione comando è il testo visualizzato all'interno della descrizione. |
| LabeledByProperty | Null |
Ai controlli descrizione comando viene automaticamente applicata un'etichetta in base al relativo contenuto. |
| ControlTypeProperty | ToolTip | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "tool tip" | Stringa localizzata corrispondente al tipo di controllo ToolTip. |
| IsContentElementProperty | Dipende da | Se il controllo descrizione comando può ricevere lo stato attivo, deve essere incluso nella visualizzazione contenuto dell'albero. Se è solo testo, è disponibile come proprietà HelpTextProperty dal controllo che lo ha generato. |
| IsControlElementProperty | Vero | Il controllo descrizione comando deve essere sempre un controllo. |
Pattern di controllo obbligatori per l'automazione interfaccia utente
La tabella seguente elenca i criteri di controllo di Automazione interfaccia utente che devono essere supportati dai controlli descrizione comando. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo | Supporto tecnico | Note |
|---|---|---|
| IWindowProvider | Dipende da | Le descrizioni comandi che possono essere chiuse facendo clic su un elemento dell'interfaccia utente devono supportare WindowPattern, in modo da poter essere chiuse automaticamente. |
| ITextProvider | Dipende da | Per una migliore accessibilità un controllo descrizione comando può supportare il pattern di controllo Text, anche se ciò non è obbligatorio. Il pattern di controllo Text è utile quando il testo ha stili di formattazione e attributi, ad esempio colore, grassetto e corsivo. |
Eventi di automazione interfaccia utente obbligatori
I controlli descrizione comando devono generare un evento ToolTipOpenedEvent quando vengono visualizzati sullo schermo. L'evento includerà un riferimento all'elemento di Automazione interfaccia utente della descrizione comando stessa.
La tabella seguente elenca gli eventi di Automazione interfaccia utente che devono essere supportati da tutti i controlli descrizione comando. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di Automazione interfaccia utente | Supporto tecnico | Note |
|---|---|---|
| TextSelectionChangedEvent | Dipende da | None |
| TextChangedEvent | Dipende da | None |
| WindowClosedEvent | Dipende da | None |
| WindowOpenedEvent | Dipende da | None |
| ToolTipOpenedEvent | Richiesto | None |
| ToolTipClosedEvent | Richiesto | None |
| Evento di modifica della proprietàBoundingRectangleProperty . | Richiesto | None |
| Evento di modifica della proprietàIsOffscreenProperty . | Richiesto | None |
| Evento di modifica della proprietàIsEnabledProperty . | Richiesto | None |
| Evento di modifica della proprietàNameProperty . | Richiesto | None |
| Evento di modifica della proprietàWindowVisualStateProperty . | Dipende da | None |
| AutomationFocusChangedEvent | Richiesto | None |
| StructureChangedEvent | Richiesto | None |