Visão geral do modelo de objeto do Word

Artigo
02/25/2013

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 são definidos na Microsoft.Office.Interop.Word espaço para nome.

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 2013 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 de modelo de objeto do 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 que é parecido com o da interface do usuário.Na parte superior da hierarquia é a Application objeto.Este objeto representa a instância atual do Word.O objeto Application contém os objetos Document, Selection, Bookmark, e Range.Cada um desses objetos possui vários métodos e propriedades que você pode acessar para manipular e interagir com o objeto.

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 objeto do Word

A princípio, os objetos aparecem se sobreponham.Por exemplo, o Document e Selection objetos são os dois 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 de objeto; mas talvez você queira acessar o intervalo da seleção atual, de um determinado parágrafo, de 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 Application
Objeto Document
Objeto Selection
Objeto Range
Objeto Bookmark

Além do modelo de objeto do Word, projetos do Office em Visual Studio fornecem itens host e controles de host que ampliam a alguns objetos no modelo de objeto do Word.Itens de host e controles de host 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.Para obter mais informações, consulte Automação do Word utilizando o Extended objetos e Itens de host e visão geral sobre controles de Host.

Objeto Application

O Application objeto representa o aplicativo do Word e é pai de todos os outros objetos.Normalmente, 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.Para obter mais informações, consulte Os suplementos de nível de aplicativo de programação..

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

Objeto Document

O Microsoft.Office.Interop.Word.Document objeto é fundamental para programação do Word.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 do documento ativo.Ele é representado pela 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 item de host que fornece acesso a todos os recursos de um Microsoft.Office.Interop.Word.Document de objeto e adiciona a capacidade de adicionar controles gerenciados e de eventos adicionais.

Quando você cria um projeto de nível de documento, você pode acessar Microsoft.Office.Tools.Word.Document membros usando o gerado ThisDocument classe em seu 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.Para obter mais informações, consulte 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 hospedar itens em tempo de execução.Você pode usar o item de host gerado para adicionar controles para o documento associado.Para obter mais informações, consulte Estendendo os documentos do Word e pastas de trabalho do Excel em suplementos de nível de aplicativo em tempo de execução.

Objeto Selection

O Selection objeto representa a área selecionada no momento.Quando você executa uma operação na interface do usuário do Word, como texto em negrito, você seleciona, ou realce o texto e, em seguida, aplica a formatação.O Selection 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 uma única Range objeto.Você pode definir várias Range objetos no mesmo documento.A Range objeto tem as seguintes características:

Ele pode consistir em todo o documento, um intervalo de texto ou o ponto de inserção sozinho.
Ele inclui 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 ele 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 será 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, por exemplo, 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 evitar 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 controles de conteúdo, o Visual Studio oferece 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 o nativo Microsoft.Office.Interop.Word.ContentControl, mas têm recursos de ligação de dados e eventos adicionais.Para obter mais informações, consulte 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 objeto fornecendo a Microsoft.Office.Tools.Word.Bookmark hospedar o controle.O Microsoft.Office.Tools.Word.Bookmark o controle de host se comporta como um nativo Microsoft.Office.Interop.Word.Bookmark, mas possui recursos de ligação de dados e eventos adicionais.Você pode vincular dados a um controle de indicador em um documento da mesma forma que você vincula dados a um controle de caixa de texto em um Windows Form.Para obter mais informações, consulte 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 referir-se a referência de assembly de interoperabilidade primária (PIA) do Word e o Visual Basic for Applications de referência de modelo de objeto (VBA).

Referência de Assembly de interoperabilidade primário

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

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

Referência de modelo de objeto do VBA

A referência de modelo de objeto do VBA documentos o modelo de objeto do Word, como ele é exposto ao código VBA.Para obter mais informações, consulte Referência de modelo de objeto do Word 2010.

Todos os objetos e membros na referência de modelo de objeto do VBA correspondem aos 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 objeto em que o PIA do Word.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 converter o código do VBA nesta referência para Visual Basic ou o Visual C# se você quiser usá-los em uma palavra projeto que você cria usando o Visual Studio.