Office.EmailAddressDetails interface

包:

outlook

提供电子邮件或约会的发件人或指定收件人的电子邮件属性。

注解

最低权限级别： 读取项

适用的 Outlook 模式：Compose或读取

属性

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