context (メールボックス要件セット 1.8)

Office.context

Office.context は、すべての Office アプリでアドインによって使用される共有インターフェイスを提供します。 この一覧には、Outlook アドインで使用されるインターフェイスのみが記載されています。Office.context 名前空間の完全な一覧については、 Common 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;
}

diagnostics: ContextInformation

アドインが実行されている環境に関する情報を取得します。

型

• ContextInformation

要件

例

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

displayLanguage: 文字列

Office クライアント アプリケーションの UI に対してユーザーによって指定された RFC 1766 言語タグ形式のロケール (言語) を取得します。

この値は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;
}

host: HostType

アドインをホストしている Office アプリケーションを取得します。

型

• HostType

要件

例

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

platform: PlatformType

アドインが実行されているプラットフォームを提供します。

型

• PlatformType

要件

例

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

requirements: RequirementsSetSupport

現在のアプリケーションとプラットフォームでサポートされている要件セットを決定するためのメソッドを提供します。

型

• RequirementSetSupport

要件

例

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

roamingSettings: RoamingSettings

ユーザーのメールボックスに保存されている、メール アドインのカスタム設定や状態を表すオブジェクトを取得します。

RoamingSettingsオブジェクトを使用すると、ユーザーのメールボックスに格納されているメール アドインのデータを格納およびアクセスできるため、そのメールボックスへのアクセスに使用される Outlook クライアントから実行されている場合に、そのアドインで使用できます。

型

• RoamingSettings

要件

ui: UI

Office アドインで、ダイアログ ボックスなどの UI コンポーネントを作成および操作するために使用できるオブジェクトとメソッドを提供します。

型

• UI

要件