Office.MasterCategories interface

表示邮箱上的类别主机列表。

在 Outlook 中，用户可以使用类别对邮件和约会进行颜色编码来标记邮件和约会。用户在其邮箱的主列表中定义类别。然后，他们可以将一个或多个类别应用于项目。

重要提示：在代理或共享场景中，代理可以获取主列表中的类别，但无法添加或删除类别。

注解

API 集：邮箱 1.8

最低权限级别： 读/写邮箱

适用的 Outlook 模式：Compose 或 Read

使用方

Office.Mailbox： masterCategories

方法

addAsync(categories, options, callback)	将类别添加到邮箱上的主列表。每个类别必须具有唯一名称，但多个类别可以使用相同的颜色。
addAsync(categories, callback)	将类别添加到邮箱上的主列表。每个类别必须具有唯一名称，但多个类别可以使用相同的颜色。
getAsync(options, callback)	获取邮箱上类别的主列表。
getAsync(callback)	获取邮箱上类别的主列表。
removeAsync(categories, options, callback)	从邮箱上的主列表中删除类别。
removeAsync(categories, callback)	从邮箱上的主列表中删除类别。

addAsync(categories, options, callback)

将类别添加到邮箱上的主列表。每个类别必须具有唯一名称，但多个类别可以使用相同的颜色。

addAsync(categories: CategoryDetails[], options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

参数

categories: Office.CategoryDetails[]

要添加到邮箱主列表的类别。

options: Office.AsyncContextOptions

包含以下一个或多个属性的对象文本：- asyncContext：开发人员可以在回调函数中提供他们希望访问的任何对象。

callback: (asyncResult: Office.AsyncResult<void>) => void

可选。当该方法完成时， callback 将使用类型 Office.AsyncResult为 .

返回

void

注解

API 集：邮箱 1.8

最低权限级别： 读/写邮箱

适用的 Outlook 模式：Compose 或 Read

错误：

DuplicateCategory ：提供的类别之一已在主类别列表中。
PermissionDenied ：用户无权执行此操作。

示例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/45-categories/work-with-master-categories.yaml

const masterCategoriesToAdd = [
  {
    displayName: "TestCategory",
    color: Office.MailboxEnums.CategoryColor.Preset0
  }
];

Office.context.mailbox.masterCategories.addAsync(masterCategoriesToAdd, function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    console.log("Successfully added categories to master list");
  } else {
    console.log("masterCategories.addAsync call failed with error: " + asyncResult.error.message);
  }
});

addAsync(categories, callback)

将类别添加到邮箱上的主列表。每个类别必须具有唯一名称，但多个类别可以使用相同的颜色。

addAsync(categories: CategoryDetails[], callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

参数

categories: Office.CategoryDetails[]

要添加到邮箱主列表的类别。

callback: (asyncResult: Office.AsyncResult<void>) => void

可选。当该方法完成时， callback 将使用类型 Office.AsyncResult为 .

返回

void

注解

API 集：邮箱 1.8

最低权限级别： 读/写邮箱

适用的 Outlook 模式：Compose 或 Read

错误：

DuplicateCategory ：提供的类别之一已在主类别列表中。
PermissionDenied ：用户无权执行此操作。

getAsync(options, callback)

获取邮箱上类别的主列表。

getAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<CategoryDetails[]>) => void): void;

参数

options: Office.AsyncContextOptions

包含以下一个或多个属性的对象文本：- asyncContext：开发人员可以在回调函数中提供他们希望访问的任何对象。

callback: (asyncResult: Office.AsyncResult<Office.CategoryDetails[]>) => void

当该方法完成时， callback 将使用类型 Office.AsyncResult为 . 如果添加类别失败， asyncResult.error 属性将包含错误代码。

返回

void

注解

API 集：邮箱 1.8

最低权限级别： 读/写邮箱

适用的 Outlook 模式：Compose 或 Read

getAsync(callback)

获取邮箱上类别的主列表。

getAsync(callback: (asyncResult: Office.AsyncResult<CategoryDetails[]>) => void): void;

参数

callback: (asyncResult: Office.AsyncResult<Office.CategoryDetails[]>) => void

当该方法完成时， callback 将使用类型 Office.AsyncResult为 .

返回

void

注解

API 集：邮箱 1.8

最低权限级别： 读/写邮箱

适用的 Outlook 模式：Compose 或 Read

示例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/45-categories/work-with-master-categories.yaml

Office.context.mailbox.masterCategories.getAsync(function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    const categories = asyncResult.value;
    if (categories && categories.length > 0) {
      console.log("Master categories:");
      console.log(JSON.stringify(categories));
    } else {
      console.log("There are no categories in the master list.");
    }
  } else {
    console.error(asyncResult.error);
  }
});

removeAsync(categories, options, callback)

从邮箱上的主列表中删除类别。

removeAsync(categories: string[], options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

参数

categories: string[]

要从邮箱上的主列表中删除的类别。

options: Office.AsyncContextOptions

包含以下一个或多个属性的对象文本：- asyncContext：开发人员可以在回调函数中提供他们希望访问的任何对象。

callback: (asyncResult: Office.AsyncResult<void>) => void

可选。当该方法完成时， callback 将使用类型 Office.AsyncResult为 . 如果删除类别失败， asyncResult.error 属性将包含错误代码。

返回

void

注解

API 集：邮箱 1.8

最低权限级别： 读/写邮箱

适用的 Outlook 模式：Compose 或 Read

错误：

PermissionDenied ：用户无权执行此操作。

示例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/45-categories/work-with-master-categories.yaml

const masterCategoriesToRemove = ["TestCategory"];

Office.context.mailbox.masterCategories.removeAsync(masterCategoriesToRemove, function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    console.log("Successfully removed categories from master list");
  } else {
    console.log("masterCategories.removeAsync call failed with error: " + asyncResult.error.message);
  }
});

removeAsync(categories, callback)

从邮箱上的主列表中删除类别。

removeAsync(categories: string[], callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

参数

categories: string[]

要从邮箱上的主列表中删除的类别。

callback: (asyncResult: Office.AsyncResult<void>) => void

可选。当该方法完成时， callback 将使用类型 Office.AsyncResult为 . 如果删除类别失败， asyncResult.error 属性将包含错误代码。

返回

void

注解

API 集：邮箱 1.8

最低权限级别： 读/写邮箱

适用的 Outlook 模式：Compose 或 Read

错误：

PermissionDenied ：用户无权执行此操作。

注解

使用方

方法

方法详细信息

addAsync(categories, options, callback)

参数

返回

注解

示例

addAsync(categories, callback)

参数

返回

注解

getAsync(options, callback)

参数

返回

注解

getAsync(callback)

参数

返回

注解

示例

removeAsync(categories, options, callback)

参数

返回

注解

示例

removeAsync(categories, callback)

参数

返回

注解

反馈