Requisitos: Use o VSTO para desenvolver um plug-in simples para o Office, como obter o plug-in do comprimento do caractere Word China.
Modelo de objeto palavra
O Word oferece centenas de objetos para interagir. Esses objetos são organizados em uma hierarquia que segue estritamente a interface do usuário. O objeto Application está no topo da hierarquia. Este objeto representa a instância atual do Word. O objeto Application contém os objetos Documento, Seleção, Marcador e Intervalo. Cada um desses objetos possui vários métodos e propriedades que podem ser usados para manipular e interagir com o objeto.
A imagem a seguir mostra uma visão desses objetos na hierarquia do modelo de objetos do Word.
Documentação:O login do hiperlink está visível.
Objeto de aplicação
O objeto Application representa a aplicação Word e é o pai de todos os outros objetos. Seus membros geralmente são aplicados ao Word como um todo. Você pode usar suas propriedades e métodos para controlar o ambiente de palavras.
Em um projeto adicional VSTO, você pode acessar o objeto ThisAddIn usando os campos Application da classe Application.
Em um projeto em nível de documento, o objeto ThisDocument pode ser acessado usando a propriedade Application da classe Application.
Objeto documento
O objeto Documento é o centro da programação no Word. Ele representa um documento e todo o seu conteúdo. Quando você abre um documento ou cria um novo documento, um novo objeto Documento é criado e adicionado à coleção Application do objeto Documentos. Um documento com foco é conhecido como documento ativo. Ele é representado pela propriedade Application do objeto ActiveDocument.
Quando você cria um projeto em nível de documento, pode acessar o membro ThisDocument usando a classe Document gerada no projeto. O objeto ThisDocument pode ser acessado usando a palavra-chave Me ou esta palavra-chave para código na classe Document, ou usando Globals.ThisDocument para código fora da classe ThisDocument.
Objeto de seleção
O objeto Seleção representa a região atualmente selecionada. Ao realizar uma ação na interface do usuário do Word, como colocar texto em negrito, você pode selecionar ou destacar o texto e então aplicar a formatação. O objeto Seleção está sempre presente no documento. Se nada for verificado, indica um ponto de inserção. Além disso, o conteúdo selecionado pode conter múltiplos blocos de texto não adjacentes.
Objeto de alcance
O objeto Range representa áreas adjacentes no documento e é definido pelas posições dos caracteres de início e fim. Não está limitado a um único objeto de Alcance. Você pode definir múltiplos objetos de Faixa no mesmo documento. Objetos de alcance possuem as seguintes características:
- Ele pode conter apenas pontos de inserção individuais, ou pode conter um conjunto de texto ou o documento inteiro.
- Inclui caracteres não impressos, como espaços, abas e marcadores de parágrafo.
- Pode ser a área representada pelo conteúdo atualmente selecionado ou a área que é diferente desse conteúdo.
- Ele não é visível no documento, ao contrário do conteúdo selecionado, que está sempre visível.
- Ele não é salvo com a documentação e só existe quando o código está rodando.
- Quando o texto é inserido no final de um intervalo, o Word automaticamente expande o intervalo para incluir o texto inserido.
Objetos de Controle de Conteúdo (Objetos de Controle de Conteúdo)
O ContentControl oferece uma forma de controlar a entrada e a renderização de texto e outros tipos de conteúdo dentro de um documento Word. O ContentControl pode exibir muitos tipos diferentes de interface otimizada para uso em documentos Word, como controles de texto com múltiplas mensagens, seletores de data ou caixas combinadas. Você também pode usar o ContentControl para impedir que usuários editem certas seções de um documento ou modelo.
O Visual Studio estende o objeto ContentControl para vários controles diferentes de host. Enquanto o objeto ContentControl exibe todos os diferentes tipos de interface 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 o RichTextContentControl para criar um controle de texto com múltiplas mensagens, ou pode usar o DatePickerContentControl para criar um seletor de datas. Esses controles de host se comportam de forma semelhante aos ContentControls nativos, mas também possuem capacidades adicionais de vinculação de eventos e dados.
Objeto de marcador
O objeto Bookmark representa áreas adjacentes em um documento com posições de início e fim. Você pode usar marcadores para marcar um local no documento ou como um recipiente para a versão chinesa do documento. Um objeto Bookmark pode conter pontos de inserção ou ser tão grande quanto o documento inteiro. O marcador possui as seguintes características que o distinguem dos objetos de alcance:
- Você pode nomear os marcadores ao desenhar.
- O objeto Bookmark é salvo junto com o documento, então não é excluído quando o código para de rodar ou o documento é fechado.
- Acesse a propriedade View configurando a propriedade View como falso ou verdadeiro.
- O Visual Studio estende o objeto Bookmark fornecendo um controle de host Bookmark. Os controles do host dos favoritos se comportam de forma semelhante ao Bookmark nativo, mas também possuem capacidades adicionais de vinculação de eventos e dados. Você pode vincular dados a um controle de favoritos em um documento da mesma forma que vincula dados a um controle de caixa de texto em um Windows Form.
Adicionar um suplemento para criar um Word VSTO
Após entender os conceitos básicos, abra o VS 2022 para criar um novo suplemento VSTO no Word, como mostrado na figura abaixo:
Crie uma fita visual como mostrado na figura a seguir:
Clique duas vezes Ribbon1.cs para abrir, remover a aba padrão e arrastar uma nova aba, como mostrado abaixo:
Arraste um grupo e um controle de botão para a aba da nova aba, conforme mostrado abaixo:
Clique duas vezes no botão recém-criado para criar um evento de clique com o seguinte código:
(Fim)
|
Publicado em 30/04/2023 20:53:15
|
|
|
|
Senhorio|
Publicado em 30/04/2023 23:32:31
|
Publicado em 02/05/2023 10:30:48