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

Office.context

Office.context は、すべての Office アプリでアドインによって使用される共有インターフェイスを提供します。 この一覧には、Outlook アドインで使用されるインターフェイスのみが記載されています。Office.context 名前空間の完全な一覧については、 Common API の Office.context リファレンスを参照してください。

要件
要件
メールボックスの最小要件セットのバージョン 1.1
適用可能な Outlook のモード 新規作成または閲覧

プロパティ

プロパティ モード 戻り値の種類 最小値
要件セット
contentLanguage 作成
読み取り
文字列 1.1
診断 作成
読み取り
ContextInformation 1.5
displayLanguage 作成
読み取り
文字列 1.1
ホスト 作成
読み取り
HostType 1.5
mailbox 作成
読み取り
メールボックス 1.1
プラットフォーム 作成
読み取り
PlatformType 1.5
要件 作成
読み取り
RequirementSetSupport 1.1
roamingSettings 作成
読み取り
RoamingSettings 1.1
UI 作成
読み取り
UI 1.1

プロパティの詳細

contentLanguage: String

アイテムを編集するためにユーザーによって指定されたロケール (言語) を取得します。

値はcontentLanguage、Office クライアント アプリケーションの [ファイル > オプション言語] で指定されている現在の [編集言語] > 設定を反映します。

  • String
要件
要件
メールボックスの最小要件セットのバージョン 1.1
適用可能な Outlook のモード 新規作成または閲覧
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

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

注:

すべてのメールボックス要件セットについて、 Office.context.mailbox.diagnostics プロパティを使用して同様の情報を取得することもできます。

要件
要件
メールボックスの最小要件セットのバージョン 1.5
適用可能な Outlook のモード 新規作成または閲覧
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
要件
要件
メールボックスの最小要件セットのバージョン 1.1
適用可能な Outlook のモード 新規作成または閲覧
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 アプリケーションを取得します。

注:

または、 Office.context.diagnostics プロパティを使用してホストを取得することもできます。 すべてのメールボックス要件セットについて、 Office.context.mailbox.diagnostics プロパティを使用して同様の情報を取得することもできます。

要件
要件
メールボックスの最小要件セットのバージョン 1.5
適用可能な Outlook のモード 新規作成または閲覧
console.log(JSON.stringify(Office.context.host));



platform: PlatformType

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

注:

または、 Office.context.diagnostics プロパティを使用してプラットフォームを取得することもできます。 すべてのメールボックス要件セットについて、 Office.context.mailbox.diagnostics プロパティを使用して同様の情報を取得することもできます。

要件
要件
メールボックスの最小要件セットのバージョン 1.5
適用可能な Outlook のモード 新規作成または閲覧
console.log(JSON.stringify(Office.context.platform));



requirements: RequirementsSetSupport

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

要件
要件
メールボックスの最小要件セットのバージョン 1.1
適用可能な Outlook のモード 新規作成または閲覧
console.log(JSON.stringify(Office.context.requirements.isSetSupported("mailbox", "1.1")));



roamingSettings: RoamingSettings

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

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

要件
要件
メールボックスの最小要件セットのバージョン 1.1
最小限のアクセス許可レベル 制限
適用可能な Outlook のモード 新規作成または閲覧



ui: UI

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

要件
要件
メールボックスの最小要件セットのバージョン 1.1
適用可能な Outlook のモード 新規作成または閲覧