item (Mailbox 要求集 1.8)
Office.context.mailbox.item
item 用于访问当前选定的邮件、会议请求或约会。 可以使用 属性确定项 itemType 的类型。
要求
| 要求 | 值 |
|---|---|
| 最低版本的邮箱要求集 | 1.1 |
| 最低权限级别 | 限制 |
| 适用的 Outlook 模式 | 约会组织者、约会与会者、 邮件撰写或邮件读取 |
重要
Android 和 iOS：加载项何时激活以及哪些 API 可用存在限制。 若要了解详细信息，请参阅 将移动支持添加到 Outlook 加载项。
属性
方法
| 方法 | 最小值 权限级别 |
按模式排序的详细信息 | 最小值 要求集 |
|---|---|---|---|
| addFileAttachmentAsync(uri, attachmentName, [options], [callback]) | 读/写项 | 约会组织者 | 1.1 |
| 邮件撰写 | 1.1 | ||
| addFileAttachmentFromBase64Async (base64File， attachmentName， [options]， [callback]) | 读/写项 | 约会组织者 | 1.8 |
| 邮件撰写 | 1.8 | ||
| addHandlerAsync(eventType, handler, [options], [callback]) | 读取项 | 约会组织者 | 1.7 |
| 约会与会者 | 1.7 | ||
| 邮件撰写 | 1.7 | ||
| 邮件阅读 | 1.7 | ||
| addItemAttachmentAsync(itemId, attachmentName, [options], [callback]) | 读/写项 | 约会组织者 | 1.1 |
| 邮件撰写 | 1.1 | ||
| close() | 限制 | 约会组织者 | 1.3 |
| 邮件撰写 | 1.3 | ||
| displayReplyAllForm(formData) | 读取项 | 约会与会者 | 1.1 |
| 邮件阅读 | 1.1 | ||
| displayReplyForm(formData) | 读取项 | 约会与会者 | 1.1 |
| 邮件阅读 | 1.1 | ||
| getAllInternetHeadersAsync ([options]， [callback]) | 读取项 | 邮件阅读 | 1.8 |
| getAttachmentContentAsync (attachmentId， [options]， [callback]) | 读取项 | 约会组织者 | 1.8 |
| 约会与会者 | 1.8 | ||
| 邮件撰写 | 1.8 | ||
| 邮件阅读 | 1.8 | ||
| getAttachmentsAsync ([options]， [callback]) | 读取项 | 约会组织者 | 1.8 |
| 邮件撰写 | 1.8 | ||
| getEntities () | 读取项 | 约会与会者 | 1.1 |
| 邮件阅读 | 1.1 | ||
| getEntitiesByType (entityType) | 限制 | 约会与会者 | 1.1 |
| 邮件阅读 | 1.1 | ||
| getFilteredEntitiesByName (name) | 读取项 | 约会与会者 | 1.1 |
| 邮件阅读 | 1.1 | ||
| getInitializationContextAsync ([options]， [callback]) | 读取项 | 约会组织者 | 1.8 |
| 约会与会者 | 1.8 | ||
| 邮件撰写 | 1.8 | ||
| 邮件阅读 | 1.8 | ||
| getItemIdAsync ([options]， callback) | 读取项 | 约会组织者 | 1.8 |
| 邮件撰写 | 1.8 | ||
| getRegExMatches () | 读取项 | 约会与会者 | 1.1 |
| 邮件阅读 | 1.1 | ||
| getRegExMatchesByName (name) | 读取项 | 约会与会者 | 1.1 |
| 邮件阅读 | 1.1 | ||
| getSelectedDataAsync (coercionType， [options]， callback) | 读取项 | 约会组织者 | 1.2 |
| 邮件撰写 | 1.2 | ||
| getSelectedEntities () | 读取项 | 约会与会者 | 1.6 |
| 邮件阅读 | 1.6 | ||
| getSelectedRegExMatches () | 读取项 | 约会与会者 | 1.6 |
| 邮件阅读 | 1.6 | ||
| getSharedPropertiesAsync ([options]， callback) | 读取项 | 约会组织者 | 1.8 |
| 约会与会者 | 1.8 | ||
| 邮件撰写 | 1.8 | ||
| 邮件阅读 | 1.8 | ||
| loadCustomPropertiesAsync(callback, [userContext]) | 读取项 | 约会组织者 | 1.1 |
| 约会与会者 | 1.1 | ||
| 邮件撰写 | 1.1 | ||
| 邮件阅读 | 1.1 | ||
| removeAttachmentAsync(attachmentId, [options], [callback]) | 读/写项 | 约会组织者 | 1.1 |
| 邮件撰写 | 1.1 | ||
| removeHandlerAsync(eventType, [options], [callback]) | 读取项 | 约会组织者 | 1.7 |
| 约会与会者 | 1.7 | ||
| 邮件撰写 | 1.7 | ||
| 邮件阅读 | 1.7 | ||
| saveAsync([options], callback) | 读/写项 | 约会组织者 | 1.3 |
| 邮件撰写 | 1.3 | ||
| setSelectedDataAsync(data, [options], callback) | 读/写项 | 约会组织者 | 1.2 |
| 邮件撰写 | 1.2 |
事件
可以分别使用 addHandlerAsync 和 removeHandlerAsync 订阅和 取消订阅以下事件。
重要
事件仅在任务窗格实现中可用。
| "事件" | 说明 | 最小值 要求集 |
|---|---|---|
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 method.
$(document).ready(function () {
// After the DOM is loaded, app-specific code can run.
const item = Office.context.mailbox.item;
const subject = item.subject;
// Continue with processing the subject of the current item,
// which can be a message or appointment.
});
};
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈