项目 (邮箱要求集 1.8)

Office.context.mailbox.item

item 用于访问当前选择的邮件、会议请求或约会。 可以使用 属性来确定项目 itemType 的类型。

要求
要求
最低版本的邮箱要求集 1.1
最低权限级别 受限
适用的 Outlook 模式 约会组织者、约会参与者、
邮件撰写或邮件阅读

重要

Android 和 iOS:外接程序激活时间以及哪些 API 可用存在限制。 若要了解详细信息,请参阅 将移动支持添加到 Outlook 加载项

属性

属性 最小值
权限级别
按模式显示的详细信息 返回类型 最小值
要求集
attachments ReadItem 约会参与者 Array.<AttachmentDetails> 1.1
邮件阅读 Array.<AttachmentDetails> 1.1
bcc ReadItem 邮件撰写 收件人 1.1
body ReadItem 约会组织者 正文 1.1
约会参与者 正文 1.1
邮件撰写 正文 1.1
邮件阅读 正文 1.1
categories ReadItem 约会组织者 Categories 1.8
约会参与者 Categories 1.8
邮件撰写 Categories 1.8
邮件阅读 Categories 1.8
cc ReadItem 邮件撰写 收件人 1.1
邮件阅读 Array.<EmailAddressDetails> 1.1
conversationId ReadItem 邮件撰写 String 1.1
邮件阅读 String 1.1
dateTimeCreated ReadItem 约会参与者 日期 1.1
邮件阅读 日期 1.1
dateTimeModified ReadItem 约会参与者 日期 1.1
邮件阅读 日期 1.1
end ReadItem 约会组织者 Time 1.1
约会参与者 日期 1.1
邮件阅读
(会议请求)
日期 1.1
enhancedLocation ReadItem 约会组织者 EnhancedLocation 1.8
约会参与者 EnhancedLocation 1.8
起始数量 ReadWriteItem 邮件撰写 From 1.7
ReadItem 邮件阅读 EmailAddressDetails 1.1
internetHeaders ReadItem 邮件撰写 InternetHeaders 1.8
internetMessageId ReadItem 邮件阅读 String 1.1
itemClass ReadItem 约会参与者 String 1.1
邮件阅读 String 1.1
itemId ReadItem 约会参与者 字符串 1.1
邮件阅读 字符串 1.1
itemType ReadItem 约会组织者 MailboxEnums.ItemType 1.1
约会参与者 MailboxEnums.ItemType 1.1
邮件撰写 MailboxEnums.ItemType 1.1
邮件阅读 MailboxEnums.ItemType 1.1
位置 ReadItem 约会组织者 位置 1.1
约会参与者 String 1.1
邮件阅读
(会议请求)
字符串 1.1
normalizedSubject ReadItem 约会参与者 String 1.1
邮件阅读 String 1.1
notificationMessages ReadItem 约会组织者 NotificationMessages 1.3
约会参与者 NotificationMessages 1.3
邮件撰写 NotificationMessages 1.3
邮件阅读 NotificationMessages 1.3
optionalAttendees ReadItem 约会组织者 收件人 1.1
约会参与者 Array.<EmailAddressDetails> 1.1
组织者 ReadWriteItem 约会组织者 Organizer 1.7
ReadItem 约会参与者 EmailAddressDetails 1.1
recurrence ReadItem 约会组织者 定期 1.7
约会参与者 定期 1.7
邮件阅读
(会议请求)
定期 1.7
requiredAttendees ReadItem 约会组织者 收件人 1.1
约会参与者 Array.<EmailAddressDetails> 1.1
sender ReadItem 邮件阅读 EmailAddressDetails 1.1
seriesId ReadItem 约会组织者 字符串 1.7
约会参与者 String 1.7
邮件撰写 字符串 1.7
邮件阅读 字符串 1.7
start ReadItem 约会组织者 Time 1.1
约会参与者 日期 1.1
邮件阅读
(会议请求)
日期 1.1
subject ReadItem 约会组织者 主题 1.1
约会参与者 String 1.1
邮件撰写 主题 1.1
邮件阅读 字符串 1.1
更改为 ReadItem 邮件撰写 收件人 1.1
邮件阅读 Array.<EmailAddressDetails> 1.1

方法

方法 最小值
权限级别
按模式显示的详细信息 最小值
要求集
addFileAttachmentAsync(uri, attachmentName, [options], [callback]) ReadWriteItem 约会组织者 1.1
邮件撰写 1.1
addFileAttachmentFromBase64Async (base64File, attachmentName, [options], [callback]) ReadWriteItem 约会组织者 1.8
邮件撰写 1.8
addHandlerAsync(eventType, handler, [options], [callback]) ReadItem 约会组织者 1.7
约会参与者 1.7
邮件撰写 1.7
邮件阅读 1.7
addItemAttachmentAsync(itemId, attachmentName, [options], [callback]) ReadWriteItem 约会组织者 1.1
邮件撰写 1.1
close() 受限 约会组织者 1.3
邮件撰写 1.3
displayReplyAllForm(formData) ReadItem 约会参与者 1.1
邮件阅读 1.1
displayReplyForm(formData) ReadItem 约会参与者 1.1
邮件阅读 1.1
getAllInternetHeadersAsync ([options], [callback]) ReadItem 邮件阅读 1.8
getAttachmentContentAsync (attachmentId, [options], [callback]) ReadItem 约会组织者 1.8
约会参与者 1.8
邮件撰写 1.8
邮件阅读 1.8
getAttachmentsAsync ([options], [callback]) ReadItem 约会组织者 1.8
邮件撰写 1.8
getEntities () ReadItem 约会参与者 1.1
邮件阅读 1.1
getEntitiesByType (entityType) 受限 约会参与者 1.1
邮件阅读 1.1
getFilteredEntitiesByName (name) ReadItem 约会参与者 1.1
邮件阅读 1.1
getItemIdAsync ([options], callback) ReadItem 约会组织者 1.8
邮件撰写 1.8
getRegExMatches () ReadItem 约会参与者 1.1
邮件阅读 1.1
getRegExMatchesByName (name) ReadItem 约会参与者 1.1
邮件阅读 1.1
getSelectedDataAsync (coercionType, [options], callback) ReadItem 约会组织者 1.2
邮件撰写 1.2
getSelectedEntities () ReadItem 约会参与者 1.6
邮件阅读 1.6
getSelectedRegExMatches () ReadItem 约会参与者 1.6
邮件阅读 1.6
getSharedPropertiesAsync ([options], callback) ReadItem 约会组织者 1.8
约会参与者 1.8
邮件撰写 1.8
邮件阅读 1.8
loadCustomPropertiesAsync(callback, [userContext]) ReadItem 约会组织者 1.1
约会参与者 1.1
邮件撰写 1.1
邮件阅读 1.1
removeAttachmentAsync(attachmentId, [options], [callback]) ReadWriteItem 约会组织者 1.1
邮件撰写 1.1
removeHandlerAsync(eventType, [options], [callback]) ReadItem 约会组织者 1.7
约会参与者 1.7
邮件撰写 1.7
邮件阅读 1.7
saveAsync([options], callback) ReadWriteItem 约会组织者 1.3
邮件撰写 1.3
setSelectedDataAsync(data, [options], callback) ReadWriteItem 约会组织者 1.2
邮件撰写 1.2

活动

可以使用 和 分别订阅和取消订阅以下 addHandlerAsync removeHandlerAsync 事件。

重要

事件仅适用于任务窗格实现。

Event Description 最小值
要求集
AppointmentTimeChanged 所选的约会或系列的日期或时间已更改。 1.7
AttachmentsChanged 已将附件添加到项目或已从项目删除附件。 1.8
EnhancedLocationsChanged 所选约会的位置已更改。 1.8
RecipientsChanged 选定项目或约会位置的收件人列表已更改。 1.7
RecurrenceChanged 选定系列的定期模式已更改。 1.7

示例

以下 JavaScript 代码示例显示了如何访问 Outlook 中当前项目的 subject 属性。

// The initialize function is required for all apps.
Office.initialize = function () {
  // Checks for the DOM to load using the jQuery ready function.
  $(document).ready(function () {
    // After the DOM is loaded, app-specific code can run.
    var item = Office.context.mailbox.item;
    var subject = item.subject;
    // Continue with processing the subject of the current item,
    // which can be a message or appointment.
  });
};