Office.Subject interface
Outlook のアドインで、予定またはメッセージの件名を取得および設定するメソッドを提供します。
メソッド
| get |
予定またはメッセージの件名を取得します。
|
| get |
予定またはメッセージの件名を取得します。
|
| set |
予定またはメッセージの件名を設定します。
|
| set |
予定またはメッセージの件名を設定します。
|
メソッドの詳細
getAsync(options, callback)
予定またはメッセージの件名を取得します。
getAsync メソッドは、Exchange サーバーへの非同期呼び出しを開始し、予定またはメッセージの件名を取得します。
getAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<string>) => void): void;パラメーター
- options
- Office.AsyncContextOptions
次のプロパティの 1 つ以上を含むオブジェクト リテラル:- asyncContext: 開発者は、コールバック関数でアクセスしたいオブジェクトを指定できます。
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
メソッドが完了すると、 callback パラメーターで渡された関数が型 Office.AsyncResult の 1 つのパラメーターで呼び出されます。 結果の value プロパティは、アイテムのサブジェクトです。
返品
void
注釈
最小アクセス許可レベル: 項目の読み取り
適用可能な Outlook モード: Compose
getAsync(callback)
予定またはメッセージの件名を取得します。
getAsync メソッドは、Exchange サーバーへの非同期呼び出しを開始し、予定またはメッセージの件名を取得します。
getAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;パラメーター
- callback
-
(asyncResult: Office.AsyncResult<string>) => void
メソッドが完了すると、 callback パラメーターで渡された関数が型 Office.AsyncResult の 1 つのパラメーターで呼び出されます。 結果の value プロパティは、アイテムのサブジェクトです。
返品
void
注釈
最小アクセス許可レベル: 項目の読み取り
適用可能な Outlook モード: Compose
例
Office.context.mailbox.item.subject.getAsync(callback);
function callback(asyncResult) {
const subject = asyncResult.value;
}
setAsync(subject, options, callback)
予定またはメッセージの件名を設定します。
setAsync メソッドは、Exchange サーバーへの非同期呼び出しを開始して、予定またはメッセージの件名を設定します。 件名を設定すると、現在の件名は上書きされますが、"Fwd:" または "Re:" などのプレフィックスはそのまま残ります。
setAsync(subject: string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;パラメーター
- subject
-
string
予定またはメッセージの件名。 文字列の長さは最大 255 文字です。
- options
- Office.AsyncContextOptions
次のプロパティの 1 つ以上を含むオブジェクト リテラル:- asyncContext: 開発者は、コールバック関数でアクセスしたいオブジェクトを指定できます。
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
省略可能。 メソッドが完了すると、 callback パラメーターで渡された関数が型 Office.AsyncResult の 1 つのパラメーターで呼び出されます。 件名の設定に失敗すると、asyncResult.error プロパティにエラー コードが格納されます。
返品
void
注釈
最小アクセス許可レベル: 項目の読み取り
適用可能な Outlook モード: Compose
重要:
Android 版および iOS 版の Outlook では、この方法は Message Compose モードではサポートされません。 予定の主催者モードのみがサポートされています。 Outlook Mobile でサポートされている API の詳細については、「モバイル デバイスの Outlook でサポートされている Outlook JavaScript API」を参照してください。
setAsyncメソッドは、現在loadItemByIdAsyncメソッドを使用して読み込まれているメッセージではサポートされていません。 詳細については、「 複数のメッセージに対して Outlook アドインをアクティブ化する」を参照してください。
エラー:
-
DataExceedsMaximumSize: 件名パラメーターが 255 文字より長くなっています。
例
Office.context.mailbox.item.subject.setAsync("New subject!", function (asyncResult) {
if (asyncResult.status === "failed") {
console.log("Action failed with error: " + asyncResult.error.message);
}
});
setAsync(subject, callback)
予定またはメッセージの件名を設定します。
setAsync メソッドは、Exchange サーバーへの非同期呼び出しを開始して、予定またはメッセージの件名を設定します。 件名を設定すると、現在の件名は上書きされますが、"Fwd:" または "Re:" などのプレフィックスはそのまま残ります。
setAsync(subject: string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;パラメーター
- subject
-
string
予定またはメッセージの件名。 文字列の長さは最大 255 文字です。
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
省略可能。 メソッドが完了すると、 callback パラメーターで渡された関数が型 Office.AsyncResult の 1 つのパラメーターで呼び出されます。 件名の設定に失敗すると、asyncResult.error プロパティにエラー コードが格納されます。
返品
void
注釈
最小アクセス許可レベル: 項目の読み取り
適用可能な Outlook モード: Compose
重要:
Android 版および iOS 版の Outlook では、この方法は Message Compose モードではサポートされません。 予定の主催者モードのみがサポートされています。 Outlook Mobile でサポートされている API の詳細については、「モバイル デバイスの Outlook でサポートされている Outlook JavaScript API」を参照してください。
setAsyncメソッドは、現在loadItemByIdAsyncメソッドを使用して読み込まれているメッセージではサポートされていません。 詳細については、「 複数のメッセージに対して Outlook アドインをアクティブ化する」を参照してください。
エラー:
-
DataExceedsMaximumSize: 件名パラメーターが 255 文字より長くなっています。