TaskItem Interface

The TaskItem object represents a task item in the Task List window.

Namespace:  EnvDTE
Assembly:  EnvDTE (in EnvDTE.dll)

Syntax

'Declaration
<GuidAttribute("58E4D419-6B8C-4C63-92DE-70161CD95890")> _
Public Interface TaskItem
[GuidAttribute("58E4D419-6B8C-4C63-92DE-70161CD95890")]
public interface TaskItem
[GuidAttribute(L"58E4D419-6B8C-4C63-92DE-70161CD95890")]
public interface class TaskItem
[<GuidAttribute("58E4D419-6B8C-4C63-92DE-70161CD95890")>]
type TaskItem =  interface end
public interface TaskItem

The TaskItem type exposes the following members.

Properties

  Name Description
Public property Category Gets a string representing the category of the task item.
Public property Checked Sets or gets whether a task item in the Task List window has a check in the check box column.
Public property Collection Returns the collection containing the TaskItem object supporting this property.
Public property Description Sets or gets a string that represents the description for the TaskItem object.
Public property Displayed Gets whether the task item is currently visible in the Task List window.
Public property DTE Gets the top-level extensibility object.
Public property FileName Sets or gets a string representing the file name that was passed to the Task List window when the task item was created.
Public property IsSettable Returns whether a given column of a task item can be edited.
Public property Line Sets or gets the line number of the TaskItem object.
Public property Priority Sets or gets a constant that indicates the priority of the task item.
Public property SubCategory Gets a string representing the task item's subcategory.

Top

Methods

  Name Description
Public method Delete Removes the task item from the collection.
Public method Navigate Requests that the task item navigate to its location and display it, if that is meaningful to the task.
Public method Select Causes this item to become active in the integrated development environment (IDE).

Top

Examples

In the following example, the tasks appear in the Add-ins and Macros category of the Task List.

[Visual Basic]

Sub TaskItemExample()
   Dim win As Window = DTE.Windows.Item(Constants.vsWindowKindTaskList)
   Dim TL As TaskList = win.Object
   Dim TLItem As TaskItem

   ' Add a couple of tasks to the Task List.
   TLItem = TL.TaskItems.Add(" ", " ", "Test task 1.", vsTaskPriority.vsTaskPriorityHigh, vsTaskIcon.vsTaskIconUser, True, , 10, , )
   TLItem = TL.TaskItems.Add(" ", " ", "Test task 2.", vsTaskPriority.vsTaskPriorityLow, vsTaskIcon.vsTaskIconComment, , 20, , )

   ' List the total number of task list items after adding the new 
   ' task items.
   MsgBox("Task Item 1 description: " & TL.TaskItems.Item(2).Description)
   MsgBox("Total number of task items: " & TL.TaskItems.Count)

   ' Remove the second task item. The items list in reverse numeric order.
   MsgBox("Deleting the second task item")
   TL.TaskItems.Item(1).Delete()
   MsgBox("Total number of task items: " & TL.TaskItems.Count)
End Sub

See Also

Reference

EnvDTE Namespace