context (邮箱要求集 1.4)

Office.context

Office.context 提供所有 Office 应用中的加载项使用的共享接口。 此列表仅记录 Outlook 加载项使用的那些接口。有关 Office.context 命名空间的完整列表，请参阅 通用 API 中的 Office.context 参考。

要求

属性

属性详细信息

contentLanguage：String

获取用户指定用于编辑项的区域设置 (语言) 。

该值contentLanguage反映 Office 客户端应用程序中使用文件>选项>语言指定的当前编辑语言设置。

类型

• String

要求

示例

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

获取用户为 Office 客户端应用程序的 UI 指定的区域设置 (语言) RFC 1766 Language 标记格式。

该值displayLanguage反映 Office 客户端应用程序中的“文件选项语言”>>指定的当前“显示语言”设置。

类型

• String

要求

示例

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;
}

要求： RequirementSetSupport

提供用于确定当前应用程序和平台支持哪些要求集的方法。

类型

• RequirementSetSupport

要求

示例

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

roamingSettings： RoamingSettings

获取一个对象，它表示保存到用户邮箱的邮件外接程序的自定义设置或状态。

对象 RoamingSettings 允许您存储和访问存储在用户邮箱中的邮件加载项的数据，以便从用于访问该邮箱的任何 Outlook 客户端运行时，该加载项可用于该加载项。

类型

• RoamingSettings

Requirements

ui： UI

提供可用于在 Office 外接程序中创建和操作 UI 组件（如对话框）的对象和方法。

类型

• UI

要求