Procedura: aggiungere un riquadro ai documenti Word o alle cartelle di lavoro di Excel

Articolo
02/19/2013

Per aggiungere un riquadro azioni in un documento di Microsoft Office Word o a una cartella di lavoro di Microsoft Excel, creare innanzitutto un controllo utente Windows Form.Quindi, aggiungere il controllo utente alla proprietà Controls del campo ThisDocument.ActionsPane (Word) o del campo ThisWorkbook.ActionsPane (Excel) nel progetto.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento per Excel 2013, Excel 2010, Word 2013 e Word 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 Impostazioni di Visual Studio.

Creazione del controllo utente

Nella procedura seguente viene illustrato come creare un controllo utente in Word o in un progetto Excel.Aggiunge anche un pulsante al controllo utente che scrive il testo nel documento o la cartella di lavoro quando viene selezionato.

Per creare il controllo utente

Aprire il progetto a livello di documento di excel o Word 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 dalla scheda Windows Form della Casella degli strumenti sul controllo.

[!NOTA]

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

Aggiungere codice al gestore eventi Click del pulsante.Il seguente codice di esempio viene mostrato per un documento di Microsoft Office Word.

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

    Globals.ThisDocument.Paragraphs(1).Range.Text = "Hello world!"
End Sub

private void button1_Click(object sender, System.EventArgs e)
{
    Globals.ThisDocument.Paragraphs[1].Range.Text = "Hello World!";
}

Per C#, è necessario aggiungere un gestore eventi per il clic su un pulsante.È possibile inserire il codice nel costruttore HelloControl dopo la chiamata a IntializeComponent.

Per ulteriori informazioni sulla creazione di gestori eventi, vedere Procedura: creare gestori eventi in progetti di Office.
```
public HelloControl()
{
    InitializeComponent();
    this.button1.Click += new 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 ThisDocument.ActionsPane (Word) o del campo ThisWorkbook.ActionsPane (Excel).

Per aggiungere il controllo utente al riquadro delle azioni

Aggiungere il codice seguente alla classe ThisWorkbook o ThisDocument come 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 seguente al gestore eventi ThisDocument_Startup della classe ThisDocument o al gestore eventi ThisWorkbook_Startup della classe ThisWorkbook.
```
Me.ActionsPane.Controls.Add(hello)
```
```
this.ActionsPane.Controls.Add(hello);
```