Condividi tramite


Elemento host foglio di lavoro

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 2007

  • Excel 2003

Progetti a livello di applicazione

  • Excel 2007

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

L'elemento host Worksheet è un foglio di lavoro che espone eventi e agisce da contenitore per i controlli host e i controlli Windows Form.

Quando si crea una nuova personalizzazione a livello di documento per Microsoft Office Excel, in Visual Studio Tools per Office vengono automaticamente creati tre elementi host Worksheet all'interno del progetto. I nomi predefiniti dei fogli di lavoro sono Sheet1, Sheet2 e Sheet3. Se si crea un'applicazione basata su una cartella di lavoro esistente, il numero di elementi host dipenderà dal numero di fogli presenti nella cartella di lavoro.

Informazioni sugli elementi host Worksheet

I controlli Windows Form e i controlli host possono essere aggiunti a un elemento host Worksheet utilizzando la stessa procedura prevista per l'aggiunta di controlli Windows Form a un Windows Form.

In un progetto a livello di documento è possibile aggiungere elementi host Worksheet supplementari in fase di progettazione. Gli elementi host Microsoft.Office.Tools.Excel.Worksheet, tuttavia, non vengono creati automaticamente con l'aggiunta di un foglio di lavoro a livello di codice. Un foglio di lavoro aggiunto in fase di esecuzione in un progetto a livello di documento sarà di tipo Microsoft.Office.Interop.Excel.Worksheet e non potrà contenere controlli host o controlli Windows Form.

A partire da Visual Studio 2008 Service Pack 1 (SP1), è possibile aggiungere fogli di lavoro in fase di esecuzione in un componente aggiuntivo a livello di applicazione e chiamare quindi il metodo GetVstoObject di un oggetto Microsoft.Office.Interop.Excel.Worksheet per ottenere un elemento host Worksheet. Per ulteriori informazioni, vedere la classe Estensione in fase di esecuzione di documenti di Word e di cartelle di lavoro di Excel in componenti aggiuntivi a livello di applicazione.

Nei progetti Excel, il foglio di lavoro è lo strumento principale per l'interazione dell'utente. Combinando la scrittura di codice con diversi insiemi di controlli, è possibile associare i controlli a dati, ottenere l'input dall'utente e rispondere alle azioni dell'utente.

Ridenominazione del foglio di lavoro

In una personalizzazione a livello di documento è possibile rinominare i fogli di lavoro nella finestra di progettazione di Visual Studio; tuttavia, verrà modificato solo il nome visualizzato del foglio di lavoro. Il nome a livello di codice continuerà a essere il nome predefinito del foglio di lavoro. Se si rinomina il foglio di lavoro nella finestra Proprietà, verrà modificato solo il nome a livello di codice.

Eventi

Gli eventi disponibili per l'elemento host Worksheet sono:

Vedere anche

Attività

Esempio di controlli dinamici del componente aggiuntivo di Excel

Concetti

Estensione in fase di esecuzione di documenti di Word e di cartelle di lavoro di Excel in componenti aggiuntivi a livello di applicazione

Aggiunta di controlli ai documenti di Office in fase di esecuzione

Cenni preliminari sugli elementi e sui controlli host

Elemento host cartella di lavoro

Limitazioni a livello di codice degli elementi e dei controlli host

Altre risorse

Controlli nei documenti di Office

Controlli host di Excel

Cronologia delle modifiche

Date

History

Motivo

Luglio 2008

Aggiunte informazioni sull'utilizzo di elementi host dei fogli di lavoro in componenti aggiuntivi a livello di applicazione.

Modifica di funzionalità in SP1.