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.

d6sb8dyb.alert_note(it-it,VS.90).gifNota:

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.

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.

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.

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.

    d6sb8dyb.alert_note(it-it,VS.90).gifNota:

    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.

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

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

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.

    private InsertTextControl insertText = new InsertTextControl();
    
    
    
  2. Aggiungere al gestore eventi Startup di ThisDocument il seguente codice:

    this.ActionsPane.Controls.Add(insertText);
    
    
    

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.

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

Aggiunte alla community

Mostra: