Share via

Visão geral do modelo de objeto do Excel

  • Artigo

Para desenvolver soluções que usam o Microsoft Office Excel, você pode interagir com os objetos fornecidos pelo modelo de objeto do Excel. Este tópico apresenta os objetos mais importantes:

Observação

Interessado em desenvolver soluções que estendam a experiência do Office em várias plataformas? Confira o novo modelo de Suplementos do Office. Os Suplementos do Office têm um espaço pequeno em comparação com os suplementos e soluções VSTO, e você pode criá-los usando praticamente qualquer tecnologia de programação da Web, como HTML5, JavaScript, CSS3 e XML.

O modelo de objeto segue de perto a interface do usuário. O Application objeto representa o aplicativo inteiro e cada Workbook objeto contém uma coleção de Worksheet objetos. A partir daí, a principal abstração que representa as células é o Range objeto, que permite trabalhar com células individuais ou grupos de células.

Além do modelo de objeto do Excel, os projetos do Office no Visual Studio fornecem itens de host e controles de host que estendem alguns objetos no modelo de objeto do Excel. Os itens de host e os controles de host se comportam como os objetos do Excel que estendem, mas também têm funcionalidade adicional, como recursos de vinculação de dados e eventos extras. Para obter mais informações, consulte Automatizar o Excel usando objetos estendidos e Visão geral sobre itens de host e controles de host.

Este tópico fornece uma breve visão geral do modelo de objeto do Excel. Para obter recursos onde você pode saber mais sobre todo o modelo de objeto do Excel, consulte Usar a documentação do modelo de objeto do Excel.

Acessar objetos em um projeto do Excel

Quando você cria um novo projeto de suplemento VSTO para Excel, o Visual Studio cria automaticamente um arquivo de código ThisAddIn.vb ou ThisAddIn.cs . Você pode acessar o objeto Application usando Me.Application ou this.Application.

Ao criar um novo projeto de nível de documento para o Excel, você tem a opção de criar uma nova pasta de trabalho do Excel ou projeto de modelo do Excel. O Visual Studio cria automaticamente os seguintes arquivos de código em seu novo projeto do Excel para projetos de pasta de trabalho e modelo.

Visual Basic C#
ThisWorkbook.vb ThisWorkbook.cs
Folha1.vb Folha1.cs
Folha2.vb Folha2.cs
Folha3.vb Folha3.cs

Você pode usar a Globals classe em seu projeto para acessar ThisWorkbook, , , Sheet1Sheet2ou Sheet3 de fora da respectiva classe. Para obter mais informações, consulte Acesso global a objetos em projetos do Office. O exemplo a seguir chama o método de independentemente de o PrintPreview código ser colocado em uma das Sheetclasses n ou na ThisWorkbookSheet1 classe.

Globals.Sheet1.PrintPreview();

Como os dados em um documento do Excel são altamente estruturados, o modelo de objeto é hierárquico e direto. O Excel fornece centenas de objetos com os quais você pode querer interagir, mas você pode começar bem o modelo de objeto concentrando-se em um pequeno subconjunto dos objetos disponíveis. Esses objetos incluem os quatro a seguir:

  • Aplicativo

  • Pasta de trabalho

  • Planilha

  • Intervalo

    Grande parte do trabalho feito com o Excel gira em torno desses quatro objetos e seus membros.

Objeto de aplicativo

O objeto Excel representa o próprio aplicativo Excel Application . O Application objeto expõe uma grande quantidade de informações sobre o aplicativo em execução, as opções aplicadas a essa instância e os objetos de usuário atuais abertos na instância.

Observação

Você não deve definir a EnableEvents propriedade do Application objeto no Excel como false. Definir essa propriedade como false impede que o Excel gere quaisquer eventos, incluindo os eventos de controles de host.

Objeto de pasta de trabalho

O Workbook objeto representa uma única pasta de trabalho dentro do aplicativo Excel.

As ferramentas de desenvolvimento do Office no Visual Studio estendem o objeto fornecendo o WorkbookWorkbook tipo. Esse tipo fornece acesso a todos os recursos de um Workbook objeto. Para obter mais informações, consulte Item de host da pasta de trabalho.

Objeto de planilha

O Worksheet objeto é um membro da Worksheets coleção. Muitas das propriedades, métodos e eventos do Worksheet são idênticos ou semelhantes aos membros fornecidos pelos Application objetos ou Workbook .

O Excel fornece uma coleção como uma Sheets propriedade de um Workbook objeto. Cada membro da Sheets coleção é um ou um WorksheetChart objeto.

As ferramentas de desenvolvimento do Office no Visual Studio estendem o objeto fornecendo o WorksheetWorksheet tipo. Esse tipo fornece acesso a todos os recursos de um Worksheet objeto, bem como a novos recursos, como a capacidade de hospedar controles gerenciados e manipular novos eventos. Para obter mais informações, consulte Item de host de planilha.

Objeto de intervalo

O Range objeto é o objeto que você mais usará em seus aplicativos do Excel. Antes de manipular qualquer região no Excel, você deve expressá-la como um Range objeto e trabalhar com métodos e propriedades desse intervalo. Um Range objeto representa uma célula, uma linha, uma coluna, uma seleção de células que contém um ou mais blocos de células, que podem ou não ser contíguos, ou até mesmo um grupo de células em várias planilhas.

Visual Studio estende o objeto fornecendo o RangeNamedRange e XmlMappedRange tipos. Esses tipos têm a maioria dos mesmos recursos que um Range objeto, bem como novos recursos, como o recurso de vinculação de dados e novos eventos. Para obter mais informações, consulte NamedRange controle e XmlMappedRange controle.

Usar a documentação do modelo de objeto do Excel

Para obter informações completas sobre o modelo de objeto do Excel, consulte a referência do assembly de interoperabilidade primária (PIA) do Excel e a referência do modelo de objeto VBA.

Referência de assembly de interoperabilidade primária

A documentação de referência do PIA do Excel descreve os tipos no assembly de interoperabilidade primário para Excel. Esta documentação está disponível no seguinte local: Referência de assembly de interoperabilidade primária do Excel 2010.

Para obter mais informações sobre o design do PIA do Excel, como as diferenças entre classes e interfaces no PIA e como os eventos no PIA são implementados, consulte Visão geral de classes e interfaces nos assemblies de interoperabilidade primária do Office.

Referência do modelo de objeto VBA

A referência do modelo de objeto VBA documenta o modelo de objeto do Excel como ele é exposto ao código do Visual Basic for Applications (VBA). Para obter mais informações, consulte Referência de modelo de objeto do Excel 2010.

Todos os objetos e membros na referência de modelo de objeto VBA correspondem a tipos e membros no PIA do Excel. Por exemplo, o objeto Worksheet na referência do modelo de objeto VBA corresponde ao Worksheet objeto no PIA do Excel. Embora a referência de modelo de objeto VBA forneça exemplos de código para a maioria das propriedades, métodos e eventos, você deve traduzir o código VBA nesta referência para Visual Basic ou Visual C# se você deseja usá-los em um projeto do Excel que você cria usando o Visual Studio.

Título Descrição
Soluções Excel Explica como você pode criar personalizações em nível de documento e suplementos VSTO para o Microsoft Office Excel.
Trabalhar com intervalos Fornece exemplos que mostram como executar tarefas comuns com intervalos.
Trabalhar com planilhas Fornece exemplos que mostram como executar tarefas comuns com planilhas.
Trabalhar com pastas de trabalho Fornece exemplos que mostram como executar tarefas comuns com pastas de trabalho.