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

Articolo
08/11/2011

Per aggiungere un riquadro azioni a un documento di Microsoft Office Word, creare innanzitutto un controllo utente Windows Form. Aggiungere quindi il controllo utente alla proprietà Controls del campo ThisDocument.ActionsPane nel progetto.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento per Word 2007 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 Gestione delle impostazioni.

Creazione del controllo utente

La procedura riportata di seguito illustra come creare un controllo utente in un progetto di Word. Aggiunge anche un pulsante al controllo utente che scrive il testo nel documento quando viene selezionato.

Per creare il controllo utente

Aprire il progetto di documento o di modello di 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 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.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.

Per aggiungere il controllo utente al riquadro delle azioni

Aggiungere il codice riportato di seguito alla classe 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 riportato di seguito al gestore eventi ThisDocument_Startup della classe ThisDocument.
```
Me.ActionsPane.Controls.Add(hello)
```
```
this.ActionsPane.Controls.Add(hello);
```