Supporto per l'automazione interfaccia utente del tipo di controllo TitleBar

Nota
La presente documentazione è destinata agli sviluppatori di .NET Framework che desiderano utilizzare le classi UI Automation gestite definite nello spazio dei nomi System.Windows.Automation.Per informazioni aggiornate sull'UI Automation, vedere Windows Automation API: Automazione interfaccia utente (la pagina potrebbe essere in inglese).

In questo argomento vengono fornite informazioni sul supporto di UI Automation per il tipo di controllo TitleBar. Nell'UI Automation, 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 UI Automation, i valori delle proprietà di UI Automation e i pattern di controllo.

I controlli TitleBar rappresentano titoli o barre del titolo di una finestra.

Nelle sezioni riportate di seguito vengono definiti la struttura ad albero di UI Automation, le proprietà, i pattern di controllo e gli eventi per il tipo di controllo TitleBar. I requisiti dell'UI Automation sono applicabili a tutti i controlli barra del titolo, sia Windows Presentation Foundation (WPF), Win32 o Windows Forms.

Nel presente argomento sono contenute le seguenti sezioni.

• Struttura ad albero di automazione interfaccia utente necessaria
• Proprietà di Automazione interfaccia utente obbligatorie
• Pattern di controllo dell'automazione interfaccia utente necessari
• Eventi dell'automazione interfaccia utente necessari
• Argomenti correlati

Struttura ad albero di automazione interfaccia utente necessaria

Nella tabella riportata di seguito vengono illustrate la visualizzazione controlli e la visualizzazione contenuto della struttura ad albero dell'UI Automation relative ai controlli barra del titolo e viene descritto il contenuto consentito per ciascuna visualizzazione. Per ulteriori informazioni sulla struttura ad albero di UI Automation, vedere Cenni preliminari sulla struttura ad albero di automazione dell'interfaccia utente.

Visualizzazione controlli	Visualizzazione contenuto
TitleBar Menu (0 o 1) Button (0 o più)	Non applicabile. (il controllo barra del titolo è privo di contenuto).

Proprietà di Automazione interfaccia utente obbligatorie

Nella tabella riportata di seguito sono elencate le proprietà dell'UI Automation il cui valore o la cui definizione è particolarmente rilevante per i controlli TitleBar. Per ulteriori informazioni sulle proprietà dell'oggetto UI Automation, vedere Proprietà di automazione interfaccia utente per i client.

Proprietà di UI Automation	Valore	Note
AutomationIdProperty	Vedere le note.	Il valore di questa proprietà deve essere univoco per tutti i controlli di un'applicazione.
BoundingRectangleProperty	Vedere le note.	Il rettangolo di delimitazione di una barra del titolo deve includere tutti i controlli in esso contenuti.
ClickablePointProperty	Vedere le note.	Supportata se esiste un rettangolo di delimitazione. Se non è possibile fare clic su ogni punto all'interno del rettangolo di delimitazione e vengono eseguiti hit test speciali, eseguire l'override e fornire un punto selezionabile.
IsKeyboardFocusableProperty	False	Le barre del titolo non presentano mai lo stato attivo.
NameProperty	""	La barra del titolo non è contenuto; le relative informazioni di testo vengono esposte nella finestra padre.
LabeledByProperty	Vedere le note.	Il controllo barra del titolo non dispone in genere di un'etichetta.
ControlTypeProperty	TitleBar	Questo valore è identico per tutti i framework dell'interfaccia utente.
LocalizedControlTypeProperty	"barra del titolo"	Stringa localizzata corrispondente al tipo di controllo TitleBar.
IsContentElementProperty	False	Il controllo barra del titolo non è mai contenuto.
IsControlElementProperty	True	Il controllo barra del titolo deve sempre essere un controllo.
IsOffscreenProperty	A seconda dei casi	Questo controllo restituirà un valore a seconda che la barra del titolo sia o meno visibile sullo schermo.
HelpTextProperty	""	Non è necessario esporre il testo della Guida.
AcceleratorKeyProperty	""	Le barre del titolo non dispongono mai di tasti di scelta rapida.
AccessKeyProperty	""	Il controllo barra del titolo non dispone di un tasto di scelta.

Pattern di controllo dell'automazione interfaccia utente necessari

Il tipo di controllo TitleBar non è necessario per supportare qualsiasi pattern di controllo. La relativa funzionalità viene esposta tramite il pattern di controllo Window sul controllo Window.

Eventi dell'automazione interfaccia utente necessari

Nella tabella riportata di seguito sono elencati gli eventi dell'UI Automation che devono essere supportati da tutti i controlli barra del titolo. Per ulteriori informazioni sugli eventi, vedere Cenni preliminari sugli eventi di automazione interfaccia utente.

Evento UI Automation	Supporto	Note
Evento di proprietà modificata BoundingRectangleProperty.	Obbligatorio	Nessuno
Evento di proprietà modificata IsOffscreenProperty.	Obbligatorio	Nessuno
Evento di proprietà modificata IsEnabledProperty.	Mai	Nessuno
AutomationFocusChangedEvent	Mai	Nessuno
StructureChangedEvent	Obbligatorio	Nessuno

Vedere anche

Riferimenti

TitleBar

Concetti

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

Cenni preliminari su automazione interfaccia utente