Partilhar via

contexto (conjunto de requisitos da caixa de correio 1.10)

  • Artigo

Office.context

O Office.context fornece interfaces compartilhadas que são usadas por suplementos em todos os aplicativos do Office. Esta listagem documenta apenas as interfaces usados pelos suplementos do Outlook. Para uma listagem completa do namespace Office.context, veja a referência Office.context na API Comum.

Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1.1
Modo do Outlook aplicável Escrever ou Ler

Propriedades

Propriedade Modos Tipo de retorno Minimum
conjunto de requisitos
Auth Escrever
Leitura		 Auth IdentityAPI 1.3
contentLanguage Escrever
Leitura		 Cadeia de caracteres 1.1
Diagnostics Escrever
Leitura		 ContextInformation 1.5
displayLanguage Escrever
Leitura		 Cadeia de caracteres 1.1
Host Escrever
Leitura		 HostType 1.5
mailbox Escrever
Leitura		 Caixa de Correio 1.1
Plataforma Escrever
Leitura		 PlatformType 1.5
Requisitos Escrever
Leitura		 RequirementSetSupport 1.1
roamingSettings Escrever
Leitura		 RoamingSettings 1.1
ui Escrever
Leitura		 UI 1.1

Detalhes da propriedade

auth: Auth

Dá suporte ao SSO (logon único) fornecendo um método que permite que o aplicativo do Office obtenha um token de acesso ao aplicativo Web do suplemento. Indiretamente, isso também habilita o suplemento para acessar os dados do Microsoft Graph do usuário sem exigir que o usuário se conecte uma segunda vez.

Tipo
Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1.10
Modo do Outlook aplicável Escrever ou Ler
Exemplo
Office.context.auth.getAccessTokenAsync(function(result) {
    if (result.status === "succeeded") {
        const token = result.value;
        // ...
    } else {
        console.log("Error obtaining token", result.error);
    }
});

contentLanguage: String

Obtém a localidade (idioma) especificada pelo usuário para edição do item.

O contentLanguage valor reflete a configuração atual da Linguagem de Edição especificada com Linguagem de Opções > de Arquivo > no aplicativo cliente do Office.

Tipo
  • String
Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1.1
Modo do Outlook aplicável Escrever ou Ler
Exemplo
function sayHelloWithContentLanguage() {
  const myContentLanguage = Office.context.contentLanguage;
  switch (myContentLanguage) {
    case 'en-US':
      write('Hello!');
      break;
    case 'en-NZ':
      write('G\'day mate!');
      break;
  }
}

// Function that writes to a div with id='message' on the page.
function write(message){
  document.getElementById('message').innerText += message;
}

diagnóstico: ContextInformation

Obtém informações sobre o ambiente em que o suplemento está em execução.

Observação

Para todos os conjuntos de requisitos da caixa de correio, você também pode usar a propriedade Office.context.mailbox.diagnostics para obter informações semelhantes.

Tipo
Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1,5
Modo do Outlook aplicável Escrever ou Ler
Exemplo
const contextInfo = Office.context.diagnostics;
console.log("Office application: " + contextInfo.host);
console.log("Office version: " + contextInfo.version);
console.log("Platform: " + contextInfo.platform);

displayLanguage: String

Obtém a localidade (idioma) no formato de marca de linguagem RFC 1766 especificado pelo usuário para a interface do usuário do aplicativo cliente do Office.

O displayLanguage valor reflete a configuração atual da Linguagem de Exibição especificada comLinguagemde Opções> de Arquivo> no aplicativo cliente do Office.

Tipo
  • String
Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1.1
Modo do Outlook aplicável Escrever ou Ler
Exemplo
function sayHelloWithDisplayLanguage() {
  const myDisplayLanguage = Office.context.displayLanguage;
  switch (myDisplayLanguage) {
    case 'en-US':
      write('Hello!');
      break;
    case 'en-NZ':
      write('G\'day mate!');
      break;
  }
}

// Function that writes to a div with id='message' on the page.
function write(message){
  document.getElementById('message').innerText += message;
}

host: HostType

Obtém o aplicativo do Office que está hospedando o suplemento.

Observação

Como alternativa, você pode usar a propriedade Office.context.diagnostics para obter o host. Para todos os conjuntos de requisitos da caixa de correio, você também pode usar a propriedade Office.context.mailbox.diagnostics para obter informações semelhantes.

Tipo
Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1,5
Modo do Outlook aplicável Escrever ou Ler
Exemplo
console.log(JSON.stringify(Office.context.host));

plataforma: PlatformType

Fornece a plataforma na qual o suplemento está em execução.

Observação

Como alternativa, você pode usar a propriedade Office.context.diagnostics para obter a plataforma. Para todos os conjuntos de requisitos da caixa de correio, você também pode usar a propriedade Office.context.mailbox.diagnostics para obter informações semelhantes.

Tipo
Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1,5
Modo do Outlook aplicável Escrever ou Ler
Exemplo
console.log(JSON.stringify(Office.context.platform));

requisitos: RequirementSetSupport

Fornece um método para determinar quais conjuntos de requisitos têm suporte no aplicativo e na plataforma atuais.

Tipo
Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1.1
Modo do Outlook aplicável Escrever ou Ler
Exemplo
console.log(JSON.stringify(Office.context.requirements.isSetSupported("mailbox", "1.1")));

roamingSettings: RoamingSettings

Obtém um objeto que representa as configurações personalizadas ou o estado de um suplemento de email do Outlook salvos na caixa de correio do usuário.

O RoamingSettings objeto permite armazenar e acessar dados de um suplemento de email armazenado na caixa de correio de um usuário, de modo que esteja disponível para esse suplemento quando ele estiver em execução de qualquer cliente do Outlook usado para acessar essa caixa de correio.

Tipo
Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1.1
Nível de permissão mínimo Restrito
Modo do Outlook aplicável Escrever ou Ler

interface do usuário: interface do usuário

Fornece objetos e métodos que você pode usar para criar e manipular componentes da interface do usuário, como caixas de diálogo, em seus Suplementos do Office.

Tipo
Requisitos
Requisito Valor
Versão do conjunto de requisitos mínimos da caixa de correio 1.1
Modo do Outlook aplicável Escrever ou Ler