TaskItems2.Item-Methode

Artikel
05/16/2015

Gibt einen indizierten Member einer TaskItems-Auflistung zurück.

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

Syntax

'Declaration
Function Item ( _
    index As Object _
) As TaskItem

TaskItem Item(
    Object index
)

TaskItem^ Item(
    [InAttribute] Object^ index
)

abstract Item : 
        index:Object -> TaskItem

function Item(
    index : Object
) : TaskItem

Parameter

index
Typ: Object

Erforderlich. Der Index des zurückzugebenden Elements.

Rückgabewert

Typ: TaskItem
Ein TaskItem-Objekt.

Hinweise

Der an Index übergebene Wert ist eine ganze Zahl, die ein Index für ein Objekt in dessen Auflistung ist. Bei vielen Objekten kann es sich bei dem Wert von Index aber auch um einen Zeichenfolgewert handeln, der einem Objekt in der Auflistung entspricht. Der genaue von Item akzeptierte Wert hängt jedoch von der Auflistung und deren Implementierung ab.

Die Item-Methode löst eine ArgumentException-Ausnahme aus, wenn die Auflistung das dem Indexwert entsprechende Objekt nicht finden kann.

Beispiele

In diesem Beispiel werden der Aufgabenliste zwei Aufgabenelemente hinzugefügt, und einige der zugehörigen, für Item spezifischen Eigenschaften werden in Meldungsfenstern angezeigt. Weitere Informationen zum Ausführen dieses Beispiels als Add-In finden Sie unter Gewusst wie: Kompilieren und Ausführen der Codebeispiele für das Automatisierungsobjektmodell.

Imports EnvDTE
Imports EnvDTE80
Public Sub OnConnection(ByVal application As Object, _
 ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object, _
 ByRef custom As Array) Implements IDTExtensibility2.OnConnection
    _applicationObject = CType(application, DTE2)
    _addInInstance = CType(addInInst, AddIn)
    TaskItems2ItemExample(_applicationObject)
End Sub
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 OnConnection(object application, 
ext_ConnectMode connectMode, object addInInst, ref Array custom)
{
    _applicationObject = (DTE2)application;
    _addInInstance = (AddIn)addInInst;
    TaskItemsItemExample(_applicationObject);
}
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);
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

TaskItems2 Schnittstelle

EnvDTE80-Namespace

Freigeben über