Item de host de planilha

Se aplica a

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office.

Projetos de nível de documento

  • O Excel 2007

  • O Excel 2003

Projetos de nível de aplicativo

  • O Excel 2007

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

O item de host Worksheet é uma planilha que expõe eventos e atua como um Contêiner para controles de host e controles de Windows Forms.

Quando você cria uma Novo personalização de nível de documento para o Microsoft Office Excel, o Ferramentas do Visual Studio para o Office cria automaticamente três itens de host Worksheet no projeto.Os nomes padrão das planilhas são Sheet1, Sheet2e Sheet3.Se você criar um aplicativo baseado em uma pasta de trabalho existente, o número de itens de host depende do número de planilhas na pasta de trabalho.

Noções básicas sobre itens do host de planilha

Da mesma maneira que você adicionar controles de Windows Forms a um formulário do Windows, você pode adicionar controles de formulário do Windows e controles de host a um item de host Worksheet.

Em um projeto de nível de documento, você pode adicionar adicional Worksheet host itens para o projeto em tempo de design; no entanto, Microsoft.Office.Tools.Excel.Worksheet host itens não são criados automaticamente quando você Adicionar uma planilha por meio de programação.Se você adicionar uma planilha em tempo de execução em um projeto de nível de documento, ele será o tipo de Microsoft.Office.Interop.Excel.Worksheet e não pode conter qualquer host controles ou controles Windows Forms.

Iniciando no Visual Studio 2008 Serviço Pack 1 (SP1), você pode adicionar planilhas em tempo de execução em um suplemento em nível de aplicativo e então chamar o método GetVstoObject de um objeto Microsoft.Office.Interop.Excel.Worksheet para obter um item de host Worksheet.For more information, see Estendendo os documentos do Word e Excel pastas de trabalho no nível de aplicativo Adicionar-ins em tempo de execução.

Em projetos do Excel, a planilha é o principal veículo para interação do usuário.Por combinar diferentes conjuntos de controles e escrevendo código, é possível ligar os controles a dados, entrada de obtenção do usuário e responder às ações do usuário.

Renomear a planilha

Em uma personalização de nível de documento, você pode renomear as planilhas no designer do Visual Studio, mas isso apenas altera o nome de Exibir da planilha.O nome através de programação ainda é o nome padrão da planilha.Se você renomear a planilha na janela Properties, somente o nome através de programação é alterado.

Eventos

Os eventos disponíveis para o item de host Worksheet são:

Consulte também

Tarefas

O Excel Adicionar - no exemplo de controles dinâmicos

Conceitos

Estendendo os documentos do Word e Excel pastas de trabalho no nível de aplicativo Adicionar-ins em tempo de execução

Adicionar controles a documentos do Office em tempo de execução

Itens de host e Visão geral sobre controles de host

Item de host da pasta de trabalho

Limitações através de programação de itens de host e controles de host

Outros recursos

Controles em documentos do Office

Controles de host do Excel

Date

History

Motivo

De 2008 de julho

Informações Adicionados sobre como usar itens de host de planilha em suplementos de nível de aplicativo.

Alteração de recurso do SP1.