Palavra Overview do modelo de objeto

Artigo
08/08/2011

Ao desenvolver soluções do Word no Visual Studio, você interage com o modelo de objeto do Word. Esse modelo de objeto consiste de classes e interfaces que são fornecidos no assembly de interoperabilidade primária para o Word e estão definidos no Microsoft.Office.Interop.Word namespace.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de nível de aplicativo para Word 2007 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

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

Para obter informações sobre como usar o modelo de objeto do Word para executar tarefas específicas, consulte os seguintes tópicos:

Noções básicas sobre o modelo de objeto do Word

O Word oferece centenas de objetos com os quais você pode interagir. Esses objetos são organizados em uma hierarquia de parecido com o da interface do usuário. Na parte superior da hierarquia é o Application objeto. Este objeto representa a instância atual do Word. O Application objeto contém o Document, Selection, Bookmark, e Range objetos. Cada um desses objetos possui vários métodos e propriedades que você pode acessar, manipular e interagir com ele.

A ilustração a seguir mostra um modo de exibição desses objetos na hierarquia do modelo de objeto do Word.

Resumo de modelo de objeto do Word

Gráfico do modelo de objetos do Word

A princípio, parece haver muita sobreposição. Por exemplo, o Document e Selection objetos ambos são membros da Application objeto, mas o Document objeto também é um membro da Selection objeto. Tanto o Document e Selection objetos contêm Bookmark e Range objetos. A sobreposição existe porque há várias maneiras que você pode acessar o mesmo tipo de objeto. Por exemplo, aplicar a formatação a uma Range objeto; mas talvez você queira acessar o intervalo da seleção atual, um determinado parágrafo, uma seção ou de todo o documento.

As seguintes seções descrevem brevemente os objetos de nível superior e como eles interagem entre si. Esses objetos incluem os seguintes cinco:

Objeto de aplicativo
Objeto de documento
Objeto Selection
Objeto Range
Objeto Bookmark

Além do modelo de objeto do Word, os projetos do Office em Visual Studio fornecem itens do host e controles de host que ampliam a alguns objetos no modelo de objeto do Word. Itens de host e controles de host que se comportam como eles estendem os objetos do Word, mas também têm funcionalidades adicionais como, por exemplo, os recursos de ligação de dados e eventos extras. For more information, see Automatizar o Word usando o Extended objetos and Itens de host e a visão geral sobre controles de Host.

Objeto de aplicativo

O Application objeto representa o aplicativo do Word e é o pai de todos os outros objetos. Geralmente, seus membros aplicam a palavra como um todo. Você pode usar suas propriedades e métodos para controlar o ambiente do Word.

No nível do aplicativo add-in de projetos, você pode acessar o Application o objeto usando o Application campo o ThisAddIn classe. For more information, see Os suplementos de nível de aplicativo de programação..

Em projetos de nível de documento, você pode acessar o Application o objeto usando o Application propriedade da ThisDocument classe.

Objeto de documento

O Microsoft.Office.Interop.Word.Document objeto é fundamental para o Word de programação. Ele representa um documento e todo seu conteúdo. Quando você abre um documento ou cria um novo documento, crie um novo Microsoft.Office.Interop.Word.Document objeto, que é adicionado para o Documents coleção da Application objeto. O documento que tem o foco é chamado o documento ativo. Ela é representada pelo ActiveDocument propriedade da Application objeto.

As ferramentas de desenvolvimento do Office em Visual Studio de estendem o Microsoft.Office.Interop.Word.Document objeto fornecendo a Microsoft.Office.Tools.Word.Document tipo. Esse tipo é um o item de host que fornece acesso a todos os recursos de um Microsoft.Office.Interop.Word.Document o objeto e adiciona eventos adicionais e a capacidade de adicionar controles gerenciados.

Quando você cria um projeto de nível de documento, você pode acessar Microsoft.Office.Tools.Word.Document membros usando o gerado ThisDocument classe no projeto. Você pode acessar membros da Microsoft.Office.Tools.Word.Document item de host usando o Me ou this palavras-chave do código na ThisDocument de classe, ou usando Globals.ThisDocument do código fora do ThisDocument classe. For more information, see Programação personalizações em nível de documento. Por exemplo, para selecionar o primeiro parágrafo do documento, use o código a seguir.

Me.Paragraphs(1).Range.Select()

this.Paragraphs[1].Range.Select();

Em projetos de nível de aplicativo, você pode gerar Microsoft.Office.Tools.Word.Document itens do host em tempo de execução. Você pode usar o item de host gerado para adicionar controles e as marcas inteligentes para o documento associado. For more information, see Estendendo os documentos do Word e pastas de trabalho do Excel em suplementos de nível de aplicativo em tempo de execução.

Observação
As marcas inteligentes estão obsoletas no Excel 2010 e Word 2010. For more information, see Visão geral sobre marcas inteligentes.

Objeto Selection

O Selection objeto representa a área selecionada no momento. Quando você executar uma operação na interface do usuário do Word, como texto em negrito, você seleciona, ou realce, o texto e aplicar a formatação. O Selection o objeto está sempre presente em um documento. Se nada estiver selecionado, ele representa o ponto de inserção. Além disso, uma seleção pode abranger vários blocos de texto que não são contíguos.

Objeto Range

O Range objeto representa uma área contígua em um documento e é definido por uma posição de caractere inicial e uma posição de caractere final. Você não está limitado a um único Range objeto. Você pode definir várias Range objetos no mesmo documento. A Range objeto tem as seguintes características:

Ele pode consistir de todo o documento, um intervalo de texto ou o ponto de inserção sozinho.
Ele inclui os caracteres não imprimíveis, como espaços, caracteres de tabulação e marcas de parágrafo.
Pode ser a área representada pela seleção atual ou ela pode representar uma área diferente da seleção atual.
Não é visível em um documento, ao contrário de uma seleção que está sempre visível.
Ele não é salva com um documento e existe somente enquanto o código está sendo executado.

Quando você insere texto no final de um intervalo, o Word expande automaticamente o intervalo para incluir o texto inserido.

Objetos de controle de conteúdo

A Microsoft.Office.Interop.Word.ContentControl fornece uma maneira para controlar a entrada e a apresentação do texto e outros tipos de conteúdo em documentos do Word. A Microsoft.Office.Interop.Word.ContentControl pode exibir vários tipos diferentes de interface do usuário que são otimizados para uso em documentos do Word, como um controle rich text, um selecionador de data ou uma caixa de combinação. Você também pode usar um Microsoft.Office.Interop.Word.ContentControl para impedir que usuários editem seções do documento ou modelo.

Visual Studio estende o Microsoft.Office.Interop.Word.ContentControl o objeto para vários controles de host diferente. Enquanto o Microsoft.Office.Interop.Word.ContentControl objeto pode exibir qualquer um dos diferentes tipos de interface do usuário que estão disponíveis para os controles de conteúdo, o Visual Studio fornece um tipo diferente para cada controle de conteúdo. Por exemplo, você pode usar um Microsoft.Office.Tools.Word.RichTextContentControl para criar um controle rich text, ou você pode usar um Microsoft.Office.Tools.Word.DatePickerContentControl para criar um selecionador de data. Esses controles de host se comportam como nativa Microsoft.Office.Interop.Word.ContentControl, mas eles têm eventos adicionais e recursos de ligação de dados. For more information, see Controles de conteúdo.

Objeto Bookmark

O Microsoft.Office.Interop.Word.Bookmark objeto representa uma área contígua em um documento, com uma posição inicial e uma posição final. Você pode usar indicadores para marcar um local em um documento ou como um recipiente de texto em um documento. A Microsoft.Office.Interop.Word.Bookmark objeto pode consistir de um ponto de inserção, ou ser tão grande quanto o documento inteiro. A Microsoft.Office.Interop.Word.Bookmark tem as seguintes características que defini-la, além do Range objeto:

Você pode nomear o indicador em tempo de design.
Microsoft.Office.Interop.Word.Bookmarkobjetos são salvas com o documento e, portanto, não são excluídos quando o código interrompe a execução ou o documento é fechado.
Indicadores podem ser ocultos ou tornados visíveis, definindo a ShowBookmarks propriedade da View o objeto para false ou true.

Visual Studio estende o Microsoft.Office.Interop.Word.Bookmark o objeto fornecendo a Microsoft.Office.Tools.Word.Bookmark controle de host. O Microsoft.Office.Tools.Word.Bookmark o controle de host se comporta como um nativo Microsoft.Office.Interop.Word.Bookmark, mas tem eventos adicionais e recursos de ligação de dados. Você pode vincular dados a um controle de indicador em um documento da mesma maneira que você vincular dados a um controle de caixa de texto em um Windows Form. For more information, see Indicador de controle.

Usando a documentação de modelo de objeto do Word

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

Referência de Assembly de interoperabilidade primária

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

Observação
O PIA do Word 2007 não está documentado neste momento. No entanto, os tipos do PIA do Word 2007 também estão incluídos no PIA do Word 2010, para que as informações contidas nesta documentação de referência também se aplica ao Word 2007.

Para obter mais informações sobre o design de PIA do Word, como, por exemplo, as diferenças entre as classes e interfaces o PIA e como os eventos em que o PIA são implementados, consulte Visão geral das Classes e Interfaces no Office Primary Interop Assemblies.

Referência de modelo de objeto do VBA

Os VBA objeto modelo documentos de referência o modelo de objeto do Word como ele é exposto para Visual Basic for Applications o código VBA (). A referência de modelo de objeto do VBA para o Word está disponível nos seguintes locais:

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