ContactItem Object Members

Outlook Developer Reference

Represents a contact in a Contacts folder.

Methods

	Name	Description
	AddBusinessCardLogoPicture	Adds a logo picture to the current Electronic Business Card of the contact item.
	AddPicture	Adds a picture to a contact item.
	ClearTaskFlag	Clears the ContactItem object as a task.
	Close	Closes and optionally saves changes to the Outlook item.
	Copy	Creates another instance of an object.
	Delete	Deletes an object from the collection.
	Display	Displays a new Inspector object for the item.
	ForwardAsBusinessCard	Creates a new MailItem object containing contact information and, optionally, an Electronic Business Card (EBC) image based on the specified ContactItem object.
	ForwardAsVcard	Creates a MailItem and attaches the contact information in vCard format.
	MarkAsTask	Marks a ContactItem object as a task and assigns a task interval for the object.
	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.
	RemovePicture	Removes a picture from a Contacts item.
	ResetBusinessCard	Resets the Electronic Business Card on the contact item to the default business card, deleting any custom layout and logo on the Electronic Business Card.
	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.
	SaveBusinessCardImage	Saves an image of the business card generated from the specified ContactItem object.
	ShowBusinessCardEditor	Displays the electronic business card (EBC) editor dialog box for the ContactItem object.
	ShowCategoriesDialog	Displays the Show Categories dialog box, which allows you to select categories that correspond to the subject of the item.
	ShowCheckPhoneDialog	Displays the Check Phone Number dialog box for a specified telephone number contained by a ContactItem object.

Properties

	Name	Description
	Account	Returns or sets a String representing the account for the contact. Read/write.
	Actions	Returns an Actions collection that represents all the available actions for the item. Read-only.
	Anniversary	Returns or sets a Date indicating the anniversary date for the contact. Read/write.
	Application	Returns an Application object that represents the parent Outlook application for the object. Read-only.
	AssistantName	Returns or sets a String representing the name of the person who is the assistant for the contact. Read/write.
	AssistantTelephoneNumber	Returns or sets a String representing the telephone number of the person who is the assistant for the contact. Read/write.
	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.
	Birthday	Returns or sets a Date indicating the birthday for the contact. Read/write.
	Body	Returns or sets a String representing the clear-text body of the Outlook item. Read/write.
	Business2TelephoneNumber	Returns or sets a String representing the second business telephone number for the contact. Read/write.
	BusinessAddress	Returns or sets a String representing the whole, unparsed business address for the contact. Read/write.
	BusinessAddressCity	Returns or sets a String representing the city name portion of the business address for the contact. Read/write.
	BusinessAddressCountry	Returns or sets a String representing the country/region code portion of the business address for the contact. Read/write.
	BusinessAddressPostalCode	Returns or sets a String representing the postal code (zip code) portion of the business address for the contact. Read/write.
	BusinessAddressPostOfficeBox	Returns or sets a String representing the post office box number portion of the business address for the contact. Read/write.
	BusinessAddressState	Returns or sets a String representing the state code portion of the business address for the contact. Read/write.
	BusinessAddressStreet	Returns or sets a String representing the street address portion of the business address for the contact. Read/write.
	BusinessCardLayoutXml	Returns or sets a String that represents the XML markup for the layout of the Electronic Business Card. Read/write.
	BusinessCardType	Returns an OlBusinessCardType constant that specifies the type of Electronic Business Card used by this contact. Read-only.
	BusinessFaxNumber	Returns or sets a String representing the business fax number for the contact. Read/write.
	BusinessHomePage	Returns or sets a String representing the URL of the business Web page for the contact. Read/write.
	BusinessTelephoneNumber	Returns or sets a String representing the first business telephone number for the contact. Read/write.
	CallbackTelephoneNumber	Returns or sets a String representing the callback telephone number for the contact. Read/write.
	CarTelephoneNumber	Returns or sets a String representing the car telephone number for the contact. Read/write.
	Categories	Returns or sets a String representing the categories assigned to the Outlook item. Read/write.
	Children	Returns or sets a String representing the names of the children of the contact. 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.
	CompanyAndFullName	Returns a String representing the concatenated company name and full name for the contact. Read-only.
	CompanyLastFirstNoSpace	Returns a String representing the company name for the contact followed by the concatenated last name, first name, and middle name with no space between the last and first names. Read-only.
	CompanyLastFirstSpaceOnly	Returns a String representing the company name for the contact followed by the concatenated last name, first name, and middle name with spaces between the last, first, and middle names. Read-only.
	CompanyMainTelephoneNumber	Returns or sets a String representing the company main telephone number for the contact. Read/write.
	CompanyName	Returns or sets a String representing the company name for the contact. Read/write.
	ComputerNetworkName	Returns or sets a String representing the name of the computer network for the contact. Read/write.
	Conflicts	Return the Conflicts object that represents the items that are in conflict for any Outlook item object. Read-only.
	ConversationIndex	Returns a String representing the index of the conversation thread of the Outlook item. 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.
	CustomerID	Returns or sets a String representing the customer ID for the contact. Read/write.
	Department	Returns or sets a String representing the department name for the contact. Read/write.
	DownloadState	Returns a constant that belongs to the OlDownloadState enumeration indicating the download state of the item. Read-only.
	Email1Address	Returns or sets a String representing the e-mail address of the first e-mail entry for the contact. Read/write.
	Email1AddressType	Returns or sets a String representing the address type (such as EX or SMTP) of the first e-mail entry for the contact. Read/write.
	Email1DisplayName	Returns a String representing the display name of the first e-mail address for the contact. Read-write.
	Email1EntryID	Returns a String representing the entry ID of the first e-mail address for the contact. Read-only.
	Email2Address	Returns or sets a String representing the e-mail address of the second e-mail entry for the contact. Read/write.
	Email2AddressType	Returns or sets a String representing the address type (such as EX or SMTP) of the second e-mail entry for the contact. Read/write.
	Email2DisplayName	Returns a String representing the display name of the second e-mail entry for the contact. Read/write.
	Email2EntryID	Returns a String representing the entry ID of the second e-mail entry for the contact. Read-only.
	Email3Address	Returns or sets a String representing the e-mail address of the third e-mail entry for the contact. Read/write.
	Email3AddressType	Returns or sets a String representing the address type (such as EX or SMTP) of the third e-mail entry for the contact. Read/write.
	Email3DisplayName	Returns a String representing the display name of the third e-mail entry for the contact. Read/write.
	Email3EntryID	Returns a String representing the entry ID of the third e-mail entry for the contact. Read-only.
	EntryID	Returns a String representing the unique Entry ID of the object. Read-only.
	FileAs	Returns or sets a String indicating the default keyword string assigned to the contact when it is filed. Read/write.
	FirstName	Returns or sets a String representing the first name for the contact. Read/write.
	FormDescription	Returns the FormDescription object that represents the form description for the specified Outlook item. Read-only.
	FTPSite	Returns or sets a String representing the FTP site entry for the contact. Read/write.
	FullName	Returns or sets a String specifying the whole, unparsed full name for the contact. Read/write.
	FullNameAndCompany	Returns a String representing the full name and company of the contact by concatenating the values of the FullName and CompanyName properties. Read-only.
	Gender	Returns or sets an OlGender constant indicating the gender of the contact. Read/write.
	GetInspector	Returns an Inspector object that represents an inspector initialized to contain the specified item. Read-only.
	GovernmentIDNumber	Returns or sets a String representing the government ID number for the contact. Read/write.
	HasPicture	Returns True if a Contacts item has a picture associated with it. Read-only
	Hobby	Returns or sets a String representing the hobby for the contact. Read/write.
	Home2TelephoneNumber	Returns or sets a String representing the second home telephone number for the contact. Read/write.
	HomeAddress	Returns or sets a String representing the full, unparsed text of the home address for the contact. Read/write.
	HomeAddressCity	Returns or sets a String representing the city portion of the home address for the contact. Read/write.
	HomeAddressCountry	Returns or sets a String representing the country/region portion of the home address for the contact. Read/write.
	HomeAddressPostalCode	Returns or sets a String representing the postal code portion of the home address for the contact. Read/write.
	HomeAddressPostOfficeBox	Returns or sets a String the post office box number portion of the home address for the contact. Read/write.
	HomeAddressState	Returns or sets a String representing the state portion of the home address for the contact. Read/write.
	HomeAddressStreet	Returns or sets a String representing the street portion of the home address for the contact. Read/write.
	HomeFaxNumber	Returns or sets a String representing the home fax number for the contact. Read/write.
	HomeTelephoneNumber	Returns or sets a String representing the first home telephone number for the contact. Read/write.
	IMAddress	Returns or sets a String that represents a contact's Microsoft Instant Messenger address. Read/write.
	Importance	Returns or sets an OlImportance constant indicating the relative importance level for the Outlook item. Read/write.
	Initials	Returns or sets a String representing the initials for the contact. Read/write.
	InternetFreeBusyAddress	Returns or sets a String corresponding to the Address box on the Details tab for a contact. Read/write.
	IsConflict	Returns a Boolean that determines if the item is in conflict. Read-only.
	ISDNNumber	Returns or sets a String representing the ISDN number for the contact. Read/write.
	IsMarkedAsTask	Returns a Boolean value that indicates whether the ContactItem is marked as a task. Read-only.
	ItemProperties	Returns an ItemProperties collection that represents all standard and user-defined properties associated with the Outlook item. Read-only.
	JobTitle	Returns or sets a String representing the job title for the contact. Read/write.
	Journal	Returns a Boolean that indicates True if the transaction of the contact will be journalized. Read/write.
	Language	Returns or sets a String that represents the language in which the contact writes messages. Read/write.
	LastFirstAndSuffix	Returns a String representing the last name, first name, middle name, and suffix of the contact. Read-only.
	LastFirstNoSpace	Returns a String representing the concatenated last name, first name, and middle name of the contact with no space between the last name and the first name. Read-only.
	LastFirstNoSpaceAndSuffix	Returns a String that contains the last name, first name, and suffix of the user without a space. Read-only
	LastFirstNoSpaceCompany	Returns a String representing the concatenated last name, first name, and middle name of the contact with no space between the last name and the first name. Read-only.
	LastFirstSpaceOnly	Returns a String representing the concatenated last name, first name, and middle name of the contact with spaces between them. Read-only.
	LastFirstSpaceOnlyCompany	Returns a String representing the concatenated last name, first name, and middle name of the contact with spaces between them. Read-only.
	LastModificationTime	Returns a Date specifying the date and time that the Outlook item was last modified. Read-only.
	LastName	Returns or sets a String representing the last name for the contact. Read/write.
	LastNameAndFirstName	Returns a String representing the concatenated last name and first name for the contact. Read-only.
	Links	Returns a Links collection that represents the contacts to which the item is linked. Read-only.
	MailingAddress	Returns or sets a String representing the full, unparsed selected mailing address for the contact. Read/write.
	MailingAddressCity	Returns or sets a String representing the city name portion of the selected mailing address of the contact. Read/write.
	MailingAddressCountry	Returns or sets a String representing the country/region code portion of the selected mailing address of the contact. Read/write.
	MailingAddressPostalCode	Returns or sets a String representing the postal code (zip code) portion of the selected mailing address of the contact. Read/write.
	MailingAddressPostOfficeBox	Returns or sets a String representing the post office box number portion of the selected mailing address of the contact. Read/write.
	MailingAddressState	Returns or sets a String representing the state code portion for the selected mailing address of the contact. Read/write.
	MailingAddressStreet	Returns or sets a String representing the street address portion of the selected mailing address of the contact. Read/write.
	ManagerName	Returns or sets a String representing the manager name for the contact. 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.
	MessageClass	Returns or sets a String representing the message class for the Outlook item. Read/write.
	MiddleName	Returns or sets a String representing the middle name for the contact. Read/write.
	Mileage	Returns or sets a String representing the mileage for an item. Read/write.
	MobileTelephoneNumber	Returns or sets a String representing the mobile telephone number for the contact. Read/write.
	NetMeetingAlias	Returns or sets a String indicating the user's Microsoft NetMeeting ID, or alias. Read/write.
	NetMeetingServer	Returns or sets a String specifying the name of the Microsoft NetMeeting server being used for an online meeting. Read/write.
	NickName	Returns or sets a String representing the nickname for the contact. Read/write.
	NoAging	Returns or sets a Boolean value that is True to not age the Outlook item. Read/write.
	OfficeLocation	Returns or sets a String specifying the specific office location (for example, Building 1 Room 1 or Suite 123) for the contact. Read/write.
	OrganizationalIDNumber	Returns or sets a String representing the organizational ID number for the contact. Read/write.
	OtherAddress	Returns or sets a String representing the other address for the contact. Read/write.
	OtherAddressCity	Returns or sets a String representing the city portion of the other address for the contact. Read/write.
	OtherAddressCountry	Returns or sets a String representing the country/region portion of the other address for the contact. Read/write.
	OtherAddressPostalCode	Returns or sets a String representing the postal code portion of the other address for the contact. Read/write.
	OtherAddressPostOfficeBox	Returns or sets a String representing the post office box portion of the other address for the contact. Read/write.
	OtherAddressState	Returns or sets a String representing the state portion of the other address for the contact. Read/write.
	OtherAddressStreet	Returns or sets a String representing the street portion of the other address for the contact. Read/write.
	OtherFaxNumber	Returns or sets a String representing the other fax number for the contact. Read/write.
	OtherTelephoneNumber	Returns or sets a String representing the other telephone number for the contact. Read/write.
	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.
	PagerNumber	Returns or sets a String representing the pager number for the contact. Read/write.
	Parent	Returns the parent Object of the specified object. Read-only.
	PersonalHomePage	Returns or sets a String representing the URL of the personal Web page for the contact. Read/write.
	PrimaryTelephoneNumber	Returns or sets a String specifying the primary telephone number for the contact. Read/write.
	Profession	Returns or sets a String indicating the profession for the contact. Read/write.
	PropertyAccessor	Returns a PropertyAccessor object that supports creating, getting, setting, and deleting properties of the parent ContactItem object. Read-only.
	RadioTelephoneNumber	Returns or sets a String indicating the radio telephone number for the contact. Read/write.
	ReferredBy	Returns or sets a String specifying the referral name entry for the contact. 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.
	ReminderTime	Returns or sets a Date indicating the date and time at which the reminder should occur for the specified item. Read/write.
	Saved	Returns a Boolean value that is True if the Outlook item has not been modified since the last save. Read-only.
	SelectedMailingAddress	Returns or sets an OlMailingAddress constant indicating the type of the mailing address for the contact. 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.
	Spouse	Returns or sets a String indicating the spouse name entry for the contact. Read/write.
	Subject	Returns or sets a String indicating the subject for the Outlook item. Read/write.
	Suffix	Returns or sets a String indicating the name suffix (such as Jr., III, or Ph.D.) for the specified contact. Read/write.
	TaskCompletedDate	Returns or sets a Date value that represents the completion date of the task for this ContactItem. Read/write.
	TaskDueDate	Returns or sets a Date value that represents the due date of the task for this ContactItem. Read/write.
	TaskStartDate	Returns or sets a Date value that represents the start date of the task for this ContactItem object. Read/write.
	TaskSubject	Returns or sets a String value that represents the subject of the task for the ContactItem object. Read/write.
	TelexNumber	Returns or sets a String indicating the telex number for the contact. Read/write.
	Title	Returns or sets a String indicating the title for the contact. Read/write.
	ToDoTaskOrdinal	Returns or sets a Date value that represents the ordinal value of the task for the ContactItem. Read/write.
	TTYTDDTelephoneNumber	Returns or sets a String specifying the TTY/TDD telephone number for the contact. Read/write.
	UnRead	Returns or sets a Boolean value that is True if the Outlook item has not been opened (read). Read/write.
	User1	Returns or sets a String specifying the first field on the Contacts form intended for miscellaneous use for the contact. Read/write.
	User2	Returns or sets a String specifying the second field on the Contacts form intended for miscellaneous use for the contact. Read/write.
	User3	Returns or sets a String specifying the third field on the Contacts form intended for miscellaneous use for the contact. Read/write.
	User4	Returns or sets a String specifying the fourth field on the Contacts form intended for miscellaneous use for the contact. Read/write.
	UserProperties	Returns the UserProperties collection that represents all the user properties for the Outlook item. Read-only.
	WebPage	Returns or sets a String indicating the URL of the Web page for the contact. Read/write.
	YomiCompanyName	Returns or sets a String indicating the Japanese phonetic rendering (yomigana) of the company name for the contact. Read/write.
	YomiFirstName	Returns or sets a String indicating the Japanese phonetic rendering (yomigana) of the first name for the contact. Read/write.
	YomiLastName	Returns or sets a String indicating the Japanese phonetic rendering (yomigana) of the last name for the contact. Read/write.

Events

	Name	Description
	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.
	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 (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).