This documentation is archived and is not being maintained.


Specifies the category of a task item.

Namespace:  Microsoft.VisualStudio.Shell.Interop
Assembly:  Microsoft.VisualStudio.Shell.Interop (in Microsoft.VisualStudio.Shell.Interop.dll)


Member nameDescription
CAT_ALLNot a real category. It is used to allow a task list view to show all of the tasks in the task list.
CAT_BUILDCOMPILEBuild errors and warnings, and possibly deployment errors. Goes to the same view as CAT_CODESENSE.
CAT_COMMENTSTasks generated by special comments, such as "TODO," "UNDONE," or "HACK."
CAT_CODESENSEErrors generated as you type source code. Goes to the same view as CAT_BUILDCOMPILE.
CAT_SHORTCUTSShort cuts to code. Shortcuts are generated by the user right-clicking the editor window, and choosing Add Task List Shortcut from the pop-up menu. Users should be encouraged to use short cuts rather than bookmarks to mark positions in the editor window.
CAT_USERTasks entered by the user. The top of the task list, above its first item, is set up to allow users to easily add their own tasks to the task list.
CAT_MISCMiscellaneous tasks that VSPackages might want to add to the task list.
CAT_HTMLTasks which pertain to Web page development.

A task list view consists of a filter and a sort. The filter determines which tasks and which of the fields of VSTASKFIELD are allowed to show in the view; the sort determines the order in which the tasks are shown. When the sort is performed upon FLD_CATEGORY of VSTASKFIELD, the enumerations of VSTASKCATEGORY are used to determine the sort order. Any custom categories that were created by using the RegisterCustomCategory method will also be included when determining the sort on categories.

Only one category of VSTASKCATEGORY can be shown in a task list view; the only way to show more than one category in a view is to use CAT_ALL, which shows all categories.

The AutoFilter and AutoFilter2 methods of IVsTaskList can be used to change the view of the task list.

COM Signature

From vsshell.idl: