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

Articolo
08/11/2011

Per aggiungere un riquadro azioni a una cartella di lavoro di Microsoft Office Excel, creare innanzitutto un controllo utente Windows Form. Aggiungere quindi il controllo utente alla proprietà Controls del campo ThisWorkbook.ActionsPane nel progetto.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento per Excel 2007 ed Excel 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

Nota

Il computer potrebbe mostrare nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. Questi elementi sono determinati dall'edizione di Visual Studio in uso e dalle impostazioni utilizzate. Per ulteriori informazioni, vedere Gestione delle impostazioni.

Collegamento a video Per una dimostrazione video correlata, vedere How Do I: Use WPF Controls Inside an Excel Actions Pane? (la pagina potrebbe essere in inglese).

Creazione del controllo utente

La procedura riportata di seguito mostra come creare un controllo utente in un progetto di Excel. Aggiunge anche un pulsante al controllo utente che scrive il testo in una cella del foglio di lavoro quando viene selezionato.

Per creare il controllo utente

Aprire il progetto Cartella di lavoro o Modello di Excel in Visual Studio.
Scegliere Aggiungi nuovo elemento dal menu Progetto.
Fare clic su Controllo riquadro azioni nella finestra di dialogo Aggiungi nuovo elemento, assegnare al controllo il nome HelloControl e fare clic su Aggiungi.

Nota

In alternativa è possibile aggiungere un elemento Controllo utente al progetto. Le classi generate dagli elementi Controllo riquadro azioni e Controllo utente sono equivalenti a livello funzionale.
Trascinare un controllo Button sul controllo dalla scheda Windows Form della Casella degli strumenti.

Nota

Se il controllo non è visibile nella finestra di progettazione, fare doppio clic su HelloControl in Esplora soluzioni.

Aggiungere al gestore eventi Click del pulsante il codice riportato di seguito.

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    Handles Button1.Click

    Globals.Sheet1.Range("A1").Value2 = "Hello world!"
End Sub

private void button1_Click(object sender, System.EventArgs e)
{
    Globals.Sheet1.Range["A1", System.Type.Missing].Value2 = "Hello World!";
}

Per C# è necessario creare un gestore eventi per Button. Questo codice può essere inserito nel costruttore di HelloControl. Per ulteriori informazioni sulla creazione di gestori eventi, vedere Procedura: creare gestori eventi in progetti di Office.
```
public HelloControl()
{
    InitializeComponent();
    this.button1.Click += new System.EventHandler(this.button1_Click);
}
```

Aggiunta del controllo utente al riquadro delle azioni

Per visualizzare il riquadro azioni, aggiungere il controllo utente alla proprietà Controls del campo ThisWorkbook.ActionsPane.

Per aggiungere il controllo utente al riquadro delle azioni

Aggiungere il codice riportato di seguito alla classe ThisWorkbook come una dichiarazione a livello di classe (non aggiungere questo codice a un metodo).
```
Dim hello As New HelloControl
```
```
private HelloControl hello = new HelloControl();
```
Aggiungere il codice riportato di seguito al gestore eventi ThisWorkbook_Startup della classe ThisWorkbook.
```
Me.ActionsPane.Controls.Add(hello)
```
```
this.ActionsPane.Controls.Add(hello);
```