Utilizzo dei controlli WPF nelle soluzioni Office

  • Articolo

Aggiornamento: novembre 2007

Windows Presentation Foundation (WPF) è un'alternativa a Windows Form per progettare interfacce utente. In WPF viene utilizzato un linguaggio di markup, denominato Extensible Application Markup Language (XAML), che offre nuove tecniche per l'incorporazione di UI, supporti e documenti. Per ulteriori informazioni, vedere Introduzione a Windows Presentation Foundation.

Sebbene le soluzioni Visual Studio Tools per Office siano progettate per utilizzare i controlli Windows Form, nelle soluzioni è anche possibile utilizzare i controlli WPF. Qualsiasi elemento dell'interfaccia utente che può contenere i controlli Windows Form in una soluzione Visual Studio Tools per Office può ospitare anche i controlli WPF, tra cui:

  • 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 a livello di applicazione.

  • Aree di modulo nei componenti aggiuntivi a livello di applicazione per Outlook.

Aggiunta di controlli WPF ai progetti di Visual Studio Tools per Office in fase di progettazione

Non è possibile aggiungere i controlli WPF direttamente agli elementi dell'interfaccia utente nelle soluzioni Visual Studio Tools per Office. È possibile, invece, aggiungere un elemento Controllo utente (WPF) al progetto e utilizzarlo come area di progettazione per i controlli WPF. Quindi, aggiungere 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 di modulo

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

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

  3. Dalla Casella degli strumenti, aggiungere i controlli WPF all'area di progettazione dei controlli utente WPF.

    Per impostazione predefinita, quando la finestra di progettazione del controllo utente WPF è aperta, nella Casella degli strumenti sono presenti solo controlli WPF.

  4. Generare il progetto.

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

  6. Dalla scheda Controlli utente WPF di NomeProgetto della 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.

    Viene automaticamente creato un oggetto ElementHost contenente il controllo utente WPF nell'elemento dell'interfaccia utente.

  7. Rigenerare il progetto.

Per aggiungere i 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 i controlli WPF all'area di progettazione dei controlli utente WPF.

  4. Generare il progetto.

  5. Aggiungere al progetto un elemento Controllo utente, ovvero un controllo utente Windows Form.

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

  7. Dalla scheda Controlli utente WPF di NomeProgetto della Casella degli strumenti, trascinare il controllo utente WPF nella finestra di progettazione.

    Viene automaticamente creato un oggetto ElementHost contenente il controllo utente WPF nel controllo utente Windows Form.

  8. Scrivere il codice che aggiunge il controllo utente Windows Form al documento o alla cartella di lavoro. Per ulteriori informazioni, vedere Aggiunta di 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. Rigenerare il progetto.

Hosting dei controlli WPF mediante la classe ElementHost

Visual Studio Tools per Office prevede funzionalità che consentono di utilizzare i controlli Windows Form nelle soluzioni, ma non fornisce funzionalità simili per i controlli WPF. Ad esempio, è possibile aggiungere i controlli Windows Form a documenti e fogli di lavoro in fase di progettazione trascinandoli dalla Casella degli strumenti o in fase di esecuzione utilizzando i metodi di supporto. Tuttavia, questi strumenti non sono disponibili per i controlli WPF.

I controlli WPF utilizzano la classe ElementHost come livello di integrazione tra un form o un controllo Windows Form e i controlli WPF. La classe ElementHost viene fornita da .NET Framework a partire dalla versione 3.0.

Quando si aggiungono in fase di progettazione i controlli WPF alla soluzione, Visual Studio genera automaticamente un oggetto ElementHost. Per una procedura dettagliata che illustri l'utilizzo della classe ElementHost a livello di codice, vedere Procedura: hosting di un controllo Windows Presentation Foundation in Windows Form tramite ElementHost.

Risorse WPF

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

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

Vedere anche

Attività

Procedura: aggiungere un riquadro per le azioni nei documenti di Word

Procedura: aggiungere un riquadro per le azioni nelle cartelle di lavoro di Excel

Procedura: aggiungere un riquadro attività personalizzato a un'applicazione

Procedura: aggiungere un'area del modulo al progetto di un componente aggiuntivo per Outlook

Concetti

Personalizzazione dell'interfaccia utente di Office

Cenni preliminari sui controlli Windows Form nei documenti di Office

Cenni preliminari sul riquadro delle azioni

Cenni preliminari sui riquadri attività personalizzati

Creazione di aree di modulo di Outlook