Category Interface

Definition

Namespace:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

Represents a user-defined category by which Microsoft Outlook items can be grouped.

public interface class Category : Microsoft::Office::Interop::Outlook::_Category

[System.Runtime.InteropServices.Guid("000630E3-0000-0000-C000-000000000046")]
public interface Category : Microsoft.Office.Interop.Outlook._Category

Public Interface Category
Implements _Category

Derived

Microsoft.Office.Interop.Outlook.CategoryClass

Attributes

GuidAttribute

Implements

_Category

Remarks

This is a .NET interface derived from a COM coclass that is required by managed code for interoperability with the corresponding COM object. Use this derived interface to access all method, property, and event members of the COM object. However, if a method or event you want to use shares the same name under the same COM object, cast to the corresponding primary interface to call the method, and cast to the latest events interface to connect to the event. Refer to this topic for information about the COM object. For information about the method and property members of the COM object, see _Category.

Outlook provides a categorization system with which Outlook items can be easily identified and grouped into user-defined categories. The Category object represents a user-defined category.

Use the Add(String, Object, Object) method of the Categories property for the NameSpace object to create a new Category object, adding the category to the Master Category List for that namespace.

Use the Name property to specify the name of the category, the Color property to specify the color displayed for that category, and the ShortcutKey property to specify the shortcut key used to assign that category to an Outlook item in the Outlook user interface. Use the CategoryID property to retrieve the unique identifer for a category.

Categories can be assigned to Outlook items by specifying the names of the appropriate Category objects in a comma-delimited string in the Categories property of the following objects:

	AppointmentItem	RemoteItem
	ContactItem	ReportItem
	DistListItem	SharingItem
	DocumentItem	TaskItem
	JournalItem	TaskRequestAcceptItem
	MailItem	TaskRequestDeclineItem
	MeetingItem	TaskRequestItem
	NoteItem	TaskRequestUpdateItem
	PostItem

Properties

Application	Returns an Application object that represents the parent Outlook application for the object. Read-only. (Inherited from _Category)
CategoryBorderColor	Returns an OLE_COLOR value that represents the border color of the color swatch displayed for a Category object. Read-only. (Inherited from _Category)
CategoryGradientBottomColor	Returns an OLE_COLOR value that represents the bottom gradient color of the color swatch displayed for a Category object. Read-only. (Inherited from _Category)
CategoryGradientTopColor	Returns an OLE_COLOR value that represents the top gradient color of the color swatch displayed for a Category object. Read-only. (Inherited from _Category)
CategoryID	Returns a String (string in C#) value that represents the unique identifier for the Category object. Read-only. (Inherited from _Category)
Class	Returns an OlObjectClass constant indicating the object's class. Read-only. (Inherited from _Category)
Color	Returns or sets an OlCategoryColor constant that indicates the color used by the Category object. Read/write. (Inherited from _Category)
Name	Returns or sets a String (string in C#) value that represents the display name for the object. Read/write. (Inherited from _Category)
Parent	Returns the parent Object of the specified object. Read-only. (Inherited from _Category)
Session	Returns the NameSpace object for the current session. Read-only. (Inherited from _Category)
ShortcutKey	Returns or sets an OlCategoryShortcutKey constant that specifies the shortcut key used by the Category object. Read/write. (Inherited from _Category)