Scegliere il corretto visualizzatore dell'albero visivo per la tua app Windows

Un visualizzatore ad albero visuale, noto anche come visualizzatore dell'interfaccia utente, è uno strumento usato per esaminare e interagire con i componenti dell'interfaccia utente in un Windows app in fase di esecuzione.

Ciò può essere utile per la creazione di prototipi, il miglioramento delle esperienze utente e il debug dei problemi dell'interfaccia utente tramite funzionalità quali la visualizzazione e l'attraversamento della gerarchia dei componenti, l'evidenziazione dei componenti, il recupero e l'impostazione dello stato e il deep linking al codice associato.

La tabella seguente identifica diversi strumenti di visualizzazione dell'interfaccia utente e i framework dell'interfaccia utente e le piattaforme Windows app supportati. Un riepilogo di ogni strumento è disponibile dopo la tabella.

Piattaforma/framework dell'interfaccia utente Visual Studio - Struttura ad albero visuale attiva Spy++ Informazioni dettagliate sull'accessibilità Chromium UI DevTools
WinUI nel Windows App SDK Supported Non supportato Supported Non supportato
WPF Supported Non supportato Supported Non supportato
React Native per Desktop Supported Non supportato Supported Supported
.NET MAUI Supported Non supportato Supported Non supportato
WinForms Supported Supported Supported Non supportato
WinUI per UWP per UWP Supported Non supportato Supported Non supportato
App Classic Visual Basic Non supportato Supported Non supportato Non supportato
Applicazioni classiche Win32 Non supportato Supported Non supportato Non supportato
App basate su Chromium Non supportato Non supportato Non supportato Supported

Visual Studio - Struttura ad albero visuale attiva

Le funzionalità Live Visual Tree e Live Property Explorer vengono fornite con Visual Studio e funzionano insieme per fornire una visualizzazione interattiva in fase di esecuzione degli elementi dell'interfaccia utente nell'app.

Quando usare la struttura ad albero visuale attiva

Usa questi strumenti per la creazione di app con WinUI 3 nel Windows App SDK, WinUI per UWP per UWP, WPF, .NET MAUI, WinForms, o React Native for Desktop.

Annotazioni

Il visualizzatore albero WPF è una funzionalità legacy e non è in fase di sviluppo attivo. È possibile utilizzare il visualizzatore albero di WPF per esplorare la struttura ad albero visuale di un oggetto WPF e visualizzare le proprietà di dipendenza WPF per gli oggetti contenuti in tale albero.

Come usare il Visual Tree attivo

XAML Hot Reload deve essere abilitata per visualizzare l'albero visuale attivo (questa funzionalità è abilitata per impostazione predefinita in Visual Studio 2019 e versioni successive).

Per verificare se la Hot Reload XAML è abilitata, eseguire l'app con il debugger Visual Studio collegato (F5 o Debug -> Avvia debug). All'avvio dell'app verrà visualizzata la barra degli strumenti in-app, che conferma che il Hot Reload XAML è disponibile (come illustrato nell'immagine seguente).

Screenshot della barra degli strumenti di debug di Visual Studio per l'applicazione.

Se la barra degli strumenti in-app non è visualizzata, selezionare Debug > Options > XAML Hot Reload dalla barra dei menu Visual Studio. Nella finestra di dialogo Options assicurarsi che sia selezionata l'opzione Enable XAML Hot Reload.

Screenshot della finestra di dialogo delle opzioni di debug di Visual Studio con

Quando l'app è in esecuzione nella configurazione di debug (con il debugger collegato), passa alla barra dei menu di Visual Studio (Debug > Windows > Albero Visivo Live). Si aprirà il riquadro della Struttura ad albero visiva attiva con una visualizzazione in tempo reale del codice XAML.

Per impostazione predefinita, è selezionata l'opzione Just My XAML per la struttura ad albero visuale attiva. Ciò offre una visualizzazione semplificata della raccolta di elementi XAML nella tua app e può essere attivata o disattivata tramite il pulsante Show Just My XAML come illustrato nell'immagine seguente.

Screenshot dell'albero visivo attivo di Visual Studio con l'opzione

Funzionalità attive della struttura visuale ad albero

La barra degli strumenti Live Visual Tree fornisce diverse opzioni per la selezione di elementi da esaminare tramite l'interfaccia utente dell'applicazione durante l'esecuzione.

  • Selezionare Elemento nell'applicazione in esecuzione. Con questa modalità attivata, quando si seleziona un elemento dell'interfaccia utente nell'applicazione, l'albero visuale attivo viene aggiornato automaticamente per visualizzare il nodo ed è proprietà nell'albero corrispondente a tale elemento.

    Screenshot della struttura ad albero visuale attiva di Visual Studio con l'opzione

  • Mostrare i decoratori del layout nell'applicazione in esecuzione. Con questa modalità attivata, la finestra dell'applicazione mostra linee orizzontali e verticali lungo i limiti di un oggetto selezionato e un rettangolo che ne delinea i margini.

    Screenshot della Visualizzazione dal vivo dell'albero visivo di Visual Studio con gli ornamenti layout di visualizzazione nell'opzione Applicazione in esecuzione abilitata.

  • Selezione anteprima. Con questa modalità attivata, Visual Studio mostra il codice XAML dove è dichiarato l'elemento (se hai accesso al codice sorgente dell'applicazione).

    Screenshot dell'albero visivo Live di Visual Studio con l'opzione di selezione Anteprima abilitata.

Spy++

Spy++ (SPYXX.EXE) è un'utilità basata su Win32 fornita con Visual Studio e offre una visualizzazione grafica dei processi, dei thread, delle finestre e dei messaggi delle finestre del sistema.

Quando usare Spy++

Usa Spy++ per creare un'applicazione Win32 classica o una che usa le API Win32 per disegnare i relativi elementi dell'interfaccia utente, ad esempio WinForms e Classic Visual Basic app.

Annotazioni

Per .NET app framework, Spy++ è di utilità limitata perché i messaggi e le classi della finestra intercettati da Spy++ non corrispondono a eventi gestiti e valori delle proprietà.

Come usare Spy++

Spy++ può essere avviato da Visual Studio o dal prompt dei comandi per gli sviluppatori per Visual Studio.

Per avviare Spy++ da Visual Studio:

  • Verificare che l'installazione di Visual Studio includa il componente funzionalità principali del desktop con C++ dal carico di lavoro Sviluppo desktop con C++. Questa opzione viene installata per impostazione predefinita con Visual Studio 2026. Screenshot del programma di installazione di Visual Studio con la scheda Sviluppo desktop con C++ selezionata e lo stato di installazione delle funzionalità desktop di base di C++ evidenziato.
  • Quando è installato, Spy++ è disponibile dal menu Strumenti .
  • Spy++ viene eseguito indipendentemente dal Visual Studio, che può essere chiuso se non è più necessario.

Per avviare Spy++ dal prompt dei comandi per gli sviluppatori per Visual Studio:

  • Avvia Prompt dei comandi per sviluppatori per Visual Studio dal menu Windows Start. Screenshot del menu Start di Windows con il prompt dei comandi per gli sviluppatori per VS 2022 evidenziato.
  • Al prompt dei comandi immettere spyxx.exe (o spyxx_amd64.exe per la versione a 64 bit) e premere INVIO.

Per informazioni più specifiche su come usare Spy++ da Visual Studio, vedere barra degli strumenti Spy++.

Funzionalità di Spy++

Spy++ visualizza un albero grafico delle relazioni tra gli oggetti di sistema, con la finestra desktop corrente nella parte superiore dell'albero e dei nodi figlio che rappresentano tutte le altre finestre elencate in base alla gerarchia di finestre standard. Può fornire informazioni dettagliate preziose sul comportamento di un'applicazione che non è disponibile tramite il debugger di Visual C++.

Screenshot della finestra dell'applicazione Spy++.

Con Spy++ è possibile:

  • Cerca finestre, thread, processi o messaggi specifici.
  • Visualizzare le proprietà dei processi o dei messaggi selezionati.
  • Selezionare una finestra, un thread, un processo o un messaggio direttamente nella visualizzazione albero.
  • Usa lo strumento Finder per selezionare una finestra usando il puntatore del mouse (Cerca -> Trova finestra). Screenshot della finestra di dialogo Trova Spy++.
  • Impostare un'opzione di messaggio usando un parametro complesso di selezione del log dei messaggi.

Per la documentazione di Spy++, vedere la Guida di Spy++.

Informazioni dettagliate sull'accessibilità per Windows - Live Inspect

Accessibility Insights per Windows - Live Inspect è un'applicazione Microsoft scaricabile che consente agli sviluppatori di trovare e risolvere i problemi di accessibilità nelle app di Windows che supportano UI Automation. Consente agli sviluppatori di verificare che un elemento in un'app abbia le proprietà UI Automation corrette semplicemente passando il puntatore del mouse sull'elemento o impostando lo stato attivo della tastiera su di esso.

Quando usare Accessibility Insights - Live Inspect

Live Inspect viene in genere usato insieme a Live Visual Tree, Spy++e altri strumenti per la creazione di app con WinUI nel Windows App SDKWinUI per UWP per UWP, WPF, .NET MAUI, WinForms o React Native for Desktop.

Come usare Accessibility Insights - Live Inspect

Accessibility Insights deve essere scaricato e installato da Download Accessibility Insights.

Funzionalità di Accessibility Insights - Live Inspect

Live Inspect visualizza un albero grafico delle relazioni tra gli oggetti di sistema con riquadri di dettaglio contenenti le proprietà e i modelli UI Automation corrispondenti all'elemento selezionato. La finestra desktop corrente viene visualizzata nella parte superiore dell'albero, con i nodi figlio che rappresentano tutte le altre finestre elencate secondo la gerarchia standard delle finestre.

Con Live Inspect è possibile:

  • Verificare che un elemento in un'app abbia le proprietà UI Automation corrette semplicemente passando il puntatore del mouse sull'elemento o impostando lo stato attivo della tastiera su di esso.
  • Evidenzia visivamente gli elementi nell'applicazione di destinazione.
  • Controlli o modelli di test con controlli manuali o automatizzati per la conformità con numerose regole di accessibilità e linee guida.

Schermata dello strumento Accessibility Insights accanto a un'applicazione destinata di base.

Per ulteriori informazioni su UI Automation, vedere Panoramica di UI Automation.

Per altre informazioni su Accessibility Insights, vedere Accessibility Insights for Windows (Informazioni dettagliate sull'accessibilità per Windows)

Strumenti Dev per UI di Chromium per Windows

Chromium UI DevTools per Windows è uno strumento di Google che consente di esaminare il sistema dell'interfaccia utente come una pagina Web usando il front-end DevTools Inspector.

Quando usare Chromium UI DevTools per Windows

Usa Chrome UI DevTools se stai sviluppando un progetto Chromium, incluse le progressive web app o le app desktop Electron. Per altre informazioni su Electron, vedere l'estensione DevTools su GitHub.

Come usare Chromium UI DevTools per Windows

La codebase DevTools dell'interfaccia utente chromium per Windows deve essere scaricata da GitHub e compilata con Visual Studio. Per altre informazioni, vedere la Panoramica dell'Interfaccia utente di DevTools.

Funzionalità di Chromium UI DevTools per Windows

Chromium UI DevTools per Windows usa un front-end della pagina Web per visualizzare e attraversare visualizzazioni, finestre e altri elementi dell'interfaccia utente.

Con Chromium UI DevTools per Windows è possibile:

  • Usare un albero degli elementi dell'interfaccia utente gerarchico per controllare gli elementi dell'interfaccia utente e le relative proprietà.
  • Usare la modalità Inspect, che evidenzia un elemento dell'interfaccia utente quando si passa il puntatore del mouse su di esso e rivela i nodi dell'elemento nell'albero degli elementi dell'interfaccia utente.
  • Usare il pannello Elementi per aprire una barra di ricerca e trovare un elemento nell'albero degli elementi dell'interfaccia utente usando le proprietà name, tag e style.
  • Usare il pannello Origini per aprire il file di intestazione della classe nella ricerca del codice Chromium e importare il codice dai file locali.