Compartilhar via

Introdução à programação de personalizações no nível do documento para Excel

Se você estiver apenas começando a criar personalizações de nível de documento para o Microsoft Office Excel usando o Visual Studio, aqui está o que você precisa saber.

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento para Excel. Para obter mais informações, consulte Os recursos disponíveis pelo aplicativo do Office e pelo tipo de projeto.

Entender como funcionam as personalizações no nível do documento para Excel

Uma personalização no nível do documento para Excel é baseada em uma única pasta de trabalho. Para começar a usar a personalização, o usuário final abre a pasta de trabalho ou cria a pasta de trabalho a partir de um modelo do Excel. Os eventos na pasta de trabalho, por exemplo, digitando em células ou clicando em botões e itens de menu, podem chamar métodos de manipulação de eventos no assembly. Quando a pasta de trabalho é fechada, os recursos fornecidos pela personalização não estão mais disponíveis no Excel, somente no documento que os continha.

Para obter mais informações, consulte Arquitetura de personalizações no nível do documento.

Criar projetos no nível do documento para o Excel

Para criar uma personalização no nível do documento para Excel, use a Pasta de Trabalho do Excel ou o modelo de projeto do Modelo do Excel na caixa de diálogo Novo Projeto . Esses modelos incluem as referências necessárias de assemblies e os arquivos de projeto.

Para obter mais informações sobre como criar um projeto em nível de documento para Excel, consulte Como criar projetos do Office no Visual Studio. Para obter mais informações sobre os modelos de projeto, consulte a visão geral dos modelos de projeto do Office.

Programar pastas de trabalho do Excel usando itens de host e controles de host

Itens de host e controles de host são classes que fornecem o modelo de programação para personalizações em nível de documento criadas usando o Visual Studio.

Os itens de host fornecem um ponto de entrada para seu código e também podem atuar como contêineres para controles de host e controles do Windows Forms. Em projetos de nível de documento para Excel, esses itens de host são representados pelas classes ThisWorkbook, Sheet1, Sheet2 e Sheet3.

Os controles de host são baseados em objetos nativos do Excel, como objetos de lista e intervalos. Os controles de host fornecem funcionalidade semelhante aos objetos nativos do Excel, mas também têm novos eventos, suporte ao designer e funcionalidade de associação de dados. Eles aparecem como objetos de primeira classe no código do projeto e no IntelliSense, o que facilita a referência a objetos específicos diretamente em seu código sem precisar navegar pelo modelo de objeto do Excel.

Para obter mais informações, consulte os seguintes tópicos:

Personalizar a interface do usuário do Excel

A maioria das soluções do Microsoft Office modifica a interface do usuário do aplicativo do Office para fornecer alguma maneira de os usuários interagirem com a solução. Há muitas maneiras pelas quais você pode modificar a interface do usuário do Excel usando uma personalização no nível do documento. Por exemplo, você pode adicionar controles à faixa de opções ou exibir um painel de ações. Para obter mais informações, consulte a personalização da interface do usuário do Office.

Você também pode abrir a pasta de trabalho associada ao projeto diretamente no Visual Studio. Quando a pasta de trabalho está aberta no Visual Studio, você pode modificar a pasta de trabalho usando a interface do usuário do Excel. Você também pode usar a pasta de trabalho como uma superfície de design, o que permite arrastar controles para planilhas. Para obter mais informações, consulte projetos do Office no ambiente do Visual Studio.

Usar associação de dados

Os controles de host também estão na lista de controles que você pode arrastar da janela Fontes de Dados . Adicionar controles de host dessa forma os associa automaticamente à fonte de dados que você configurou usando a janela de configuração. Sem escrever nenhum código, você pode exibir dados de bancos de dados, serviços Web e objetos de negócios. Para obter mais informações, consulte Associar dados a controles em soluções do Office.

Próximas etapas

Para saber como criar uma personalização no nível do documento para Excel, confira Passo a passo: criar sua primeira personalização no nível do documento para o Excel. Este passo a passo apresenta as ferramentas de desenvolvimento do Office no Visual Studio e o modelo de programação para personalizações no nível de documento do Excel.

Para obter uma lista de tópicos que orientam você em algumas das tarefas comuns em projetos do Excel, consulte tarefas comuns na programação do Office.

Conteúdo relacionado

  • Last updated on