context (Postfachanforderungssatz 1.1)

  • Artikel

Office.context

Office.context stellt freigegebene Schnittstellen bereit, die von Add-Ins in allen Office-Apps verwendet werden. Diese Auflistung dokumentiert nur die Schnittstellen, die von Outlook-Add-Ins verwendet werden. Eine vollständige Auflistung des Office.context-Namespaces finden Sie in der Office.context-Referenz in der allgemeinen API.

Anforderungen
Anforderung Wert
Mindestversion des Postfachanforderungssatzes 1.1
Zutreffender Outlook-Modus Verfassen oder Lesen

Eigenschaften

Eigenschaft Modi Rückgabetyp Minimum
Anforderungssatz
contentLanguage Verfassen
Lesen		 Zeichenfolge 1.1
displayLanguage Verfassen
Lesen		 Zeichenfolge 1.1
Postfach Verfassen
Lesen		 Postfach 1.1
Anforderungen Verfassen
Lesen		 RequirementSetSupport 1.1
roamingSettings Verfassen
Lesen		 RoamingSettings 1.1
UI Verfassen
Lesen		 Benutzeroberfläche 1.1

Eigenschaftendetails

contentLanguage: String

Ruft das Gebietsschema (Sprache) ab, das vom Benutzer zum Bearbeiten des Elements angegeben wurde.

Der contentLanguage Wert spiegelt die aktuelle Einstellung für die Bearbeitungssprache wider, die in der Office-Clientanwendung mit der Dateioptionensprache >> angegeben wurde.

Typ
  • String
Anforderungen
Anforderung Wert
Mindestversion des Postfachanforderungssatzes 1.1
Zutreffender Outlook-Modus Verfassen oder Lesen
Beispiel
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;
}

displayLanguage: String

Ruft das Gebietsschema (Sprache) im RFC 1766-Sprachtagformat ab, das vom Benutzer für die Benutzeroberfläche der Office-Clientanwendung angegeben wird.

Der displayLanguage Wert spiegelt die aktuelle Einstellung für die Anzeigesprache wider, die in der Office-Clientanwendung mit derDateioptionensprache>> angegeben wurde.

Typ
  • String
Anforderungen
Anforderung Wert
Mindestversion des Postfachanforderungssatzes 1.1
Zutreffender Outlook-Modus Verfassen oder Lesen
Beispiel
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;
}

Requirements: RequirementSetSupport

Stellt eine Methode bereit, um zu bestimmen, welche Anforderungssätze in der aktuellen Anwendung und Plattform unterstützt werden.

Typ
Anforderungen
Anforderung Wert
Mindestversion des Postfachanforderungssatzes 1.1
Zutreffender Outlook-Modus Verfassen oder Lesen
Beispiel
console.log(JSON.stringify(Office.context.requirements.isSetSupported("mailbox", "1.1")));

roamingSettings: RoamingSettings

Ruft ein Objekt ab, das die benutzerdefinierten Einstellungen oder den Status eines Mail-Add-Ins im Postfach eines Benutzers darstellt.

Mit RoamingSettings dem -Objekt können Sie Daten für ein E-Mail-Add-In speichern und darauf zugreifen, das im Postfach eines Benutzers gespeichert ist, sodass dieses Add-In verfügbar ist, wenn es von einem beliebigen Outlook-Client aus ausgeführt wird, der für den Zugriff auf dieses Postfach verwendet wird.

Typ
Anforderungen
Anforderung Wert
Mindestversion des Postfachanforderungssatzes 1.1
Mindestberechtigungsstufe Beschränkt
Zutreffender Outlook-Modus Verfassen oder Lesen

ui: Ui

Stellt Objekte und Methoden bereit, mit denen Sie Benutzeroberflächenkomponenten wie Dialogfelder in Ihren Office-Add-Ins erstellen und bearbeiten können.

Typ
Anforderungen
Anforderung Wert
Mindestversion des Postfachanforderungssatzes 1.1
Zutreffender Outlook-Modus Verfassen oder Lesen