Condividi tramite

Procedura: aggiungere controlli Windows Form a documenti di Office

  • Articolo

Aggiornamento: Luglio 2008

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.

Progetti a livello di documento

  • Excel 2003

  • Excel 2007

  • Word 2003

  • Word 2007

Progetti a livello di applicazione

  • Excel 2007

  • Word 2007

Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazione.

È possibile aggiungere controlli Windows Form a documenti di Microsoft Office Excel e Microsoft Office Word in fase di progettazione in progetti a livello di documento. In fase di esecuzione, è possibile aggiungere controlli nelle personalizzazioni a livello di documento e nei componenti aggiuntivi a livello di applicazione. Ad esempio, è possibile aggiungere un controllo ComboBox al foglio di lavoro in modo che gli utenti possano scegliere da un elenco di opzioni.

In questo argomento vengono descritte le attività seguenti:

  • Aggiunta di controlli in fase di progettazione

  • Aggiunta di controlli in fase di esecuzione in progetti a livello di documento

  • Aggiunta di controlli in fase di esecuzione in componenti aggiuntivi a livello di applicazione

È inoltre possibile aggiungere ai documenti di Office controlli host, come i controlli Bookmark e NamedRange. Per ulteriori informazioni, vedere Controlli host di Word e Controlli host di Excel.

Aggiunta di controlli in fase di progettazione

Esistono diversi modi per aggiungere controlli Windows Form al documento di un progetto a livello di documento in fase di progettazione:

Nota:

Nel computer in uso è possibile che vengano visualizzati nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per ulteriori informazioni vedere Impostazioni di Visual Studio.

Per trascinare un controllo Windows Form nel documento

  1. Creare o aprire un progetto Cartella di lavoro di Excel o un progetto Documento di Word in Visual Studio in modo da rendere visibile il documento nella finestra di progettazione. Per informazioni sulla creazione di progetti, vedere Procedura: creare progetti Visual Studio Tools per Office.

  2. Nella scheda Controlli comuni della Casella degli strumenti, fare clic sul controllo che si desidera aggiungere e trascinarlo nel documento.

    Nota:

    Quando si seleziona un controllo in Excel, nella Barra della formula verrà visualizzato =EMBED("WinForms.Control.Host",""). Questo testo è necessario e non deve essere cancellato.

Per trascinare un controllo Windows Form nel documento

  1. Creare o aprire un progetto Cartella di lavoro di Excel o un progetto Documento di Word in Visual Studio in modo da rendere visibile il documento nella finestra di progettazione. Per informazioni sulla creazione di progetti, vedere Procedura: creare progetti Visual Studio Tools per Office.

  2. Nella scheda Controlli comuni della Casella degli strumenti, fare clic sul controllo che si desidera aggiungere.

  3. Nel documento, fare clic sul punto in cui si desidera posizionare l'angolo superiore sinistro del controllo, quindi trascinare fino al punto in cui si desidera posizionare l'angolo inferiore destro.

    Il controllo verrà aggiunto al documento con la posizione e le dimensioni specificate.

    Nota:

    Quando si seleziona un controllo in Excel, nella Barra della formula verrà visualizzato =EMBED("WinForms.Control.Host",""). Questo testo è necessario e non deve essere cancellato.

Per aggiungere un controllo Windows Form al documento facendo un singolo clic sul controllo

  1. Creare o aprire un progetto Cartella di lavoro di Excel o un progetto Documento di Word in Visual Studio in modo da rendere visibile il documento nella finestra di progettazione. Per informazioni sulla creazione di progetti, vedere Procedura: creare progetti Visual Studio Tools per Office.

  2. Nella scheda Controlli comuni della Casella degli strumenti, fare clic sul controllo che si desidera aggiungere.

  3. Fare clic sul punto all'interno del documento in cui si desidera aggiungere il controllo.

    Il controllo verrà aggiunto al documento con le dimensioni specificate.

    Nota:

    Quando si seleziona un controllo in Excel, nella Barra della formula verrà visualizzato =EMBED("WinForms.Control.Host",""). Questo testo è necessario e non deve essere cancellato.

Per aggiungere un controllo Windows Form al documento facendo doppio clic sul controllo

  1. Creare o aprire un progetto Cartella di lavoro di Excel o un progetto Documento di Word in Visual Studio in modo da rendere visibile il documento nella finestra di progettazione. Per informazioni sulla creazione di progetti, vedere Procedura: creare progetti Visual Studio Tools per Office.

  2. Nella scheda Controlli comuni della Casella degli strumenti, fare doppio clic sul controllo che si desidera aggiungere.

    Il controllo viene aggiunto al centro del documento o del riquadro attivo.

    Nota:

    Quando si seleziona un controllo in Excel, nella Barra della formula verrà visualizzato =EMBED("WinForms.Control.Host",""). Questo testo è necessario e non deve essere cancellato.

Per aggiungere un controllo Windows Form al documento premendo INVIO

  1. Creare o aprire un progetto Cartella di lavoro di Excel o un progetto Documento di Word in Visual Studio in modo da rendere visibile il documento nella finestra di progettazione. Per informazioni sulla creazione di progetti, vedere Procedura: creare progetti Visual Studio Tools per Office.

  2. Nella scheda Controlli comuni della Casella degli strumenti, fare clic sul controllo che si desidera aggiungere e premere INVIO.

    Il controllo viene aggiunto al centro del documento o del riquadro attivo.

    Nota:

    Quando si seleziona un controllo in Excel, nella Barra della formula verrà visualizzato =EMBED("WinForms.Control.Host",""). Questo testo è necessario e non deve essere cancellato.

Aggiunta di controlli in fase di esecuzione in progetti a livello di documento

È possibile aggiungere a livello di codice controlli Windows Form a un documento in fase di esecuzione. In Word, utilizzare i metodi della proprietà Controls della classe ThisDocument. In Excel, utilizzare i metodi della proprietà Controls di una classe Sheetn. Ogni metodo dispone di diversi overload che consentono di specificare in modi diversi il percorso del controllo. Per ulteriori informazioni, vedere la classe Metodi di supporto per i controlli Windows Form.

Quando si aggiunge un controllo Windows Form a un documento in fase di esecuzione, il controllo non viene reso persistente nel documento quando quest'ultimo viene chiuso. È possibile ricreare il controllo alla prossima apertura del documento. Per ulteriori informazioni, vedere la classe Aggiunta di controlli ai documenti di Office in fase di esecuzione.

Per aggiungere un controllo Windows Form in fase di esecuzione

  • Utilizzare un metodo Microsoft.Office.Tools.Word.ControlCollection (per i progetti Word) o un metodo Microsoft.Office.Tools.Excel.ControlCollection (per i progetti Excel) che dispone del nome Add<classe del controllo> (dove classe del controllo rappresenta il nome della classe del controllo Windows Form che si desidera aggiungere, ad esempio AddButton).

    Nell'esempio di codice seguente viene illustrato come aggiungere un oggetto Button alla cella C5 dell'oggetto Sheet1 in un progetto a livello di documento per Excel.

    Private Sub Sheet1_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Startup

    Dim salesButton As Microsoft.Office.Tools.Excel.Controls.Button
    salesButton = Me.Controls.AddButton(Me.Range("C5"), "salesButton")
    salesButton.Text = "Calculate Total Sales"
End Sub

    private void Sheet1_Startup(object sender, System.EventArgs e)
{
    Microsoft.Office.Tools.Excel.Controls.Button salesButton;
    salesButton = this.Controls.AddButton(this.get_Range("C5", missing), "salesButton");
    salesButton.Text = "Calculate Total Sales";
}

Aggiunta di controlli in fase di esecuzione in componenti aggiuntivi a livello di applicazione

È possibile aggiungere a livello di codice controlli Windows Form a qualsiasi documento aperto in fase di esecuzione. Innanzitutto, generare un elemento host basato su un documento o un foglio di lavoro aperto. Successivamente, in Word, utilizzare i metodi della proprietà Document.Controls del nuovo elemento host. In Excel, utilizzare i metodi della proprietà Worksheet.Controls del nuovo elemento host. Ogni metodo dispone di diversi overload che consentono di specificare in modi diversi il percorso del controllo. Per ulteriori informazioni, vedere la classe Metodi di supporto per i controlli Windows Form.

Quando si aggiunge un controllo Windows Form a un documento in fase di esecuzione, il controllo non viene reso persistente nel documento quando quest'ultimo viene chiuso. È possibile ricreare il controllo alla prossima apertura del documento. Per ulteriori informazioni, vedere la classe Aggiunta di controlli ai documenti di Office in fase di esecuzione.

Per ulteriori informazioni sulla creazione di elementi host nei progetti a livello di applicazione, vedere Estensione in fase di esecuzione di documenti di Word e di cartelle di lavoro di Excel in componenti aggiuntivi a livello di applicazione.

Per aggiungere un controllo Windows Form in fase di esecuzione

  • Utilizzare un metodo Microsoft.Office.Tools.Word.ControlCollection (per i progetti Word) o un metodo Microsoft.Office.Tools.Excel.ControlCollection (per i progetti Excel) che dispone del nome Add<classe del controllo> (dove classe del controllo rappresenta il nome della classe del controllo Windows Form che si desidera aggiungere, ad esempio AddButton).

    Nell'esempio di codice seguente viene illustrato come aggiungere un oggetto Button al primo paragrafo del documento attivo utilizzando un componente aggiuntivo di Word.

    Dim salesButton As Microsoft.Office.Tools.Word.Controls.Button
Dim extendedDocument As Document = Me.Application.ActiveDocument.GetVstoObject()

extendedDocument.Paragraphs(1).Range.InsertParagraphBefore()
salesButton = extendedDocument.Controls.AddButton( _
    extendedDocument.Paragraphs(1).Range, 75, 18, "salesButton")
salesButton.Text = "Calculate Sales"

    Microsoft.Office.Tools.Word.Controls.Button salesButton;
Document extendedDocument = this.Application.ActiveDocument.GetVstoObject();

extendedDocument.Paragraphs[1].Range.InsertParagraphBefore();
salesButton = extendedDocument.Controls.AddButton(
    extendedDocument.Paragraphs[1].Range, 75, 18, "salesButton");
salesButton.Text = "Calculate Sales";

Vedere anche

Attività

Procedura: ridimensionare i controlli nelle celle di un foglio di lavoro

Concetti

Cenni preliminari sui controlli Windows Form nei documenti di Office

Aggiunta di controlli ai documenti di Office in fase di esecuzione

Cenni preliminari sugli elementi e sui controlli host

Informazioni sui parametri facoltativi nelle soluzioni Office

Cronologia delle modifiche

Date

History

Motivo

Luglio 2008

Aggiunta procedura per l'aggiunta di controlli ai documenti in un componente aggiuntivo a livello di applicazione.

Modifica di funzionalità in SP1.