Compartilhar via

Modelo de objeto de JavaScript do Word em Suplementos do Office

  • Artigo

Este artigo descreve os conceitos fundamentais para usar a API JavaScript do Word para criar suplementos.

Importante

Confira Usar o modelo da API específica do aplicativo para saber mais sobre a natureza assíncrona das APIs do Word e como elas funcionam com o documento.

APIs Office.js para Word

Um suplemento Word interage com objetos no Word através da API JavaScript do Office. Isto inclui dois modelos de objetos JavaScript:

  • API JavaScript do Word: a API JavaScript do Word fornece objetos fortemente tipados que você pode usar para acessar documentos, intervalos, tabelas, listas, formatação e mais.

  • APIs comuns: a API Comum dá acesso a recursos como interface do usuário, caixas de diálogo e configurações de cliente que são comuns em vários aplicativos do Office.

Embora você provavelmente usará a API JavaScript do Word para desenvolver a maioria das funcionalidades em suplementos que visam o Word, você também usará objetos na API comum. Por exemplo:

  • Office.Context: o Context objeto representa o ambiente de runtime do suplemento e fornece acesso a objetos chave da API. Ele consiste em configuração do documento, como contentLanguage e officeTheme, além de fornecer informações sobre o ambiente de tempo de execução do suplemento, como host e platform. Além disso, fornece o requirements.isSetSupported() método , que pode utilizar para marcar se um conjunto de requisitos especificado é suportado pela aplicação Word onde o suplemento está em execução.
  • Office.Document: o Office.Document objeto fornece o getFileAsync() método , que pode utilizar para transferir o ficheiro de Word onde o suplemento está em execução. Isto é separado do Word. Objeto de documento.

Diferenças entre a API JS do Word e as APIs comuns.

Modelo de objeto específico do Word

Para entender as APIs do Word, você deve entender como os componentes de um documento estão relacionados entre si.

  • O documento contém as seções, e entidades no nível de documento, como as configurações e partes XML Personalizadas.
  • Uma seção contém umcorpo.
  • Um corpo dá acesso a parágrafos, ContentControls e aos objetos do intervalo, entre outros.
  • Um intervalo representa uma área contínua de conteúdo, incluindo texto, espaço em branco, tabelas e imagens. Ele também contém a maioria dos métodos de manipulação de texto.
  • Uma Lista representa o texto em uma lista numerada ou em lista com marcadores.

Confira também