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

Articolo
08/11/2011

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.

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.

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 Gestione delle impostazioni.

Prerequisiti

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

Una versione di Visual Studio 2010 che include gli strumenti per sviluppatori di Microsoft Office. Per ulteriori informazioni, vedere [Configurazione di un computer per sviluppare soluzioni Office](bb398242\(v=vs.100\).md).

Word 2007 o Word 2010.

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 di Office in Visual Studio.

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

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

Verrà visualizzata la finestra di dialogo Aggiungi controllo Bookmark.
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.
Nella finestra Proprietà impostare la proprietà Name di Bookmark1 su showName.
Selezionare la parola Address, senza selezionare il segno di paragrafo.
Nella scheda Inserisci della barra multifunzione fare clic su Segnalibro nel gruppo Collegamenti.
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

Selezionare il progetto My Basic Actions Pane in Esplora soluzioni.
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 InsertTextControl e fare clic su Aggiungi.

Per aggiungere controlli Windows Form al controllo riquadro azioni

Se il controllo riquadro azioni non è visibile nella finestra di progettazione, fare doppio clic su InsertTextControl.
Trascinare un controllo Label sul controllo riquadro azioni dalla scheda Controlli comuni della Casella degli strumenti.
Modificare la proprietà Text del controllo Label in Name.
Aggiungere un controllo Textbox al controllo riquadro azioni e modificare le proprietà riportate di seguito.

Proprietà

Valore

Nome

getName

Dimensione

130, 20
Aggiungere un secondo controllo Label al controllo riquadro azioni e modificare la proprietà Text in Address.
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

Dimensione

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

Proprietà

Valore

Nome

addText

Text

Insert

Proprietà	Valore
Nome	getName
Dimensione	130, 20

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

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 Accesso globale a oggetti nei progetti di Office.

Per inserire testo dal riquadro azioni in un segnalibro del documento

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;
}

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 progetti di 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

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

Dim insertText As New InsertTextControl

private InsertTextControl insertText = new InsertTextControl();

Aggiungere al gestore eventi Startup di ThisDocument il seguente codice:

Me.ActionsPane.Controls.Add(insertText)

this.ActionsPane.Controls.Add(insertText);

Verifica 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

Premere F5 per eseguire il progetto.
Verificare che il riquadro delle azioni sia visibile.
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 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

Condividi tramite