Condividi tramite

Supporto dell'automazione dell'interfaccia utente per il tipo di controllo ToolTip

Annotazioni

Questa documentazione è destinata agli sviluppatori .NET Framework che vogliono usare le classi di automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per le informazioni più recenti sull'automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.

In questo argomento vengono fornite informazioni sul supporto dell'automazione interfaccia utente per il tipo di controllo ToolTip. In Automazione interfaccia utente un tipo di controllo è un set di condizioni che un controllo deve soddisfare per usare la ControlTypeProperty proprietà . 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 pattern di controllo.

I controlli della descrizione comando sono finestre popup che contengono testo.

Le sezioni seguenti definiscono la struttura ad albero di automazione interfaccia utente, le proprietà, i pattern di controllo e gli eventi necessari per il tipo di controllo ToolTip. I requisiti di Automazione Interfaccia Utente si applicano a tutti i controlli delle descrizioni comandi, che siano Windows Presentation Foundation (WPF), Win32 o Windows Forms.

Struttura ad albero necessaria per l'automazione UI

La tabella seguente illustra la vista di controllo e la vista del contenuto dell'albero di Automazione Interfaccia Utente relativa ai controlli dei suggerimenti e descrive cosa può essere contenuto in ogni vista. Per ulteriori informazioni sull'albero di automazione dell'interfaccia utente, vedere Panoramica dell'albero di automazione interfaccia utente.

Vista di controllo Visualizzazione contenuto
Suggerimento

- Testo (0 o più)
- Immagine (0 o più)		 Suggerimento

I controlli della descrizione comando vengono visualizzati solo nella visualizzazione del contenuto dell'albero di automazione dell'interfaccia utente se possono ricevere il focus della tastiera. In caso contrario, tutte le informazioni della descrizione comando sono disponibili nell'elemento di Automazione Interfaccia Utente HelpTextProperty a cui fa riferimento la descrizione comando.

I suggerimenti degli strumenti dovrebbero essere visualizzati sotto il controllo a cui fanno riferimento le informazioni. I client devono restare in ascolto per il ToolTipOpenedEvent per assicurarsi che ottengano in modo coerente le informazioni contenute nei tooltip.

Proprietà di automazione interfaccia utente necessarie

La tabella seguente elenca le proprietà dell'interfaccia utente di automazione di cui il valore o la definizione è particolarmente rilevante per i controlli dei suggerimenti. Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Proprietà di automazione interfaccia utente per i client.

Ui Automation, proprietà Valore Note
AutomationIdProperty Vedere le note. Il valore di questa proprietà deve essere univoco in tutti i controlli di un'applicazione.
BoundingRectangleProperty Vedere le note. Rettangolo più esterno che contiene l'intero controllo.
ClickablePointProperty Vedere le note. Il punto cliccabile deve essere la parte della descrizione comando che eliminerà il controllo. Alcuni suggerimenti per gli strumenti non hanno questa capacità e non avranno un punto selezionabile.
IsKeyboardFocusableProperty Vedere le note. Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà.
NameProperty Vedere le note. Il nome del controllo descrizione comando è il testo visualizzato all'interno della descrizione comando.
LabeledByProperty Null I controlli del tooltip sono sempre auto-descritti in base al contenuto.
ControlTypeProperty Suggerimento Questo valore è lo stesso per tutti i framework dell'interfaccia utente.
LocalizedControlTypeProperty suggerimento Stringa localizzata corrispondente al tipo di controllo ToolTip.
IsContentElementProperty Dipende da Se il controllo della descrizione comando può ricevere lo stato attivo della tastiera, deve trovarsi nella visualizzazione dei contenuti dell'albero. Se è solo testo, è disponibile come HelpTextProperty dal controllo che lo ha generato.
IsControlElementProperty Vero Il controllo descrizione comando deve essere sempre un controllo.

Modelli di controllo di automazione interfaccia utente necessari

Nella tabella seguente sono elencati i modelli di controllo di automazione interfaccia utente necessari per essere supportati dai controlli della 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 Assistenza Note
IWindowProvider Dipende da I suggerimenti per gli strumenti che possono essere chiusi facendo clic su un elemento dell'interfaccia utente devono supportare WindowPattern in modo che possano essere chiusi automaticamente.
ITextProvider Dipende da Per una migliore accessibilità, un controllo descrizione comando può supportare il modello di controllo del 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).

Eventi di automazione interfaccia utente necessari

I controlli della descrizione comando devono generare l'oggetto ToolTipOpenedEvent quando vengono visualizzati sullo schermo. L'evento includerà un riferimento all'elemento di automazione dell'interfaccia utente del suggerimento stesso.

La tabella seguente elenca gli eventi di automazione dell'interfaccia utente che devono essere supportati da tutti i controlli tooltip. Per ulteriori informazioni sugli eventi, vedere UI Automation Events Overview.

Evento di automazione interfaccia utente Assistenza Note
TextSelectionChangedEvent Dipende da Nessuno
TextChangedEvent Dipende da Nessuno
WindowClosedEvent Dipende da Nessuno
WindowOpenedEvent Dipende da Nessuno
ToolTipOpenedEvent Obbligatorio Nessuno
ToolTipClosedEvent Obbligatorio Nessuno
Evento di cambiamento della proprietà BoundingRectangleProperty. Obbligatorio Nessuno
Evento di cambiamento della proprietà IsOffscreenProperty. Obbligatorio Nessuno
Evento di cambiamento della proprietà IsEnabledProperty. Obbligatorio Nessuno
Evento di cambiamento della proprietà NameProperty. Obbligatorio Nessuno
Evento di cambiamento della proprietà WindowVisualStateProperty. Dipende da Nessuno
AutomationFocusChangedEvent Obbligatorio Nessuno
StructureChangedEvent Obbligatorio Nessuno

Vedere anche

  • Last updated on