Conjunto de requisitos da API Oculta do Word JavaScript 1.3

  • Artigo

O WordApiHiddenDocument 1.3 conjunto de requisitos é um conjunto de requisitos especial que inclui recursos que só estão disponíveis para o Word no Windows e no Mac. As APIs nesse conjunto de requisitos são consideradas APIs de produção para o aplicativo Word no Windows e no Mac. Eles seguem as políticas de suporte ao desenvolvedor do Microsoft 365. WordApiHiddenDocument As APIs são consideradas APIs de "visualização" para outras plataformas (Web, iPad) e podem não ter suporte em nenhuma dessas plataformas.

Quando as APIs no WordApiHiddenDocument conjunto de requisitos tiverem suporte em todas as plataformas, elas serão adicionadas a um conjunto de requisitos liberado subsequente (WordApi 1.[FUTURE]) e não serão mais marcadas como WordApiHiddenDocument. Pense nisso como um processo de promoção semelhante a uma API que passa da versão prévia para a versão.

Importante

WordApiHiddenDocument 1.3 é um superconjunto do conjunto de requisitos do WordApi 1.3 e é um conjunto de requisitos somente para área de trabalho.

Como WordApiHiddenDocument as APIs só têm suporte pelo Word no Windows e no Mac, seu suplemento deve verificar se o conjunto de requisitos tem suporte antes de chamar essas APIs. Isso evita qualquer tentativa de usar APIs somente área de trabalho em uma plataforma sem suporte.

if (Office.context.requirements.isSetSupported("WordApiHiddenDocument", "1.3")) {
   // Any API exclusive to this desktop-only requirement set.
}

Depois que a API estiver em um conjunto de requisitos entre plataformas, você deverá remover ou editar a isSetSupported verificação. Isso habilitará o recurso do suplemento em outras plataformas. Certifique-se de testar o recurso nessas plataformas ao fazer essa alteração.

Importante

Seu manifesto não pode especificar WordApiHiddenDocument 1.3 como um requisito de ativação. Não é um valor válido a ser usado no elemento Set.

Lista de API

A tabela a seguir lista as APIs JavaScript do Word atualmente incluídas no conjunto de WordApiHiddenDocument requisitos. Para obter uma lista completa de todas as APIs JavaScript do Word (incluindo WordApiHiddenDocument APIs e APIs lançadas anteriormente), consulte todas as APIs JavaScript do Word.

Classe Campos Descrição
DocumentCreated body Obtém o objeto body do documento.
Contentcontrols Obtém a coleção de objetos de controle de conteúdo no documento.
properties Obtém as propriedades do documento.
save() Salva o documento.
Salvou Indica se as alterações do documento foram salvas.
sections Obtém a coleção de objetos de seção no documento.

Confira também