Procedura dettagliata: inserimento di testo in un documento da un riquadro azioni

Aggiornamento: novembre 2007

Si applica a
Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati. Tipo di progetto Progetti a livello di documento Versione Microsoft Office Word 2007 Word 2003 Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

In questa procedura dettagliata verrà illustrata la creazione di un riquadro azioni in un documento di Microsoft Office Word. Il riquadro azioni contiene due controlli che raccolgono l'input e inviano il testo al documento.

In questa procedura dettagliata vengono illustrate le attività seguenti:

• Progettazione di un'interfaccia utilizzando i controlli Windows Form in un controllo del riquadro azioni.

• Visualizzazione del riquadro azioni all'apertura dell'applicazione.

Nota:
Il computer potrebbe mostrare nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. L'edizione di Visual Studio in uso e le impostazioni utilizzate determinano questi elementi. Per ulteriori informazioni, vedere Impostazioni di Visual Studio.

Prerequisiti

Per completare questa procedura dettagliata, è necessario disporre dei seguenti componenti:

• Visual Studio Tools per Office (componente facoltativo di Visual Studio 2008 Professional e Visual Studio Team System).

• Microsoft Office Word 2003 o Microsoft Office Word 2007.

Visual Studio Tools per Office viene installato per impostazione predefinita con le versioni di Visual Studio elencate. Per controllare se è installato, vedere Installazione di Visual Studio Tools per Office.

Creazione del progetto

Il primo passaggio consiste nella creazione di un progetto Documento di Word.

Per creare un nuovo progetto

• Creare un progetto Documento di Word denominato My Basic Actions Pane. Nella procedura guidata, scegliere Crea un nuovo documento. Per ulteriori informazioni, vedere Procedura: creare progetti Visual Studio Tools per Office.

  Il nuovo documento di Word verrà aperto nella finestra di progettazione e il progetto My Basic Actions Pane verrà aggiunto in Esplora soluzioni.

Aggiunta di testo e segnalibri al documento

Il riquadro azioni inserirà il testo nei segnalibri del documento. Per progettare il documento, digitare del testo per creare un modulo di base.

Per aggiungere testo al documento

• Digitare nel documento di Word il testo riportato di seguito:

  March 21, 2008

  Name

  Address

  Questo è un esempio di un riquadro azioni di base in Word.

È possibile aggiungere un controllo Bookmark al documento trascinandolo dalla Casella degli strumenti in Visual Studio o utilizzando la finestra di dialogo Segnalibro in Word.

Per aggiungere un controllo Bookmark al documento

1. Trascinare sul documento un controllo Bookmark dalla scheda Controlli Word della Casella degli strumenti.

   Verrà visualizzata la finestra di dialogo Aggiungi controllo Bookmark.

2. Selezionare la parola Name, senza selezionare il segno di paragrafo, quindi scegliere OK.

   Nota:
   Il segno di paragrafo deve trovarsi all'esterno del segnalibro. Se nel documento non sono visibili segni di paragrafo, scegliere Strumenti di Microsoft Office Word dal menu Strumenti quindi scegliere Opzioni. Fare clic sulla scheda Visualizza e selezionare la casella di controllo Segni di paragrafo nella sezione Segni di formattazione della finestra di dialogo Opzioni.

3. Nella finestra Proprietà impostare la proprietà Name di Bookmark1 su showName.

4. Selezionare la parola Address, senza selezionare il segno di paragrafo.

5. Eseguire una delle operazioni seguenti:

   • Per Word 2003: scegliere Segnalibro dal menu Inserisci.

   • Per Word 2007: nella scheda Inserisci della Barra multifunzione, fare clic su Segnalibro nel gruppo Collegamenti.

6. Nella finestra di dialogo Segnalibro, digitare showAddress nella casella Nome segnalibro e fare clic su Aggiungi.

Aggiunta di controlli al riquadro delle azioni

Per progettare l'interfaccia del riquadro azioni, aggiungere un controllo riquadro azioni al progetto, quindi aggiungere i controlli Windows Form al controllo riquadro azioni.

Per aggiungere un controllo riquadro azioni

1. Selezionare il progetto My Basic Actions Pane in Esplora soluzioni.

2. Scegliere Aggiungi nuovo elemento dal menu Progetto.

3. Fare clic su Controllo riquadro azioni nella finestra di dialogo Aggiungi nuovo elemento, assegnare al controllo il nome InsertTextControl e fare clic su Aggiungi.

Per aggiungere controlli Windows Form al controllo riquadro azioni

1. Se il controllo riquadro azioni non è visibile nella finestra di progettazione, fare doppio clic su InsertTextControl.

2. Trascinare un controllo Label sul controllo riquadro azioni dalla scheda Controlli comuni della Casella degli strumenti.

3. Modificare la proprietà Text del controllo Label in Name.

4. Aggiungere un controllo Textbox al controllo riquadro azioni e modificare le proprietà riportate di seguito.

   Proprietà	Valore
   Nome	getName
   Size	130, 20

5. Aggiungere un secondo controllo Label al controllo riquadro azioni e modificare la proprietà Text in Address.

6. Aggiungere un secondo controllo Textbox al controllo riquadro azioni e modificare le proprietà riportate di seguito.

   Proprietà	Valore
   Nome	getAddress
   Accepts Return	True
   Multiline	True
   Size	130, 40

7. Aggiungere un controllo Button al controllo riquadro azioni e modificare le proprietà riportate di seguito.

   Proprietà	Valore
   Nome	addText
   Text	Insert

Aggiunta di codice per l'inserimento di testo nel documento

Nel riquadro azioni, creare il codice per inserire il testo delle caselle di testo nei controlli Bookmark appropriati del documento. È possibile utilizzare la classe Globals per accedere ai controlli nel documento dai controlli nel riquadro azioni. Per ulteriori informazioni, vedere la classe Accesso globale agli oggetti nei progetti Visual Studio Tools per Office.

Per inserire testo dal riquadro azioni in un segnalibro del documento

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

   Private Sub addText_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles addText.Click
   
       If Me.getName.Text <> String.Empty Then
           Globals.ThisDocument.showName.Text = Me.getName.Text
       End If
   
       If Me.getAddress.Text <> String.Empty Then
           Globals.ThisDocument.showAddress.Text = Me.getAddress.Text
       End If
   
       Me.getName.Text = String.Empty
       Me.getAddress.Text = String.Empty
   End Sub
   

   private void addText_Click(object sender, System.EventArgs e)
   {
       if (this.getName.Text != String.Empty) 
       {
           Globals.ThisDocument.showName.Text = this.getName.Text;
       }
   
       if (this.getAddress.Text != String.Empty)
       {
           Globals.ThisDocument.showAddress.Text = this.getAddress.Text;
       }
   
       this.getName.Text = String.Empty;
       this.getAddress.Text = String.Empty;
   }
   

2. Per C#, è necessario aggiungere un gestore eventi per il clic su un pulsante. È possibile inserire il codice nel costruttore InsertTextControl dopo la chiamata a IntializeComponent. Per ulteriori informazioni sulla creazione di gestori eventi, vedere Procedura: creare gestori eventi in Visual Studio Tools per Office.

   public InsertTextControl()
   {
       InitializeComponent();
       this.addText.Click += new EventHandler(addText_Click);
   }
   

Aggiunta di codice per mostrare il riquadro delle azioni

Per visualizzare il riquadro azioni, aggiungere il controllo creato all'insieme di controlli.

Per mostrare il riquadro delle azioni

1. Creare una nuova istanza del controllo riquadro azioni nella classe ThisDocument.

   Dim insertText As New InsertTextControl
   

   private InsertTextControl insertText = new InsertTextControl();
   

2. Aggiungere al gestore eventi Startup di ThisDocument il seguente codice:

   Me.ActionsPane.Controls.Add(insertText)
   

   this.ActionsPane.Controls.Add(insertText);
   

Test dell'applicazione

Eseguire il test del documento per verificare che il riquadro azioni venga visualizzato all'apertura del documento e che il testo digitato nelle caselle di testo venga inserito nei segnalibri quando si fa clic sul pulsante.

Per testare il documento

1. Premere F5 per eseguire il progetto.

2. Verificare che il riquadro delle azioni sia visibile.

3. Digitare il nome e l'indirizzo nelle caselle di testo del riquadro delle azioni e fare clic su Inserisci.

Passaggi successivi

Di seguito sono elencate alcune procedure che potrebbero essere necessarie per estendere il progetto:

• Creazione di un riquadro delle azioni in Excel. Per ulteriori informazioni, vedere Procedura: aggiungere un riquadro per le azioni nelle cartelle di lavoro di Excel.

• Associazione di dati a controlli in un riquadro azioni. Per ulteriori informazioni, vedere la classe Procedura dettagliata: associazione di dati a controlli in un riquadro delle azioni di Word.

• Attivazione e disattivazione della visualizzazione di controlli nel riquadro delle azioni. Per ulteriori informazioni, vedere Procedura dettagliata: modifica del riquadro delle azioni in base al contesto dell'utente.

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 dettagliata: modifica del riquadro delle azioni in base al contesto dell'utente

Procedura: gestire il layout di controllo dei riquadri delle azioni

Concetti

Cenni preliminari sul riquadro delle azioni

Controllo Bookmark