Palavra Overview do modelo de objeto

  • Artigo

Se aplica a

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office.

Tipo de Projeto

  • Projetos de nível de documento

  • Projetos de nível de aplicativo

Versão do Microsoft Office

  • Word 2003

  • Word 2007

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Para desenvolver soluções de Ferramentas do Visual Studio para o Office para o Microsoft Office Word, você pode interagir com o modelo de objeto do Word.Esse modelo de objeto consiste de classes e interfaces que são fornecidas no assembly de interoperabilidade primária para o Word e são definidas no namespace Microsoft.Office.Interop.Word.

Este tópico descreve os seguintes aspectos de usar o modelo de objeto do Word:

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

  • Objetos estendidos no Visual Studio Tools para projetos do Office

  • 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 em projetos de Ferramentas do Visual Studio para o Office, consulte os seguintes tópicos:

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

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

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

Resumo de modelo de objeto do Word

À Primeiro vista, parece haver muita sobreposição.Por exemplo, a Document e Selection objetos são os dois participantes do objeto de Application , mAmbos o objeto Document também é um membro do objeto Selection.Ambos a Document e Selection objetos contêm Bookmark e Range objetos.A sobreposição existe porque há Múltiplo maneiras você pode acessar o mesmo tipo de objeto.Por exemplo, você aplicar formatação a um objeto de Range; mas você pode querer acessar o intervalo da seleção atual, de um parágrafo específico, de uma seção ou de todo o documento.

As seções a seguintes descrevem brevemente os objetos de nível superior e como eles interagem uns com os outros.Esses objetos Incluir os cinco seguintes:

  • Objeto de aplicativo

  • Objeto de documento

  • Objeto Seleção

  • Objeto de intervalo

  • Indicador de objeto

Ferramentas do Visual Studio para o Office também se estende muitos desses objetos em host itens e host controles. Esses estendido objetos podem ser usado em projetos de nível de documento, ou, inicial no Visual Studio 2008 Serviço Pack 1 (SP1), em projetos de nível de aplicativo para o Word 2007.Itens de host e controles de host têm funcionalidade adicional, como recursos e eventos de ligação de dados.Para obter mais informações sobre controles de host, consulte objetos de estendido no Visual Studio Tools para projetos do Office.

Objeto de aplicativo

O objeto Application representa o aplicativo Word e é o pai de Tudo outros objetos.Seus membros geralmente aplicar para o Word como um todo.Você pode usar suas propriedades e métodos para controlar o ambiente do Word.

Em nível de aplicativo Adicionar-em projetos, você pode acessar o objeto de Application por meio do campo Application da classe ThisAddIn.For more information, see Programação Application-Nível Adicionar-ins.

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

Objeto Documento

O objeto Microsoft.Office.Interop.Word.Document é fundamental para programação do Word.Ele representa um documento e Tudo o seu conteúdo.Quando você Abrir um documento ou crie um novo documento, você criar um novo objeto de Microsoft.Office.Interop.Word.Document , que é adicionado à coleção do objeto DocumentsApplication.O documento que tem o foco é chamado do documento ativo.Ele é representado pela propriedade ActiveDocument do objeto Application.

Ferramentas do Visual Studio para o Office estende o objeto Microsoft.Office.Interop.Word.Document , fornecendo a classe Microsoft.Office.Tools.Word.Document.Essa classe é um de item de host de que permite a você Acessar a Tudo membros do Nativo Microsoft.Office.Interop.Word.Document classe e adiciona eventos adicionais e a capacidade de adicionar controles gerenciados e marcas inteligentes.For more information, see Itens de host e Visão geral sobre controles de host.

Quando você Criar um projeto de nível de documento, Ferramentas do Visual Studio para o Office gera uma classe chamada ThisDocument, que deriva da classe Microsoft.Office.Tools.Word.Document.Você pode acessar membros da classe Microsoft.Office.Tools.Word.Document usando o Me ou this palavras-chave do código na classe ThisDocument ou usando Globals.ThisDocument do código fora a classe ThisDocument.Por exemplo, para selecionar o primeiro parágrafo no documento, use o código a seguir.

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

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

Iniciando no SP1, você pode gerar Microsoft.Office.Tools.Word.Document host itens em tempo de execução usando nível de aplicativo Adicionar-ins para Word 2007.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 Excel pastas de trabalho no nível de aplicativo Adicionar-ins em tempo de execução.

Objeto da seleção

O objeto Selection representa a área Selecionadoda no momento.Ao realizar uma operação na interface de usuário do Word, como texto em negrito, você Selecionar, ou Realçar, o texto e, em seguida, aplicar a formatação.O objeto Selection está sempre presente em um documento.Se nada estiver selecionado, em seguida, representa o ponto de inserção.Além disso, uma seleção pode abranger Múltiplo blocos de texto que não são contíguos.

Objeto de intervalo

O objeto Range 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 objeto Simples Range.Você poderá definir Múltiplo objetos de Range no mesmo documento.Um objeto de Range tem as seguintes características:

  • Ele pode consistir do ponto de inserção sozinho, um intervalo de texto ou o documento inteiro.

  • Ele inclui não-Impressão caracteres, como espaços, caracteres de Guiaulação e marcas de parágrafo.

  • Ele pode ser a área representada pela seleção atual, ou ela pode representar uma área diferente da seleção atual.

  • Ele não está visível em um documento, ao contrário de uma seleção, que fica sempre visível.

  • Ele não é salva com um documento e existe somente enquanto o código é Executando.

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

Objetos de Controlarar de conteúdo

Um Microsoft.Office.Interop.Word.ContentControl fornece uma maneira para você controlar a entrada e a apresentação do texto e outros tipos de conteúdo em documentos do Word 2007.Um Microsoft.Office.Interop.Word.ContentControl pode exibir vários tipos diferentes de interface do usuário que sejam otimizados para uso em documentos do Word, como um Controlarar rich Texto, um selecionador de data ou uma caixa de combinação.Você também pode usar um Microsoft.Office.Interop.Word.ContentControl to prevent users from edição seções do documento ou modelo.

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

For more information, see Os controles de conteúdo.

Indicador de objeto

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

  • Você pode nomear o indicador em tempo de design.

  • Objetos de Microsoft.Office.Interop.Word.Bookmark são salvas com o documento e, portanto, não são excluídos quando o código de Executando será interrompida ou o documento é Fechada.

  • Indicadores podem ser ocultos ou Visível por Configuração a propriedade ShowBookmarks do objeto View a false ou true.

Ferramentas do Visual Studio para o Office estende o objeto Microsoft.Office.Interop.Word.Bookmark em um Controlarar de host.O Controlarar de Microsoft.Office.Tools.Word.Bookmark se comporta como um nativo Microsoft.Office.Interop.Word.Bookmark, mas tem eventos adicionais e recursos de ligação de dados.Você pode Ligar dados a um Controlarar de indicador em um documento da mesma maneira que você Ligar dados a um Controlarar de caixa de texto em um Windows Formulário.

For more information, see Indicador de Controlarar.

Estendido objetos no Visual Studio Tools para projetos do Office

É importante compreender Ambos diferençAmbos entre os objetos nativos fornecidos pelo modelo de objeto do Word e os objetos estendidos (itens de host e controles de host) fornecidos pelo Ferramentas do Visual Studio para o Office. Os dois tipos de objetos estão disponíveis para projetos de nível de documento e projetos de nível de aplicativo para o Word 2007.For more information, see Itens de host e Visão geral sobre controles de host.

As diferenças são nas seguintes quatro áreas:

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

Para obter informações sobre as classes que você pode usar no modelo de objeto do Word, consulte os seguintes conjuntos de documentação:

O primeiro link fornece informações sobre as classes e interfaces do assembly de interoperabilidade primária do Word.Os outros links fornecem informações sobre o modelo de objeto do Word como ele está exposto para o Visual Basic para código Applications (VBA).Cada conjunto de documentação tem vantagens e desvantagens para desenvolvedores que estiverem usando Ferramentas do Visual Studio para o Office.

Referência de assembly interoperabilidade primária

Esta documentação descreve Tudo tipos no Word principal interop assembly que você pode usar em projetos de Ferramentas do Visual Studio para o Office.No entanto, esta documentação tem as seguintes desvantagens:

  • Ele descreve apenas os tipos no assembly de interoperabilidade primário para o Word 2003.Para obter descrições dos novos tipos e membros no assembly de interoperabilidade primária do Word 2007, você deve consultar a referência do VBA para o Word 2007.

  • Ele não fornece os exemplos de código no momento.

Referência do VBA

Tudo objetos e os membros a referência do VBA correspondem às classes e membros o assembly de interoperabilidade primária que você usar em projetos de Ferramentas do Visual Studio para o Office.Por exemplo, o objeto de Document na documentação do VBA do Word corresponde à classe Microsoft.Office.Interop.Word.Document no assembly de interoperabilidade primário.

A referência do VBA apresenta as seguintes vantagens:

  • Ele documenta os modelos de objeto do Ambos Word 2007 e o Word 2003.

  • Ela fornece exemplos de código para a maioria dos membros.

A referência do VBA possui as seguintes desvantagens:

  • Ela fornece exemplos de sintaxe e o código para VBA somente.Para usar os exemplos de código em um projeto Ferramentas do Visual Studio para o Office, você deve converter o código VBA para o Visual Basic ou Visual C#.

Tipos adicionais em assemblies de interoperabilidade primários

Os assemblies de interoperabilidade primários contêm muitos tipos que não estão disponíveis para VBA.Esses tipos adicionais ajudam a converter objetos no modelo de objeto de baseado em COM do Word para código gerenciado, não devem ser usadas diretamente em seu código.

For more information, see Overview of Classes and Interfaces in the Office Primary Interop Assemblies.

Consulte também

Conceitos

Trabalhando com documentos

Trabalhando com texto em documentos

Trabalhando com tabelas

Visão geral do modelo de objeto do Excel

Itens de host e Visão geral sobre controles de host

Limitações através de programação de itens de host e controles de host

Noções básicas sobre parâmetros opcionais in Office Solutions

Referência

Assemblies de interoperabilidade primários Office

Outros recursos

Controles de host do Word

Date

History

Motivo

De 2008 de julho

Informações sobre criar Document itens de host em suplementos de nível de aplicativo Adicionados.

Alteração de recurso do SP1.