Office.EmailAddressDetails interface

パッケージ:

outlook

電子メール メッセージまたは予定の送信者または指定受信者の電子メール プロパティを提供します。

注釈

最小アクセス許可レベル: 読み取り項目

適用できる Outlook モード: Composeまたは読み取り

使用元

• Office.AppointmentForm: 省略可能なAttendees、 requiredAttendees
• Office.AppointmentRead: 省略可能なAttendees、 開催者、 requiredAttendees
• Office.From: getAsync
• Office.LoadedMessageRead: cc,from, sender, to
• Office.MessageForm: bccRecipients、 ccRecipients、 toRecipients
• Office.MessageRead: cc、 from、 sender、 to
• Office.Organizer: getAsync
• Office.Recipients: addAsync、 getAsync、 setAsync

プロパティ

appointmentResponse	予定に対して出席者が戻した応答を取得します。 このプロパティは、optionalAttendees プロパティまたは requiredAttendees プロパティで表わされる予定の出席者にのみ適用されます。 このプロパティは、他のシナリオでは未定義を返します。
displayName	電子メール アドレスに関連付けられた表示名を取得します。
emailAddress	SMTP 電子メール アドレスを取得します。
recipientType	受信者の電子メール アドレスの種類を取得します。

プロパティの詳細

appointmentResponse

予定に対して出席者が戻した応答を取得します。 このプロパティは、optionalAttendees プロパティまたは requiredAttendees プロパティで表わされる予定の出席者にのみ適用されます。 このプロパティは、他のシナリオでは未定義を返します。

appointmentResponse: MailboxEnums.ResponseType | string;

プロパティ値

Office.MailboxEnums.ResponseType | string

例

// The following sample provides the responses from required attendees.
// Note that this sample needs the add-in to be in Appointment Read (Attendee) mode.
const requiredAttendees = Office.context.mailbox.item.requiredAttendees;
console.log("There are " + requiredAttendees.length + " required attendees.")
requiredAttendees.forEach(function (requiredAttendee) {
    console.log("Attendee " + requiredAttendee.displayName + ": " + requiredAttendee.appointmentResponse);
});

displayName

電子メール アドレスに関連付けられた表示名を取得します。

displayName: string;

プロパティ値

string

例

const organizerName = Office.context.mailbox.item.organizer.displayName;
console.log("Organizer: " + organizerName);

emailAddress

SMTP 電子メール アドレスを取得します。

emailAddress: string;

プロパティ値

string

例

const organizerAddress = Office.context.mailbox.item.organizer.emailAddress;
console.log("Organizer's email address: " + organizerAddress);

recipientType

受信者の電子メール アドレスの種類を取得します。

recipientType: MailboxEnums.RecipientType | string;

プロパティ値

Office.MailboxEnums.RecipientType | string

注釈

重要:

• recipientType プロパティの値は、Office.context.mailbox.item.from.getAsync メソッドと Office.context.mailbox.item.organizer.getAsync メソッドによって返されません。 メール送信者または予定の開催者は、常に Exchange サーバー上のメール アドレスを持つユーザーです。

• メール アイテムの作成中に、以前に選択した送信者アカウントとは異なるドメインにある送信者アカウントに切り替えると、既存の受信者の recipientType プロパティの値は更新されないため、以前に選択したアカウントのドメインに基づいて引き続き使用されます。 アカウントの切り替え後に適切な受信者の種類を取得するには、まず既存の受信者を削除してから、メール アイテムに追加し直す必要があります。

例

const requiredAttendees = Office.context.mailbox.item.requiredAttendees;
console.log("There are " + requiredAttendees.length + " required attendees.")
requiredAttendees.forEach(function (requiredAttendee) {
    console.log("Attendee " + requiredAttendee.displayName + ": " + requiredAttendee.recipientType);
});