Visão geral do modelo de objeto do Excel

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:

• Application

• Workbook

• Worksheet

• Range

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

O modelo de objeto segue de perto a interface do usuário. O Application objeto representa todo o aplicativo e cada Workbook objeto contém uma coleção de Worksheet objetos. A partir daí, a abstração principal que representa as células é o objeto Range, 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 controlesde 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 eles estendem, mas também têm funcionalidade adicional, como recursos de associação de dados e eventos extras. Para obter mais informações, consulte Automatizar o Excel usando objetos estendidos e itens de host e visão geral de controles de host.

Este tópico fornece uma breve visão geral do modelo de objeto do Excel. Para obter recursos em que 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 no nível do documento para o Excel, você tem a opção de criar uma nova Pasta de Trabalho do Excel ou um 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.

Você pode usar a Globals classe em seu projeto para acessarThisWorkbook, 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 PrintPreview de Sheet1, independentemente de o código estar em alguma das classes Sheetn ou na classe ThisWorkbook.

Globals.Sheet1.PrintPreview();

Globals.Sheet1.PrintPreview()

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

• Aplicativo

• Pasta de trabalho

• Planilha

• Alcance

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

Objeto Aplicativo

O objeto do Excel Application representa o próprio aplicativo do Excel. 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 dentro da instância.

Objeto Workbook

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

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

Objeto Planilha

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

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

As ferramentas de desenvolvimento do Office no Visual Studio estendem o Worksheet objeto fornecendo o Worksheet 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 lidar com novos eventos. Para obter mais informações, consulte o item de host da Planilha.

Objeto Range

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.

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

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

Para obter informações completas sobre o modelo de objeto do Excel, você pode consultar a referência da PIA (Primary Interop Assembly) primária do Excel e a referência do modelo de objeto VBA.

Referência de assembly de interoperabilidade primário

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

Para obter mais informações sobre o design do Excel PIA, 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ários do Office.

Referência do modelo de objeto do VBA

O modelo de objeto VBA faz referência ao modelo de objeto do Excel, pois ele é exposto ao código do VBA (Visual Basic for Applications). Para obter mais informações, consulte a referência do modelo de objeto do Excel 2010.

Todos os objetos e membros na referência do modelo de objeto do VBA correspondem a tipos e membros no EXCEL PIA. Por exemplo, o objeto Worksheet na referência do modelo de objeto do VBA corresponde ao objeto Worksheet no Excel PIA. Embora a referência do 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 nessa referência para Visual Basic ou Visual C# se quiser usá-los em um projeto do Excel criado usando o Visual Studio.

Tópicos relacionados