Office.MailboxEnums.CategoryColor enum

Package:

outlook

Specifies the category color.

Remarks

[ API set: Mailbox 1.8 ]

Applicable Outlook mode: Compose or Read

Important: The actual color depends on how the Outlook client renders it. In this case, the colors noted on each preset apply to Outlook on the web, on Windows (new and classic), and on Mac (starting in Version 16.78).

Earlier versions of Outlook on Mac had a bug that displayed incorrect preset colors. This has now been fixed starting in Version 16.78. If you've recently updated your Outlook client, you need to adjust the category colors in your add-in to match the updated preset values.

Examples

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

Fields

None	Default color or no color mapped.
Preset0	Red
Preset1	Orange
Preset2	Brown
Preset3	Yellow
Preset4	Green
Preset5	Teal
Preset6	Olive
Preset7	Blue
Preset8	Purple
Preset9	Cranberry
Preset10	Steel
Preset11	DarkSteel
Preset12	Gray
Preset13	DarkGray
Preset14	Black
Preset15	DarkRed
Preset16	DarkOrange
Preset17	DarkBrown
Preset18	DarkYellow
Preset19	DarkGreen
Preset20	DarkTeal
Preset21	DarkOlive
Preset22	DarkBlue
Preset23	DarkPurple
Preset24	DarkCranberry