TaskItems2.Item(Object) TaskItems2.Item(Object) TaskItems2.Item(Object) TaskItems2.Item(Object) TaskItems2.Item(Object) TaskItems2.Item(Object) Method

Definition

Returns an indexed member of a TaskItems collection.

public:
 EnvDTE::TaskItem ^ Item(System::Object ^ index);
public:
 EnvDTE::TaskItem ^ Item(Platform::Object ^ index);
EnvDTE::TaskItem Item(winrt::Windows::Foundation::IInspectable const & index);
[System.Runtime.InteropServices.DispId(0)]
public EnvDTE.TaskItem Item (object index);
abstract member Item : obj -> EnvDTE.TaskItem
Public Function Item (index As Object) As TaskItem

Parameters

index
Object Object Object Object Object Object

Required. The index of the item to return.

Returns

Implements

Examples

Imports EnvDTE  
Imports EnvDTE80  
Sub TaskItems2ItemExample(ByVal dte As DTE2)  
    Dim win As Window = _  
     _applicationObject.Windows.Item(Constants.vsWindowKindTaskList)  
    Dim TL As TaskList = CType(win.Object, TaskList)  
    Dim TLItem As TaskItem  
    Dim TLItems As TaskItems2  
    TLItems = CType(TL.TaskItems, TaskItems2)  
    ' Add a couple of tasks to the Task List using Add2.  
    TLItem = TLItems.Add2(" ", " ", "Test task 1." _  
    , vsTaskPriority.vsTaskPriorityHigh,  _  
    vsTaskIcon.vsTaskIconUser, True, , 10, , , False)  
     TLItem = TLItems.Add2(" ", " ", "Test task 2." _  
    , vsTaskPriority.vsTaskPriorityLow, vsTaskIcon.vsTaskIconComment, _  
     , , 20, , , False)  
    ' List the total number of task list items after adding the new   
    ' task items.  
    MsgBox("Task Item 1 description: " & TLItems.Item(2).Description)  
    MsgBox("Task Item 2 category: "  _  
    & TLItems.Item(1).Category.ToString())  
    MsgBox("Total number of task items: " & TLItems.Count)  
    ' Remove the second task item.  
    ' The items list in reverse numeric order.  
    MsgBox("Deleting the second task item")  
    TLItems.Item(1).Delete()  
    MsgBox("Total number of task items: " & TLItems.Count)  
End Sub  
using EnvDTE;  
using EnvDTE80;  
using System.Windows.Forms;  
public void TaskItems2ItemExample(DTE2 dte)  
{  
    Window2 win =  
 (Window2)_applicationObject.Windows.Item  
(Constants.vsWindowKindTaskList);  
    TaskList TL = (TaskList)win.Object;  
    TaskItem TLItem;  
    TaskItems2 TLItems;  
    TLItems = (TaskItems2)TL.TaskItems;  
    // Add a couple of tasks to the Task List.  
    TLItem = TLItems.Add2("MyTask", "MyTask1", "Test task 1.",   
1, vsTaskIcon.vsTaskIconUser, true,null,10,true,true,true);  
    TLItem = TLItems.Add2("MyTask", "MyTask1", "Test task 2.",   
2, vsTaskIcon.vsTaskIconComment, true, null, 20, true, true,false);  
    // List the total number of task list items after adding the new  
    // task items.  
    MessageBox.Show("Task Item 1 description: "   
+ TLItems.Item(2).Description);  
    MessageBox.Show("Task Item 2 category: "   
+ TLItems.Item(1).Category.ToString());  
    MessageBox.Show("Total number of task items: "   
+ TLItems.Count.ToString());  
    // Remove the second task item.  
    // The items list in reverse numeric order.  
    MessageBox.Show("Deleting the second task item");  
    TLItems.Item(1).Delete();  
    MessageBox.Show("Total number of task items: " + TLItems.Count);  
}  

Remarks

The value passed to Index is an integer that is an index to an object in its collection. For many objects, though, the value of Index can also be a string value that equates to an object in the collection. The exact value that is accepted by Item, though, depends upon the collection and its implementation.

The Item method throws a ArgumentException exception if the collection cannot find the object that corresponds to the index value.

Applies to