Gewusst wie: Steuern der Aufgabenliste

Die Aufgabenliste und ihr Inhalt können durch Automatisierung gesteuert werden. Die Aufgabenliste wird im Automatisierungsmodell von Visual Studio durch die folgenden Objekte und Auflistungen dargestellt:

Objektname	Beschreibung
TaskList-Objekt	Stellt die Aufgabenliste dar.
TaskItems-Auflistung	Stellt alle Aufgaben in der Aufgabenliste dar.
TaskItem-Objekt	Stellt ein einzelnes Aufgabenelement der Aufgabenliste dar.
TaskListEvents-Objekt	Bietet die Möglichkeit, auf Ereignisse zu reagieren, die in der Aufgabenliste auftreten.

Mithilfe dieser Objekte und Auflistungen können Sie folgende Aufgaben ausführen:

• Ein Aufgabenelement erstellen und der Aufgabenliste hinzufügen (Add-Methode) oder aus der Aufgabenliste löschen (Delete-Methode).

• Elemente aus der Aufgabenliste abrufen (Select-Methode).

• Ein Dokument anzeigen, das mit einem Aufgabenelement verknüpft ist (Navigate-Methode).

• Ein Aufgabenelement auswählen (Select-Methode).

• Reagieren, wenn ein Aufgabenelement hinzugefügt, entfernt, geändert oder ausgewählt wird (Ereignisse TaskAdded, TaskRemoved, TaskModified und TaskNavigated).

Außer den Inhalten der Aufgabenliste können auch deren Merkmale, z. B. Breite und Höhe, gesteuert werden. Weitere Informationen finden Sie unter Gewusst wie: Ändern des Erscheinungsbilds eines Fensters.

Tipp

Je nach den aktiven Einstellungen oder der Version unterscheiden sich die Dialogfelder und Menübefehle auf Ihrem Bildschirm möglicherweise von den in der Hilfe beschriebenen. Bei der Entwicklung dieser Verfahren war die Option Allgemeine Entwicklungseinstellungen aktiviert. Wählen Sie im Menü Extras die Option Einstellungen importieren und exportieren aus, um die Einstellungen zu ändern. Weitere Informationen finden Sie unter Arbeiten mit Einstellungen.

Beispiel

Im folgenden Add-In-Beispiel wird veranschaulicht, wie die verschiedenen Member des Automatisierungsmodells der Aufgabenliste verwendet werden und wie auf sie verwiesen wird. In diesem Beispiel werden der Aufgabenliste neue Aufgaben hinzugefügt, wird die Anzahl der Aufgaben aufgelistet und anschließend eine Aufgabe gelöscht. Wählen Sie vor dem Ausführen des folgenden Beispiels im Menü Ansicht die Option Aufgabenliste aus. Die Aufgaben werden in der Kategorie Add-Ins und Makros angezeigt.

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)
    ' Pass the applicationObject member variable to the code example.
    TaskListExample(_applicationObject)
End Sub

Sub TaskListExample(ByVal dte As DTE2)
    Dim tl As TaskList = dte.ToolWindows.TaskList
    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(2).Delete()
    MsgBox("Total number of task items: " & tl.TaskItems.Count)
End Sub

using System.Windows.Forms;
public void OnConnection(object application, ext_ConnectMode   
connectMode, object addInInst, ref Array custom)
{
    _applicationObject = (DTE2)application;
    _addInInstance = (AddIn)addInInst;
    // Pass the applicationObject member variable to the code example.
    TaskListExample(_applicationObject);
}

public void TaskListExample(DTE2 dte)
{
    TaskList tl = (TaskList)dte.ToolWindows.TaskList;
    TaskItem tlItem;
    
    // Add a couple of tasks to the Task List.
    tlItem = tl.TaskItems.Add(" ", " ", "Test task 1.",  
      vsTaskPriority.vsTaskPriorityHigh, vsTaskIcon.vsTaskIconUser, 
      true, "", 10, true, true);
    tlItem = tl.TaskItems.Add(" ", " ", "Test task 2.", 
      vsTaskPriority.vsTaskPriorityLow, vsTaskIcon.vsTaskIconComment, 
      true, "", 20, true,true);

    // List the total number of task list items after adding the new 
    // task items.
    System.Windows.Forms.MessageBox.Show("Task Item 1 description: 
      "+tl.TaskItems.Item(2).Description);
    System.Windows.Forms.MessageBox.Show("Total number of task items: 
      "+tl.TaskItems.Count);

    // Remove the second task item. The items list in reverse numeric 
    // order.
    System.Windows.Forms.MessageBox.Show("Deleting the second task 
      item");
    tl.TaskItems.Item(2).Delete();
    System.Windows.Forms.MessageBox.Show("Total number of task items: 
      "+tl.TaskItems.Count);
}

Siehe auch

Aufgaben

Gewusst wie: Ändern des Erscheinungsbilds eines Fensters

Gewusst wie: Erstellen von Add-Ins

Exemplarische Vorgehensweise: Erstellen eines Assistenten

Referenz

Aufgabenliste (Visual Studio)

Konzepte

Diagramm "Automationsobjektmodell"

Weitere Ressourcen

Erstellen und Steuern von Umgebungsfenstern

Erstellen von Add-Ins und Assistenten

Referenz zur Automatisierung und Erweiterbarkeit