outlook package

The subclass of Item dealing with appointments.

Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. For more information, refer to the Object Model page.

Child interfaces:

• AppointmentCompose

• AppointmentRead

The appointment organizer mode of Office.context.mailbox.item.

Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. For more information, refer to the Object Model page.

Parent interfaces:

• ItemCompose

• Appointment

The AppointmentForm object is used to access the currently selected appointment.

The appointment attendee mode of Office.context.mailbox.item.

Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. For more information, refer to the Object Model page.

Parent interfaces:

• ItemRead

• Appointment

Represents an attachment on an item from the server. Read mode only.

An array of AttachmentDetails objects is returned as the attachments property of an appointment or message item.

The body object provides methods for adding and updating the content of the message or appointment. It is returned in the body property of the selected item.

Provides an option for the data format.

Represents the details about a contact (similar to what's on a physical contact or business card) extracted from the item's body. Read mode only.

The list of contacts extracted from the body of an email message or appointment is returned in the contacts property of the Entities object returned by the getEntities or getEntitiesByType method of the current item.

Warning: Entity-based contextual Outlook add-ins are now retired. However, regular expression rules are still supported. We recommend updating your contextual add-in to use regular expression rules as an alternative solution. For guidance on how to implement these rules, see Contextual Outlook add-ins.

The CustomProperties object represents custom properties that are specific to a particular mail item and specific to an Outlook add-in. For example, there might be a need for an add-in to save some data that's specific to the current message that activated the add-in. If the user revisits the same message in the future and activates the add-in again, the add-in will be able to retrieve the data that had been saved as custom properties.

To learn more about CustomProperties, see Get and set add-in metadata for an Outlook add-in.

Provides diagnostic information to an Outlook add-in.

Provides the email properties of the sender or specified recipients of an email message or appointment.

Represents an email account on an Exchange Server.

Represents a collection of entities found in an email message or appointment. Read mode only.

The Entities object is a container for the entity arrays returned by the getEntities and getEntitiesByType methods when the item (either an email message or an appointment) contains one or more entities that have been found by the server. You can use these entities in your code to provide additional context information to the viewer, such as a map to an address found in the item, or to open a dialer for a phone number found in the item.

If no entities of the type specified in the property are present in the item, the property associated with that entity is null. For example, if a message contains a street address and a phone number, the addresses property and phoneNumbers property would contain information, and the other properties would be null.

To be recognized as an address, the string must contain a United States postal address that has at least a subset of the elements of a street number, street name, city, state, and zip code.

To be recognized as a phone number, the string must contain a North American phone number format.

Entity recognition relies on natural language recognition that is based on machine learning of large amounts of data. The recognition of an entity is non-deterministic and success sometimes relies on the particular context in the item.

When the property arrays are returned by the getEntitiesByType method, only the property for the specified entity contains data; all other properties are null.

Warning: Entity-based contextual Outlook add-ins are now retired. However, regular expression rules are still supported. We recommend updating your contextual add-in to use regular expression rules as an alternative solution. For guidance on how to implement these rules, see Contextual Outlook add-ins.

The item namespace is used to access the currently selected message, meeting request, or appointment. You can determine the type of the item by using the itemType property.

To see the full member list, refer to the Object Model page.

If you want to see IntelliSense for only a specific type or mode, cast this item to one of the following:

• AppointmentCompose

• AppointmentRead

• MessageCompose

• MessageRead

The compose mode of Office.context.mailbox.item.

Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. For more information, refer to the Object Model page.

Child interfaces:

• AppointmentCompose

• MessageCompose

The read mode of Office.context.mailbox.item.

Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. For more information, refer to the Object Model page.

Child interfaces:

• AppointmentRead

• MessageRead

Represents a date and time in the local client's time zone. Read mode only.

Provides methods to get and set the location of a meeting in an Outlook add-in.

Provides access to the Microsoft Outlook add-in object model.

Key properties:

• diagnostics: Provides diagnostic information to an Outlook add-in.

• item: Provides methods and properties for accessing a message or appointment in an Outlook add-in.

• userProfile: Provides information about the user in an Outlook add-in.

Represents a suggested meeting found in an item. Read mode only.

The list of meetings suggested in an email message is returned in the meetingSuggestions property of the Entities object that's returned when the getEntities or getEntitiesByType method is called on the active item.

The start and end values are string representations of a Date object that contains the date and time at which the suggested meeting is to begin and end. The values are in the default time zone specified for the current user.

Warning: Entity-based contextual Outlook add-ins are now retired. However, regular expression rules are still supported. We recommend updating your contextual add-in to use regular expression rules as an alternative solution. For guidance on how to implement these rules, see Contextual Outlook add-ins.

A subclass of Item for messages.

Important: This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. For more information, refer to the Object Model page.

Child interfaces:

• MessageCompose

• MessageRead

The message compose mode of Office.context.mailbox.item.

Important:

• This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. For more information, refer to the Object Model page.

• When calling Office.context.mailbox.item on a message, note that the Reading Pane in the Outlook client must be turned on. For guidance on how to configure the Reading Pane, see Use and configure the Reading Pane to preview messages.

Parent interfaces:

• ItemCompose

• Message

The message read mode of Office.context.mailbox.item.

Important:

• This is an internal Outlook object, not directly exposed through existing interfaces. You should treat this as a mode of Office.context.mailbox.item. For more information, refer to the Object Model page.

• When calling Office.context.mailbox.item on a message, note that the Reading Pane in the Outlook client must be turned on. For guidance on how to configure the Reading Pane, see Use and configure the Reading Pane to preview messages.

Parent interfaces:

• ItemRead

• Message

Represents a phone number identified in an item. Read mode only.

An array of PhoneNumber objects containing the phone numbers found in an email message is returned in the phoneNumbers property of the Entities object that's returned when you call the getEntities method on the selected item.

Warning: Entity-based contextual Outlook add-ins are now retired. However, regular expression rules are still supported. We recommend updating your contextual add-in to use regular expression rules as an alternative solution. For guidance on how to implement these rules, see Contextual Outlook add-ins.

Represents recipients of an item. Compose mode only.

A file or item attachment. Used when displaying a reply form.

A ReplyFormData object that contains body or attachment data and a callback function. Used when displaying a reply form.

The settings created by using the methods of the RoamingSettings object are saved per add-in and per user. That is, they are available only to the add-in that created them, and only from the user's mailbox in which they are saved.

While the Outlook add-in API limits access to these settings to only the add-in that created them, these settings shouldn't be considered secure storage. They can be accessed by Exchange Web Services or Extended MAPI. They shouldn't be used to store sensitive information, such as user credentials or security tokens.

The name of a setting is a String, while the value can be a String, Number, Boolean, null, Object, or Array.

The RoamingSettings object is accessible via the roamingSettings property in the Office.context namespace.

To learn more about RoamingSettings, see Get and set add-in metadata for an Outlook add-in.

Provides methods to get and set the subject of an appointment or message in an Outlook add-in.

Represents a suggested task identified in an item. Read mode only.

The list of tasks suggested in an email message is returned in the taskSuggestions property of the Entities object that's returned when the getEntities or getEntitiesByType method is called on the active item.

Warning: Entity-based contextual Outlook add-ins are now retired. However, regular expression rules are still supported. We recommend updating your contextual add-in to use regular expression rules as an alternative solution. For guidance on how to implement these rules, see Contextual Outlook add-ins.

The Time object is returned as the start or end property of an appointment in compose mode.

Information about the user associated with the mailbox. This includes their account type, display name, email address, and time zone.

Specifies the attachment's type.

Specifies an entity's type.

Warning: Entity-based contextual Outlook add-ins are now retired. However, regular expression rules are still supported. We recommend updating your contextual add-in to use regular expression rules as an alternative solution. For guidance on how to implement these rules, see Contextual Outlook add-ins.

Specifies an item's type.

Specifies the location from which an add-in wants to access data.

Represents the current view of Outlook on the web.

Specifies the type of recipient of a message or appointment.

Specifies the type of response to a meeting invitation.

Specifies the location in which an add-in wants to save data.

Specifies the source of the selected data in an item (see Office.mailbox.item.getSelectedDataAsync for details).