context (Mailbox requirement set 1.13)

Office.context

Office.context fournit des interfaces partagées utilisées par les compléments dans toutes les applications Office. Cette liste documente uniquement les interfaces utilisées par les compléments Outlook. Pour obtenir la liste complète de l’espace de noms Office.context, consultez la référence Office.context dans l’API commune.

Configuration requise

Propriétés

Détails de la propriété

auth: Auth

Prend en charge l’authentification unique (SSO) en fournissant une méthode qui permet à l’application Office d’obtenir un jeton d’accès à l’application web du complément. Indirectement, ceci active également le complément pour accéder aux données de Microsoft Graph de l’utilisateur sans que l’utilisateur ne doive se connecter une deuxième fois.

Type

• Auth

Configuration requise

Exemple

Office.context.auth.getAccessTokenAsync(function(result) {
    if (result.status === "succeeded") {
        var token = result.value;
        // ...
    } else {
        console.log("Error obtaining token", result.error);
    }
});

contentLanguage : chaîne

Obtient les paramètres régionaux (langue) spécifiés par l’utilisateur pour la modification de l’élément.

La contentLanguage valeur reflète le paramètre Langue d’édition actuel spécifié avec La langue des options > de fichier > dans l’application cliente Office.

Type

• String

Configuration requise

Exemple

function sayHelloWithContentLanguage() {
  var 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;
}

diagnostics : ContextInformation

Obtient des informations sur l’environnement dans lequel le complément s’exécute.

Type

• ContextInformation

Configuration requise

Exemple

var contextInfo = Office.context.diagnostics;
console.log("Office application: " + contextInfo.host);
console.log("Office version: " + contextInfo.version);
console.log("Platform: " + contextInfo.platform);

displayLanguage : Chaîne

Obtient les paramètres régionaux (langue) au format de balise de langue RFC 1766 spécifié par l’utilisateur pour l’interface utilisateur de l’application cliente Office.

La displayLanguage valeur reflète le paramètre Langue d’affichage actuel spécifié avec Lalangue desoptions> de fichier> dans l’application cliente Office.

Type

• String

Configuration requise

Exemple

function sayHelloWithDisplayLanguage() {
  var 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

Obtient l’application Office qui héberge le complément.

Type

• HostType

Configuration requise

Exemple

console.log(JSON.stringify(Office.context.host));

platform: PlatformType

Fournit la plateforme sur laquelle le complément s’exécute.

Type

• PlatformType

Configuration requise

Exemple

console.log(JSON.stringify(Office.context.platform));

configuration requise : RequirementsSetSupport

Fournit une méthode pour déterminer quels ensembles de conditions requises sont pris en charge sur l’application et la plateforme actuelles.

Type

• RequirementSetSupport

Configuration requise

Exemple

console.log(JSON.stringify(Office.context.requirements.isSetSupported("mailbox", "1.1")));

roamingSettings : RoamingSettings

Obtient un objet qui représente les paramètres personnalisés ou l’état d’un complément de messagerie enregistrés dans la boîte aux lettres d’un utilisateur.

L’objet RoamingSettings vous permet de stocker et d’accéder aux données d’un complément de messagerie stocké dans la boîte aux lettres d’un utilisateur, de sorte qu’elles soient disponibles pour ce complément lorsqu’il s’exécute à partir d’un client Outlook utilisé pour accéder à cette boîte aux lettres.

Type

• RoamingSettings

Configuration requise

sensitivityLabelsCatalog : SensitivityLabelsCatalog

Obtient l’objet pour case activée la status du catalogue d’étiquettes de confidentialité dans Outlook et récupérer toutes les étiquettes de confidentialité disponibles si le catalogue est activé.

Type

• SensitivityLabelsCatalog

Configuration requise

ui : interface utilisateur

Fournit des objets et des méthodes que vous pouvez utiliser pour créer et manipuler des composants d’interface utilisateur, tels que des boîtes de dialogue, dans vos compléments Office.

Type

• UI

Configuration requise