Condividi tramite

Panoramica dell'automazione interfaccia utente

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.

Automazione interfaccia utente Microsoft è il nuovo framework di accessibilità per Microsoft Windows, disponibile in tutti i sistemi operativi che supportano Windows Presentation Foundation (WPF).

Automazione interfaccia utente fornisce l'accesso a livello di codice alla maggior parte degli elementi dell'interfaccia utente sul desktop, consentendo ai prodotti di assistive technology, ad esempio le utilità per la lettura dello schermo, di fornire informazioni sull'interfaccia utente agli utenti finali e di modificare l'interfaccia utente con mezzi diversi dall'input standard. Automazione interfaccia utente consente anche agli script di test automatizzati di interagire con l'interfaccia utente.

Annotazioni

L'Automazione Interfaccia Utente non abilita la comunicazione tra processi avviati da diversi utenti attraverso il comando Esegui come.

Le applicazioni client di automazione interfaccia utente possono essere scritte con la certezza che funzioneranno su più framework. L'automazione dell'interfaccia utente maschera le differenze nei framework che sottendono i vari componenti dell'interfaccia utente. Ad esempio, la Content proprietà di un pulsante WPF, la Caption proprietà di un pulsante Win32 e la ALT proprietà di un'immagine HTML sono tutte mappate a una singola proprietà, Name, nella visualizzazione Automazione interfaccia utente.

Automazione dell'Interfaccia Utente offre funzionalità complete nei sistemi operativi Windows supportati che eseguono il .NET Framework (vedere i requisiti di sistema di .NET Framework) o versioni di .NET Core a partire dalla versione 3.0 di .NET Core.

I provider di automazione dell'interfaccia utente offrono un certo supporto per le applicazioni client Microsoft Active Accessibility tramite un servizio di bridging predefinito.

Provider e clienti

Automazione interfaccia utente include quattro componenti principali, come illustrato nella tabella seguente.

Componente Descrizione
Provider API (UIAutomationProvider.dll e UIAutomationTypes.dll) Set di definizioni di interfaccia implementate dai provider di automazione interfaccia utente, oggetti che forniscono informazioni sugli elementi dell'interfaccia utente e rispondono all'input programmatico.
API del client (UIAutomationClient.dll e UIAutomationTypes.dll) Set di tipi per il codice gestito che consente alle applicazioni client di automazione interfaccia utente di ottenere informazioni sull'interfaccia utente e inviare input ai controlli.
UiAutomationCore.dll Il codice sottostante (talvolta denominato core di automazione interfaccia utente) che gestisce la comunicazione tra provider e client.
UIAutomationClientsideProviders.dll Set di provider di automazione interfaccia utente per i controlli legacy standard. I controlli WPF dispongono del supporto nativo per Automazione interfaccia utente. Questo supporto è disponibile automaticamente per le applicazioni client.

Dal punto di vista dello sviluppatore software, esistono due modi per usare Automazione interfaccia utente: per creare il supporto per i controlli personalizzati (usando l'API del provider) e la creazione di applicazioni che usano il core di Automazione interfaccia utente per comunicare con gli elementi dell'interfaccia utente (usando l'API client). A seconda dell'attenzione, è necessario fare riferimento a diverse parti della documentazione. Per altre informazioni sui concetti e sulle procedure pratiche, vedere le sezioni seguenti.

Sezione Tema Destinatari
Nozioni fondamentali su Automazione interfaccia utente (questa sezione) Panoramiche generali dei concetti. Tutti.
Provider di automazione dell'interfaccia utente per codice gestito Argomenti di panoramica e guida per aiutarti a utilizzare l'API del provider. Controllare gli sviluppatori.
Client di automazione dell'interfaccia utente per codice gestito Panoramiche e guide pratiche per l'uso dell'API client. Sviluppatori di applicazioni client.
Schemi di Controllo per l'Automazione dell'Interfaccia Utente Informazioni sul modo in cui i pattern di controllo devono essere implementati dai provider e sulle funzionalità disponibili per i client. Tutti.
modello di testo di automazione interfaccia utente Informazioni sulla modalità di implementazione del pattern di controllo text da parte dei provider e sulle funzionalità disponibili per i client. Tutti.
tipi di controllo di automazione interfaccia utente Informazioni sulle proprietà e i pattern di controllo supportati da tipi di controllo diversi. Tutti.

La tabella seguente elenca i namespace di UI Automation, le DLL che li contengono e il gruppo di destinatari che li usa.

Namespace DLL a cui si fa riferimento Destinatari
System.Windows.Automation UIAutomationClientUIAutomationTypes Sviluppatori client di automazione dell'interfaccia utente; utilizzati per trovare oggetti AutomationElement, registrarsi per gli eventi dell'automazione dell'interfaccia utente e usare i modelli di controllo dell'automazione dell'interfaccia utente.
System.Windows.Automation.Provider UIAutomationProviderUIAutomationTypes Sviluppatori di provider di automazione interfaccia utente per framework diversi da WPF.
System.Windows.Automation.Text UIAutomationClientUIAutomationTypes Sviluppatori di provider di automazione dell'interfaccia utente per framework diversi da WPF e utilizzati per implementare il modello di controllo TextPattern.
System.Windows.Automation.Peers PresentationFramework Sviluppatori di provider di automazione dell'interfaccia utente per WPF.

Modello di automazione interfaccia utente

L'automazione dell'interfaccia utente espone ogni parte dell'interfaccia utente alle applicazioni client come AutomationElement. Gli elementi sono contenuti in una struttura ad albero, con il desktop come elemento radice. I clienti possono filtrare la vista grezza dell'albero come visualizzazione di controllo o visualizzazione dei contenuti. Le applicazioni possono anche creare visualizzazioni personalizzate.

AutomationElement gli oggetti espongono proprietà comuni degli elementi dell'interfaccia utente che rappresentano. Una di queste proprietà è il tipo di controllo, che definisce l'aspetto e la funzionalità di base come una singola entità riconoscibile, ad esempio un pulsante o una casella di controllo.

Inoltre, gli elementi espongono pattern di controllo che forniscono proprietà specifiche per i relativi tipi di controllo. I pattern di controllo espongono anche metodi che consentono ai client di ottenere ulteriori informazioni sull'elemento e di fornire input.

Annotazioni

Non esiste una corrispondenza uno-a-uno tra i tipi di controllo e i pattern di controllo. Un pattern di controllo può essere supportato da più tipi di controllo e un controllo può supportare più pattern di controllo, ognuno dei quali espone diversi aspetti del comportamento. Ad esempio, una casella combinata ha almeno due pattern di controllo: uno che rappresenta la capacità di espandersi e ridursi e un altro che rappresenta il meccanismo di selezione. Per informazioni specifiche, vedere Tipi di controllo di automazione interfaccia utente.

Automazione interfaccia utente fornisce anche informazioni alle applicazioni client tramite eventi. A differenza di WinEvents, gli eventi di automazione interfaccia utente non sono basati su un meccanismo di trasmissione. I client di automazione dell'interfaccia utente si registrano per notifiche di eventi specifiche e possono richiedere che proprietà specifiche dell'automazione dell'interfaccia utente e informazioni sui modelli di controllo siano passate ai loro gestori eventi. Inoltre, un evento di automazione interfaccia utente contiene un riferimento all'elemento che lo ha generato. I provider possono migliorare le prestazioni generando eventi in modo selettivo, a seconda che ci siano clienti in ascolto.

Vedere anche