AppointmentItem Members (Outlook)

Represents a meeting, a one-time appointment, or a recurring appointment or meeting in the Calendar folder.

Methods

Name

Description

ClearRecurrencePattern

Removes the recurrence settings and restores the single-occurrence state for an appointment or task.

Close

Closes and optionally saves changes to the Outlook item.

Copy

Creates another instance of an object.

CopyTo

Copies the AppointmentItem to the folder that is specified by the DestinationFolder parameter and returns an object that represents the item created in the destination folder by the copy operation.

Delete

Deletes an object from the collection.

Display

Displays a new Inspector object for the item.

ForwardAsVcal

Forwards the AppointmentItem as a vCal; virtual calendar item.

GetConversation

Obtains a Conversation object that represents the conversation to which this item belongs.

GetOrganizer

Obtains the AddressEntry object that contains information from the Address Book about the organizer of the AppointmentItem.

GetRecurrencePattern

Returns a RecurrencePattern object that represents the recurrence attributes of an appointment.

Move

Moves a Microsoft Outlook item to a new folder.

PrintOut

Prints the Outlook item using all default settings.The PrintOut method is the only Outlook method that can be used for printing.

Respond

Responds to a meeting request.

Save

Saves the Microsoft Outlook item to the current folder or, if this is a new item, to the Outlook default folder for the item type.

SaveAs

Saves the Microsoft Outlook item to the specified path and in the format of the specified file type. If the file type is not specified, the MSG format (.msg) is used.

Send

Sends the appointment.

ShowCategoriesDialog

Displays the Show Categories dialog box, which allows you to select categories that correspond to the subject of the item.

Properties

Name

Description

Actions

Returns an Actions collection that represents all the available actions for the item. Read-only.

AllDayEvent

Returns True if the appointment is an all-day event (as opposed to a specified time). Read/write.

Application

Returns an Application object that represents the parent Outlook application for the object. Read-only.

Attachments

Returns an Attachments object that represents all the attachments for the specified item. Read-only.

AutoResolvedWinner

Returns a Boolean that determines if the item is a winner of an automatic conflict resolution. Read-only.

BillingInformation

Returns or sets a String representing the billing information associated with the Outlook item. Read/write.

Body

Returns or sets a String representing the clear-text body of the Outlook item. Read/write.

BusyStatus

Returns or sets an OlBusyStatus constant indicating the busy status of the user for the appointment. Read/write.

Categories

Returns or sets a String representing the categories assigned to the Outlook item. Read/write.

Class

Returns an OlObjectClass constant indicating the object's class. Read-only.

Companies

Returns or sets a String representing the names of the companies associated with the Outlook item. Read/write.

Conflicts

Return the Conflicts object that represents the items that are in conflict for any Outlook item object. Read-only.

ConversationID

Returns a String that uniquely identifies a Conversation object that the AppointmentItem object belongs to. Read-only.

ConversationIndex

Returns a String that indicates the relative position of the item within the conversation thread. Read-only.

ConversationTopic

Returns a String representing the topic of the conversation thread of the Outlook item. Read-only.

CreationTime

Returns a Date indicating the creation time for the Outlook item. Read-only.

DownloadState

Returns a constant that belongs to the OlDownloadState enumeration indicating the download state of the item. Read-only.

Duration

Returns or sets a Long indicating the duration (in minutes) of the AppointmentItem. Read/write.

End

Returns or sets a Date indicating the end date and time of an AppointmentItem. Read/write.

EndInEndTimeZone

Returns or sets a Date value that represents the end date and time of the appointment expressed in the AppointmentItem.EndTimeZone. Read/write.

EndTimeZone

Returns or sets a TimeZone value that corresponds to the end time of the appointment. Read/write.

EndUTC

Returns or sets a Date value that represents the end date and time of the appointment expressed in the Coordinated Univeral Time (UTC) standard. Read/write.

EntryID

Returns a String representing the unique Entry ID of the object. Read-only.

ForceUpdateToAllAttendees

Returns or sets a Boolean value that indicates whether updates to the AppointmentItem object should be sent to all attendees. Read/write.

FormDescription

Returns the FormDescription object that represents the form description for the specified Outlook item. Read-only.

GetInspector

Returns an Inspector object that represents an inspector initialized to contain the specified item. Read-only.

GlobalAppointmentID

Returns a String value that represents a unique global identifier for the AppointmentItem object. Read-only.

Importance

Returns or sets an OlImportance constant indicating the relative importance level for the Outlook item. Read/write.

InternetCodepage

Returns or sets a Long that determines the Internet code page used by the item. Read/write.

IsConflict

Returns a Boolean that determines if the item on the local computer is different from the copy on the server. Read-only.

IsRecurring

Returns a Boolean value that is True if the appointment is a recurring appointment. Read-only.

ItemProperties

Returns an ItemProperties collection that represents all standard and user-defined properties associated with the Outlook item. Read-only.

LastModificationTime

Returns a Date specifying the date and time that the Outlook item was last modified. Read-only.

Links

Returns a Links collection that represents the contacts to which the item is linked. Read-only.

Location

Returns or sets a String representing the specific office location (for example, Building 1 Room 1 or Suite 123) for the appointment. Read/write.

MarkForDownload

Returns or sets an OlRemoteStatus constant that determines the status of an item once it is received by a remote user. Read/write.

MeetingStatus

Returns or sets an OlMeetingStatus constant specifying the meeting status of the appointment. Read/write.

MeetingWorkspaceURL

Returns the URL for the Meeting Workspace that the appointment item is linked to. Read-only.

MessageClass

Returns or sets a String representing the message class for the Outlook item. Read/write.

Mileage

Returns or sets a String representing the mileage for an item. Read/write.

NoAging

Returns or sets a Boolean value that is True to not age the Outlook item. Read/write.

OptionalAttendees

Returns or sets a String representing the display string of optional attendees names for the appointment. Read/write.

Organizer

Returns a String representing the name of the organizer of the appointment. Read-only.

OutlookInternalVersion

Returns a Long representing the build number of the Outlook application for an Outlook item. Read-only.

OutlookVersion

Returns a String indicating the major and minor version number of the Outlook application for an Outlook item. Read-only.

Parent

Returns the parent Object of the specified object. Read-only.

PropertyAccessor

Returns a PropertyAccessor object that supports creating, getting, setting, and deleting properties of the parent AppointmentItem object. Read-only.

Recipients

Returns a Recipients collection that represents all the recipients for the Outlook item. Read-only.

RecurrenceState

Returns an OlRecurrenceState constant indicating the recurrence property of the specified object. Read-only.

ReminderMinutesBeforeStart

Returns or sets a Long indicating the number of minutes the reminder should occur prior to the start of the appointment. Read/write.

ReminderOverrideDefault

Returns or sets a Boolean value that is True if the reminder overrides the default reminder behavior for the item. Read/write.

ReminderPlaySound

Returns or sets a Boolean value that is True if the reminder should play a sound when it occurs for this item. Read/write.

ReminderSet

Returns or sets a Boolean value that is True if a reminder has been set for this item. Read/write.

ReminderSoundFile

Returns or sets a String indicating the path and file name of the sound file to play when the reminder occurs for the Outlook item. Read/write.

ReplyTime

Returns or sets a Date indicating the reply time for the appointment. Read/write.

RequiredAttendees

Returns a semicolon-delimited String of required attendee names for the meeting appointment. Read/write.

Resources

Returns a semicolon-delimited String of resource names for the meeting. Read/write.

ResponseRequested

Returns a Boolean that indicates True if the sender would like a response to the meeting request for the appointment. Read/write.

ResponseStatus

Returns an OlResponseStatus constant indicating the overall status of the meeting for the current user for the appointment. Read-only.

RTFBody

Returns or sets a Byte array that represents the body of the Microsoft Outlook item in Rich Text Format. Read/write.

Saved

Returns a Boolean value that is True if the Outlook item has not been modified since the last save. Read-only.

SendUsingAccount

Returns or sets an Account object that represents the account under which the AppointmentItem is to be sent. Read/write.

Sensitivity

Returns or sets a constant in the OlSensitivity enumeration indicating the sensitivity for the Outlook item. Read/write.

Session

Returns the NameSpace object for the current session. Read-only.

Size

Returns a Long indicating the size (in bytes) of the Outlook item. Read-only.

Start

Returns or sets a Date indicating the starting date and time for the Outlook item. Read/write.

StartInStartTimeZone

Returns or sets a Date value that represents the start date and time of the appointment expressed in the AppointmentItem.StartTimeZone. Read/write.

StartTimeZone

Returns or sets a TimeZone value that corresponds to the time zone for the start time of the appointment. Read/write.

StartUTC

Returns or sets a Date value that represents the start date and time of the appointment expressed in the Coordinated Univeral Time (UTC) standard. Read/write.

Subject

Returns or sets a String indicating the subject for the Outlook item. Read/write.

UnRead

Returns or sets a Boolean value that is True if the Outlook item has not been opened (read). Read/write.

UserProperties

Returns the UserProperties collection that represents all the user properties for the Outlook item. Read-only.

Events

Name

Description

AfterWrite

Occurs after Microsoft Outlook has saved the item.

AttachmentAdd

Occurs when an attachment has been added to an instance of the parent object.

AttachmentRead

Occurs when an attachment in an instance of the parent object has been opened for reading.

AttachmentRemove

Occurs when an attachment has been removed from an instance of the parent object.

BeforeAttachmentAdd

Occurs before an attachment is added to an instance of the parent object.

BeforeAttachmentPreview

Occurs before an attachment associated with an instance of the parent object is previewed.

BeforeAttachmentRead

Occurs before an attachment associated with an instance of the parent object is read from the file system, an attachment stream, or an Attachment object.

BeforeAttachmentSave

Occurs just before an attachment is saved.

BeforeAttachmentWriteToTempFile

Occurs before an attachment associated with an instance of the parent object is written to a temporary file.

BeforeAutoSave

Occurs before the item is automatically saved by Outlook.

BeforeCheckNames

Occurs just before Microsoft Outlook starts resolving names in the recipient collection for an item (which is an instance of the parent object).

BeforeDelete

Occurs before an item (which is an instance of the parent object) is deleted.

BeforeRead

Occurs before Microsoft Outlook begins to read the properties for the item.

Close

Occurs when the inspector associated with an item (which is an instance of the parent object) is being closed.

CustomAction

Occurs when a custom action of an item (which is an instance of the parent object) executes.

CustomPropertyChange

Occurs when a custom property of an item (which is an instance of the parent object) is changed.

Forward

Occurs when the user selects the Forward action for an item (which is an instance of the parent object).

Open

Occurs when an instance of the parent object is being opened in an Inspector.

PropertyChange

Occurs when an explicit built-in property (for example, Subject) of an instance of the parent object is changed.

Read

Occurs when an instance of the parent object is opened for editing by the user.

Reply

Occurs when the user selects the Reply action for an item (which is an instance of the parent object).

ReplyAll

Occurs when the user selects the ReplyAll action for an item (which is an instance of the parent object).

Send

Occurs when the user selects the Send action for an item, or when the Send method is called for the item, which is an instance of the parent object.

Unload

Occurs before an Outlook item is unloaded from memory, either programmatically or by user action.

Write

Occurs when an instance of the parent object is saved, either explicitly (for example, using the Save or SaveAs methods) or implicitly (for example, in response to a prompt when closing the item's inspector).