Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Os novos Word APIs JavaScript são introduzidos pela primeira vez em "pré-visualização" e, mais tarde, tornam-se parte de um conjunto de requisitos numerado específico após o teste suficiente e o feedback do utilizador é adquirido.
Importante
Tenha em atenção que as seguintes APIs de pré-visualização Word podem estar disponíveis nas seguintes plataformas.
- Word no Windows
- Word no Mac
Word APIs de pré-visualização não são atualmente suportadas no iPad. No entanto, várias APIs só podem estar disponíveis no Word na Web.
Observação
As APIs de visualização estão sujeitas a alterações e não se destinam ao uso em um ambiente de produção. Recomendamos que você experimente apenas em ambiente de teste e desenvolvimento. Não use APIs de visualização em um ambiente de produção ou em documentos essenciais aos negócios.
Para usar APIs de visualização:
- Tem de utilizar a versão de pré-visualização da biblioteca de API javaScript do Office a partir da rede de entrega de conteúdos (CDN)Office.js. O arquivo de definição de tipo da compilação TypeScript e IntelliSense pode ser encontrado na CDN e DefinitelyTyped. Pode instalar estes tipos com
npm install --save-dev @types/office-js-preview(certifique-se de que remove os tipos para@types/office-jsse os tiver instalado anteriormente). - Poderá ter de aderir ao programa Microsoft 365 Insider para aceder a compilações mais recentes do Office.
Lista de API
A tabela seguinte lista as APIs javaScript Word atualmente em pré-visualização. Para ver uma lista completa de todas as APIs JavaScript Word (incluindo APIs de pré-visualização e APIs lançadas anteriormente), veja todas as APIs javaScript Word.
| Classe | Campos | Descrição |
|---|---|---|
| Body | onCommentAdded | Ocorre quando são adicionados novos comentários. |
| onCommentChanged | Ocorre quando um comentário ou a respetiva resposta é alterada. | |
| onCommentDeleted | Ocorre quando os comentários são eliminados. | |
| onCommentDeselected | Ocorre quando um comentário é desselecionado. | |
| onCommentSelected | Ocorre quando um comentário é selecionado. | |
| type | Obtém o tipo do corpo. | |
| BookmarkCollection | add(name: string, range: Word. Intervalo) | Devolve um Bookmark objeto que representa um marcador adicionado a um intervalo. |
| getItem(index: number) | Obtém um Bookmark objeto pelo respetivo índice na coleção. |
|
| BorderUniversalCollection | getItem(index: number) | Obtém um Border objeto pelo respetivo índice na coleção. |
| CommentDetail | id | Representa o ID deste comentário. |
| replyIds | Representa os IDs das respostas a este comentário. | |
| CommentEventArgs | changeType | Representa a forma como o commentChanged evento é gerado. |
| commentDetails | Obtém a CommentDetail matriz que contém os IDs e os IDs de resposta dos comentários envolvidos. |
|
| source | Especifica a origem do evento. | |
| type | Especifica o tipo de evento. | |
| ConflictCollection | getItem(index: number) | Obtém um Conflict objeto pelo respetivo índice na coleção. |
| ContentControl | onCommentAdded | Ocorre quando são adicionados novos comentários. |
| onCommentChanged | Ocorre quando um comentário ou a respetiva resposta é alterada. | |
| onCommentDeselected | Ocorre quando um comentário é desselecionado. | |
| onCommentSelected | Ocorre quando um comentário é selecionado. | |
| resetState() | Repõe o estado do controlo de conteúdo. | |
| setState(contentControlState: Word. ContentControlState) | Define o estado do controlo de conteúdo. | |
| CustomXmlAddValidationErrorOptions | clearedOnUpdate | Se for fornecido, especifica se o erro deve ser limpo do Word. CustomXmlValidationErrorCollection quando o XML é corrigido e atualizado. |
| errorText | Se for fornecido, especifica o texto de erro descritivo. | |
| CustomXmlNodeCollection | getItem(index: number) | Devolve um CustomXmlNode objeto que representa o item especificado na coleção. |
| CustomXmlPart | errors | Obtém um CustomXmlValidationErrorCollection objeto que fornece acesso a quaisquer erros de validação XML. |
| CustomXmlPrefixMappingCollection | getItem(index: number) | Devolve um CustomXmlPrefixMapping objeto que representa o item especificado na coleção. |
| CustomXmlValidationError | delete() | Elimina este CustomXmlValidationError objeto. |
| errorCode | Obtém um número inteiro que representa o erro de validação no CustomXmlValidationError objeto. |
|
| name | Obtém o nome do erro no CustomXmlValidationError objeto. |
|
| nó | Obtém o nó associado a este CustomXmlValidationError objeto, se existir algum. |
|
| text | Obtém o texto no CustomXmlValidationError objeto. |
|
| type | Obtém o tipo de erro gerado a CustomXmlValidationError partir do objeto. |
|
| CustomXmlValidationErrorCollection | add(node: Word. CustomXmlNode, errorName: cadeia, opções?: Word. CustomXmlAddValidationErrorOptions) | Adiciona um CustomXmlValidationError objeto que contém um erro de validação XML ao CustomXmlValidationErrorCollection objeto. |
| getCount() | Devolve o número de itens na coleção. | |
| getItem(index: number) | Devolve um CustomXmlValidationError objeto que representa o item especificado na coleção. |
|
| items | Obtém os itens filhos carregados nesta coleção. | |
| Document | checkIn(options?: Word. DocumentCheckInOptions) | Verifica o documento do computador local para um servidor e define o documento local como só de leitura para que não possa ser editado localmente. |
| checkInWithVersion(opções?: Word. DocumentCheckInWithVersionOptions) | Guarda o documento num servidor a partir de um computador local e define o documento local como só de leitura para que não possa ser editado localmente. | |
| checkSpelling(options?: Word. DocumentCheckSpellingOptions) | Inicia uma marcar ortográfica para o documento. | |
| computeStatistics(estatística: Word. StatisticType, includeFootnotesAndEndnotes?: booleano) | Devolve uma estatística com base no conteúdo do documento. | |
| countNumberedItems(opções?: Word. DocumentCountNumberedItemsOptions) | Devolve o número de itens com marcas ou numerados e campos LISTNUM no documento. | |
| endReview(options?: Word. DocumentEndReviewOptions) | Termina uma revisão do ficheiro que foi enviado para revisão. | |
| exportAsFixedFormat(outputFileName: string, exportFormat: Word. ExportFormat, options?: Word. DocumentExportAsFixedFormatOptions) | Guarda o documento no formato PDF ou XPS. | |
| exportAsFixedFormat2(outputFileName: string, exportFormat: Word. ExportFormat, options?: Word. DocumentExportAsFixedFormat2Options) | Guarda o documento no formato PDF ou XPS. | |
| exportAsFixedFormat3(outputFileName: string, exportFormat: Word. ExportFormat, options?: Word. DocumentExportAsFixedFormat3Options) | Guarda o documento no formato PDF ou XPS com etiquetas melhoradas. | |
| followHyperlink(options?: Word. DocumentFollowHyperlinkOptions) | Exibe um documento armazenado em cache, se este já tiver sido baixado. | |
| getRange(opções?: Word. DocumentRangeOptions) | Devolve um Range objeto utilizando as posições de carateres iniciais e finais especificadas. |
|
| goTo(options?: Word. GoToOptions) | Devolve um Range objeto que representa a posição inicial do item especificado, como uma página, marcador ou campo. |
|
| merge(fileName: cadeia, opções?: Word. DocumentMergeOptions) | Mescla as alterações marcadas com marcas de revisão de um documento para outro. | |
| printOut(opções?: Word. DocumentPrintOutOptions) | Imprime todo ou parte do documento. | |
| protect(type: Word. ProtectionType, opções?: Word. DocumentProtectOptions) | Protege o documento contra alterações não autorizadas. | |
| replyWithChanges(opções?: Word. DocumentReplyWithChangesOptions) | Envia uma mensagem de e-mail ao autor do documento que foi enviado para revisão, notificando-o de que um revisor concluiu a revisão do documento. | |
| sendFaxOverInternet(opções?: Word. DocumentSendFaxOverInternetOptions) | Envia o documento para um fornecedor de serviços de fax, que envia o documento por fax para um ou mais destinatários especificados. | |
| sendForReview(opções?: Word. DocumentSendForReviewOptions) | Envia o documento numa mensagem de e-mail para revisão pelos destinatários especificados. | |
| DocumentCheckInOptions | comentário | Se for fornecido, especifica um comentário para a operação de marcar de entrada. |
| makePublic | Se for fornecido, especifica se pretende tornar o documento público após marcar. | |
| saveChanges | Se for fornecido, especifica se pretende guardar as alterações antes de dar entrada. | |
| DocumentCheckInWithVersionOptions | comentário | Se for fornecido, especifica um comentário para a operação de marcar de entrada. |
| makePublic | Se for fornecido, especifica se pretende tornar o documento público após marcar. | |
| saveChanges | Se for fornecido, especifica se pretende guardar as alterações antes de dar entrada. | |
| versionType | Se for fornecido, especifica o tipo de versão para o marcar de entrada. | |
| DocumentCheckSpellingOptions | alwaysSuggest | Se for fornecido, especifica se pretende sempre sugerir correções ortográficas. |
| customDictionary10 | Se for fornecido, especifica um dicionário personalizado adicional a utilizar para a verificação ortográfica. | |
| customDictionary2 | Se for fornecido, especifica um dicionário personalizado adicional a utilizar para a verificação ortográfica. | |
| customDictionary3 | Se for fornecido, especifica um dicionário personalizado adicional a utilizar para a verificação ortográfica. | |
| customDictionary4 | Se for fornecido, especifica um dicionário personalizado adicional a utilizar para a verificação ortográfica. | |
| customDictionary5 | Se for fornecido, especifica um dicionário personalizado adicional a utilizar para a verificação ortográfica. | |
| customDictionary6 | Se for fornecido, especifica um dicionário personalizado adicional a utilizar para a verificação ortográfica. | |
| customDictionary7 | Se for fornecido, especifica um dicionário personalizado adicional a utilizar para a verificação ortográfica. | |
| customDictionary8 | Se for fornecido, especifica um dicionário personalizado adicional a utilizar para a verificação ortográfica. | |
| customDictionary9 | Se for fornecido, especifica um dicionário personalizado adicional a utilizar para a verificação ortográfica. | |
| customDictionary | Se for fornecido, especifica o dicionário personalizado a utilizar para a verificação ortográfica. | |
| ignoreUppercase | Se for fornecido, especifica se deve ignorar palavras em maiúsculas durante a verificação ortográfica. | |
| DocumentCountNumberedItemsOptions | level | Se for fornecido, especifica o nível de numeração a contar. |
| numberType | Se for fornecido, especifica o tipo de itens numerados a contar. | |
| DocumentEndReviewOptions | includeAttachment | Se for fornecido, especifica se pretende incluir o documento como um anexo. |
| recipients | Se for fornecido, especifica os destinatários a notificar quando terminar a revisão. | |
| showMessage | Se for fornecido, especifica se pretende mostrar a mensagem antes de enviar. | |
| subject | Se for fornecido, especifica o assunto do e-mail de notificação. | |
| DocumentExportAsFixedFormat2Options | bitmapMissingFonts | Se for fornecido, especifica se existem tipos de letra em falta no mapa de bits. |
| createBookmarks | Se for fornecido, especifica o modo de criação de marcadores. | |
| documentStructureTags | Se for fornecido, especifica se deve incluir etiquetas de estrutura de documentos. | |
| fixedFormatExtClassPtr | Se for fornecido, especifica o ponteiro da classe de extensão. | |
| from | Se for fornecido, especifica o número da página inicial. | |
| includeDocProps | Se for fornecido, especifica se deve incluir as propriedades do documento. | |
| item | Se for fornecido, especifica o item a exportar. | |
| keepInformationRightsManagement | Se for fornecido, especifica se pretende manter as definições de Gestão de Direitos de Informação (IRM). | |
| openAfterExport | Se for fornecido, especifica se pretende abrir o ficheiro após a exportação. | |
| optimizeFor | Se for fornecido, especifica o destino de otimização para a exportação. | |
| optimizeForImageQuality | Se for fornecido, especifica se pretende otimizar a qualidade da imagem no ficheiro exportado. | |
| range | Se for fornecido, especifica o intervalo a exportar. | |
| to | Se for fornecido, especifica o número de página final. | |
| useIso19005_1 | Se for fornecido, especifica se deve utilizar a conformidade ISO 19005-1. | |
| DocumentExportAsFixedFormat3Options | bitmapMissingFonts | Se for fornecido, especifica se existem tipos de letra em falta no mapa de bits. |
| createBookmarks | Se for fornecido, especifica o modo de criação de marcadores. | |
| documentStructureTags | Se for fornecido, especifica se deve incluir etiquetas de estrutura de documentos. | |
| fixedFormatExtClassPtr | Se for fornecido, especifica o ponteiro da classe de extensão. | |
| from | Se for fornecido, especifica o número da página inicial. | |
| improveExportTagging | Se for fornecido, especifica para melhorar a etiquetagem de exportação para uma melhor acessibilidade. | |
| includeDocProps | Se for fornecido, especifica se deve incluir as propriedades do documento. | |
| item | Se for fornecido, especifica o item a exportar. | |
| keepInformationRightsManagement | Se for fornecido, especifica se pretende manter as definições de Gestão de Direitos de Informação (IRM). | |
| openAfterExport | Se for fornecido, especifica se pretende abrir o ficheiro após a exportação. | |
| optimizeFor | Se for fornecido, especifica o destino de otimização para a exportação. | |
| optimizeForImageQuality | Se for fornecido, especifica se pretende otimizar a qualidade da imagem no ficheiro exportado. | |
| range | Se for fornecido, especifica o intervalo a exportar. | |
| to | Se for fornecido, especifica o número de página final. | |
| useIso19005_1 | Se for fornecido, especifica se deve utilizar a conformidade ISO 19005-1. | |
| DocumentExportAsFixedFormatOptions | bitmapMissingFonts | Se for fornecido, especifica se existem tipos de letra em falta no mapa de bits. |
| createBookmarks | Se for fornecido, especifica o modo de criação de marcadores. | |
| documentStructureTags | Se for fornecido, especifica se deve incluir etiquetas de estrutura de documentos. | |
| fixedFormatExtensionClassPointer | Se for fornecido, especifica o ponteiro da classe de extensão. | |
| from | Se for fornecido, especifica o número da página inicial. | |
| includeDocProps | Se for fornecido, especifica se deve incluir as propriedades do documento. | |
| item | Se for fornecido, especifica o item a exportar. | |
| keepInformationRightsManagement | Se for fornecido, especifica se pretende manter as definições de Gestão de Direitos de Informação (IRM). | |
| openAfterExport | Se for fornecido, especifica se pretende abrir o ficheiro após a exportação. | |
| optimizeFor | Se for fornecido, especifica o destino de otimização para a exportação. | |
| range | Se for fornecido, especifica o intervalo a exportar. | |
| to | Se for fornecido, especifica o número de página final. | |
| useIso19005_1 | Se for fornecido, especifica se deve utilizar a conformidade ISO 19005-1. | |
| DocumentFollowHyperlinkOptions | addHistory | Se for fornecido, especifica se pretende adicionar a ligação ao histórico de navegação. |
| address | Se for fornecido, especifica o endereço de hiperligação a seguir. | |
| extraInfo | Se for fornecido, especifica informações adicionais para transmitir com o pedido. | |
| headerInfo | Se for fornecido, especifica as informações de cabeçalho para o pedido HTTP. | |
| httpMethod | Se for fornecido, especifica o método HTTP a utilizar para o pedido. | |
| newWindow | Se for fornecido, especifica se pretende abrir a ligação numa nova janela. | |
| sub-endereço | Se for fornecido, especifica o sub-endereço no documento. | |
| DocumentMergeOptions | addToRecentFiles | Se for fornecido, especifica se pretende adicionar o documento intercalado a ficheiros recentes. |
| detectFormatChanges | Se for fornecido, especifica se pretende detetar alterações de formato durante a intercalação. | |
| mergeTarget | Se for fornecido, especifica o destino da operação de intercalação. | |
| useFormattingFrom | Se for fornecido, especifica a origem da formatação a utilizar na intercalação. | |
| DocumentPrintOutOptions | activePrinterMacGX | Se for fornecido, especifica o nome da impressora. |
| acrescentar | Se for fornecido, especifica se pretende anexar a um ficheiro existente. | |
| fundo | Se for fornecido, especifica se pretende imprimir em segundo plano. | |
| agrupar | Se for fornecido, especifica se pretende agrupar páginas. | |
| cópias | Se for fornecido, especifica o número de cópias a imprimir. | |
| from | Se for fornecido, especifica o número da página inicial. | |
| item | Se for fornecido, especifica o item a imprimir. | |
| manualDuplexPrint | Se for fornecido, especifica se pretende efetuar manualmente a impressão frente e verso. | |
| outputFileName | Se for fornecido, especifica o nome do ficheiro de saída. | |
| pageType | Se for fornecido, especifica a ordem da página. | |
| pages | Se for fornecido, especifica páginas específicas a imprimir. | |
| printToFile | Se for fornecido, especifica se pretende imprimir para o ficheiro. | |
| printZoomColumn | Se for fornecido, especifica a definição da coluna de zoom. | |
| printZoomPaperHeight | Se for fornecido, especifica a altura do papel para impressão em twips (20 twips = 1 ponto; 72 pontos = 1 polegada). | |
| printZoomPaperWidth | Se for fornecido, especifica a largura do papel para impressão em twips (20 twips = 1 ponto; 72 pontos = 1 polegada). | |
| printZoomRow | Se for fornecido, especifica a definição da linha de zoom. | |
| range | Se for fornecido, especifica o intervalo a imprimir. | |
| to | Se for fornecido, especifica o número de página final. | |
| DocumentProtectOptions | enforceStyleLock | Se for fornecido, especifica se pretende impor restrições de bloqueio de estilo. |
| noReset | Se for fornecido, especifica se pretende repor campos de formulário ao proteger o documento. | |
| senha | Se for fornecido, especifica a palavra-passe a aplicar para proteção de documentos. | |
| useInformationRightsManagement | Se for fornecido, especifica se pretende utilizar a Gestão de Direitos de Informação (IRM). | |
| DocumentRangeOptions | end | Se for fornecido, especifica a posição do caráter final. |
| início | Se for fornecido, especifica a posição do caráter inicial. | |
| DocumentReplyWithChangesOptions | includeAttachment | Se for fornecido, especifica se pretende incluir o documento como um anexo. |
| recipients | Se for fornecido, especifica os destinatários da resposta. | |
| showMessage | Se for fornecido, especifica se pretende mostrar a mensagem antes de enviar. | |
| subject | Se for fornecido, especifica o assunto do e-mail de resposta. | |
| DocumentSendFaxOverInternetOptions | recipients | Se for fornecido, especifica os destinatários do fax. |
| showMessage | Se for fornecido, especifica se pretende mostrar a mensagem antes de enviar. | |
| subject | Se for fornecido, especifica o assunto do fax. | |
| DocumentSendForReviewOptions | includeAttachment | Se for fornecido, especifica se pretende incluir o documento como um anexo. |
| recipients | Se for fornecido, especifica os destinatários do pedido de revisão. | |
| showMessage | Se for fornecido, especifica se pretende mostrar a mensagem antes de enviar. | |
| subject | Se for fornecido, especifica o assunto do e-mail de revisão. | |
| GoToOptions | Count | Se for fornecido, especifica o número do item no documento. |
| direção | Se for fornecido, especifica a direção para onde o intervalo ou seleção é movido. | |
| item | Se for fornecido, especifica o tipo de item para o que o intervalo ou seleção é movido. | |
| name | Se for fornecido, especifica o nome se a item propriedade estiver definida como Word. Tipo goToItem bookmark, comment, fieldou object. |
|
| IndexCollection | getItem(index: number) | Obtém um Index objeto pelo respetivo índice na coleção. |
| ListTemplateAddOptions | name | Se for fornecido, especifica o nome do modelo de lista a adicionar. |
| outlineNumbered | Se for fornecido, especifica se deve aplicar numeração hierárquica ao novo modelo de lista. | |
| ListTemplateCollection | add(options?: Word. ListTemplateAddOptions) | Adiciona um novo ListTemplate objeto. |
| getItem(index: number) | Obtém um ListTemplate objeto pelo respetivo índice na coleção. |
|
| ListTemplateGalleryCollection | getItem(index: number) | Obtém um ListTemplateGallery objeto pelo respetivo índice na coleção. |
| Paragraph | onCommentAdded | Ocorre quando são adicionados novos comentários. |
| onCommentChanged | Ocorre quando um comentário ou a respetiva resposta é alterada. | |
| onCommentDeleted | Ocorre quando os comentários são eliminados. | |
| onCommentDeselected | Ocorre quando um comentário é desselecionado. | |
| onCommentSelected | Ocorre quando um comentário é selecionado. | |
| Range | onCommentAdded | Ocorre quando são adicionados novos comentários. |
| onCommentChanged | Ocorre quando um comentário ou a respetiva resposta é alterada. | |
| onCommentDeselected | Ocorre quando um comentário é desselecionado. | |
| onCommentSelected | Ocorre quando um comentário é selecionado. | |
| underline | Especifica o tipo de sublinhado aplicado ao intervalo. | |
| RangeScopedCollection | getItem(index: number) | Obtém um Range objeto pelo respetivo índice na coleção. |
| RepeatingSectionContentControl | xmlMapping | Devolve um XmlMapping objeto que representa o mapeamento do controlo de conteúdo para dados XML no arquivo de dados do documento. |
| ReviewerCollection | getItem(index: number) | Devolve um Reviewer objeto que representa o item especificado na coleção. |
| RevisionCollection | getItem(index: number) | Devolve um Revision objeto que representa o item especificado na coleção. |
| Selection | convertToTable(opções?: Word. SelectionConvertToTableOptions) | Converte o texto dentro de um intervalo em uma tabela. |
| goTo(options?: Word. GoToOptions) | Devolve um Range objeto que representa a área especificada pelo options e move o ponto de inserção para a posição do caráter imediatamente antes do item especificado. |
|
| SelectionConvertToTableOptions | applyBorders | Se for fornecido, especifica se deve aplicar limites à tabela do formato especificado. |
| applyColor | Se for fornecido, especifica se pretende aplicar formatação de cor à tabela do formato especificado. | |
| applyFirstColumn | Se for fornecido, especifica se deve aplicar formatação especial à primeira coluna do formato especificado. | |
| applyFont | Se for fornecido, especifica se pretende aplicar formatação de tipo de letra à tabela do formato especificado. | |
| applyHeadingRows | Se for fornecido, especifica se pretende formatar a primeira linha como uma linha de cabeçalho do formato especificado. | |
| applyLastColumn | Se for fornecido, especifica se pretende aplicar formatação especial à última coluna do formato especificado. | |
| applyLastRow | Se for fornecido, especifica se pretende aplicar formatação especial à última linha do formato especificado. | |
| applyShading | Se for fornecido, especifica se pretende aplicar sombreado à tabela do formato especificado. | |
| Ajuste automático | Se for fornecido, especifica se pretende redimensionar automaticamente a tabela para se ajustar aos conteúdos. | |
| Ajuste AutomáticoBehavior | Se for fornecido, especifica o comportamento de ajuste automático da tabela. | |
| defaultTableBehavior | Se for fornecido, especifica se a Microsoft Word redimensiona automaticamente as células numa tabela para se ajustarem aos conteúdos. | |
| format | Se for fornecido, especifica um formato predefinido a aplicar à tabela. | |
| initialColumnWidth | Se for fornecido, especifica a largura inicial de cada coluna na tabela, em pontos. | |
| numColumns | Se for fornecido, especifica o número de colunas na tabela. | |
| numRows | Se for fornecido, especifica o número de linhas na tabela. | |
| separador | Se for fornecido, especifica o caráter utilizado para separar o texto em células. | |
| SourceCollection | getItem(index: number) | Obtém um Source pelo respetivo índice na coleção. |
| Estilo | description | Obtém a descrição do estilo. |
| TabStopCollection | getItem(index: number) | Obtém um TabStop objeto pelo respetivo índice na coleção. |
| Janela | state | Especifica o estado da janela do documento ou da janela de tarefas. |
| XmlNode | type | Obtém o tipo de nó. |
| value | Especifica o valor deste nó XML. | |
| XmlNodeCollection | getItem(index: number) | Obtém um XmlNode objeto pelo respetivo índice na coleção. |