Condividi tramite


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

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

  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. 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

    Dimensione

    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

    Dimensione

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

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

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

  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:

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

Controllo Bookmark

Altre risorse

Cenni preliminari sul riquadro delle azioni