Usare i controlli WPF nelle soluzioni Office

  • Articolo

Anche se le soluzioni create tramite gli strumenti di sviluppo di Office in Visual Studio sono progettate per essere usate direttamente con i controlli Windows Form, è possibile usare anche i controlli WPF nelle soluzioni. Windows Presentation Foundation (WPF) è un'alternativa a Windows Form per progettare interfacce utente. In WPF viene usato un linguaggio di markup, denominato Extensible Application Markup Language (XAML), che offre nuove tecniche per l'incorporazione di interfacce utente, supporti e documenti. Per altre informazioni, vedere Panoramica di WPF.

Si applica a: le informazioni contenute in questo argomento si applicano ai progetti a livello di documento e ai progetti di componente aggiuntivo VSTO. Vedere Funzionalità disponibili per app Office lication e tipo di progetto.

Qualsiasi elemento dell'interfaccia utente che può contenere i controlli Windows Form in una soluzione Office può ospitare anche i controlli WPF, Sono inclusi i seguenti elementi:

  • Documenti e fogli di lavoro nelle personalizzazioni a livello di documento.

  • Riquadri azione nelle personalizzazioni a livello di documento.

  • Riquadri attività personalizzati nei componenti aggiuntivi VSTO.

  • Aree del modulo nei componenti aggiuntivi VSTO per Outlook.

Aggiungere controlli WPF ai progetti office in fase di progettazione

Non è possibile aggiungere i controlli WPF direttamente agli elementi dell'interfaccia utente nelle soluzioni Office. Aggiungere invece un elemento Controllo utente (WPF) al progetto e usarlo come area di progettazione per i controlli WPF. Aggiungere quindi il controllo utente WPF a un elemento dell'interfaccia utente nel progetto.

Per aggiungere i controlli WPF a un riquadro azioni, un riquadro attività personalizzato o un'area del modulo

  1. Aprire un progetto al quale si vuole aggiungere un riquadro attività personalizzato, un riquadro azioni o un'area del modulo.

  2. Aggiungere un elemento Controllo utente (WPF) al progetto.

  3. Dalla casella degli strumenti aggiungere controlli WPF all'area di progettazione del controllo utente WPF.

    Per impostazione predefinita, quando la finestra di progettazione controlli utente WPF è aperta, la casella degli strumenti contiene solo controlli WPF.

  4. Compilare il progetto.

  5. Aggiungere un riquadro azioni, un'area del modulo o un riquadro attività personalizzato al progetto:

  6. Dalla scheda Controlli utente WPF NomeProgettodella casella degli strumenti trascinare il controllo utente WPF nella finestra di progettazione per il riquadro azioni, l'area del modulo o il riquadro attività personalizzato.

    Visual Studio crea automaticamente un oggetto ElementHost che contiene il controllo utente WPF nell'elemento dell'interfaccia utente.

  7. Ricompilare il progetto.

Per aggiungere controlli WPF a un documento o un foglio di lavoro in un progetto a livello di documento

  1. Aprire un progetto a livello di documento per Word o Excel.

  2. Aggiungere un elemento Controllo utente (WPF) al progetto.

  3. Dalla casella degli strumenti aggiungere controlli WPF all'area di progettazione del controllo utente WPF.

  4. Compilare il progetto.

  5. Aggiungere un elemento controllo utente (ovvero un controllo utente Windows Form) al progetto.

  6. Aprire la finestra di progettazione per il controllo utente Windows Form.

  7. Dalla scheda Controlli utente WPF NomeProgettodella casella degli strumenti trascinare il controllo utente WPF nella finestra di progettazione.

    Visual Studio crea automaticamente un oggetto ElementHost che contiene il controllo utente WPF nel controllo utente Windows Form.

  8. Scrivere il codice che aggiunge a livello di codice il controllo utente Windows Form al documento o alla cartella di lavoro. Per altre informazioni, vedere Aggiungere controlli ai documenti di Office in fase di esecuzione.

    Nota

    Non è possibile trascinare il controllo utente Windows Form nel documento o nel foglio di lavoro nella finestra di progettazione.

  9. Ricompilare il progetto.

Ospitare controlli WPF usando la classe ElementHost

In Visual Studio vengono fornite funzionalità che consentono di usare i controlli Windows Form nelle soluzioni Office, ma non vengono fornite funzionalità simili per i controlli WPF. Ad esempio, è possibile aggiungere controlli Windows Form a documenti e fogli di lavoro in fase di progettazione trascinando i controlli dalla casella degli strumenti o in fase di esecuzione usando metodi helper. Questi strumenti non sono tuttavia disponibili per i controlli WPF.

I controlli WPF usano la classe ElementHost come livello di integrazione tra un form o un controllo Windows Form e i controlli WPF. Quando si aggiungono i controlli WPF alla soluzione in fase di progettazione, Visual Studio genera automaticamente un oggetto ElementHost.

Risorse WPF

Per altre informazioni sulle problematiche di progettazione e architettura per l'hosting dei controlli WPF in form e controlli Windows Form, vedere gli argomenti seguenti:

Per altre informazioni sull'aggiunta dei controlli WPF a form e controlli Windows Form in Visual Studio in fase di progettazione, vedere gli argomenti seguenti:

Contenuto correlato