TaskItems2.Add(String, String, String, vsTaskPriority, Object, Boolean, String, Int32, Boolean, Boolean) Methode

Definition

Fügt ein neues Aufgabenelement zur TaskList hinzu.

EnvDTE::TaskItem Add(std::wstring const & Category, std::wstring const & SubCategory, std::wstring const & Description, EnvDTE::vsTaskPriority Priority = EnvDTE.vsTaskPriority.vsTaskPriorityMedium, winrt::Windows::Foundation::IInspectable const & Icon, bool Checkable = false, std::wstring const & File = "", int Line = -1, bool CanUserDelete = true, bool FlushItem = true);
[System.Runtime.InteropServices.DispId(4)]
public EnvDTE.TaskItem Add (string Category, string SubCategory, string Description, EnvDTE.vsTaskPriority Priority = EnvDTE.vsTaskPriority.vsTaskPriorityMedium, object Icon, bool Checkable = false, string File = "", int Line = -1, bool CanUserDelete = true, bool FlushItem = true);
[<System.Runtime.InteropServices.DispId(4)>]
abstract member Add : string * string * string * EnvDTE.vsTaskPriority * obj * bool * string * int * bool * bool -> EnvDTE.TaskItem
Public Function Add (Category As String, SubCategory As String, Description As String, Optional Priority As vsTaskPriority = EnvDTE.vsTaskPriority.vsTaskPriorityMedium, Optional Icon As Object, Optional Checkable As Boolean = false, Optional File As String = "", Optional Line As Integer = -1, Optional CanUserDelete As Boolean = true, Optional FlushItem As Boolean = true) As TaskItem

Parameter

Category
String

Erforderlich. Stellt den Kategorienamen des Aufgabenelements dar.

SubCategory
String

Erforderlich. Stellt den Unterkategorienamen des Aufgabenelements dar.

Description
String

Erforderlich. Beschreibt das Aufgabenelement.

Priority
vsTaskPriority

(Optional) Eine- vsTaskPriority Konstante, die die Priorität des Aufgaben Elements bezeichnet: hoch, Mittel oder niedrig. Wenn der Wert ist vsTaskPriorityHigh , wird in der ersten Spalte des Aufgabenliste ein Ausrufezeichen Symbol angezeigt. Bei einem Wert von vsTaskPriorityMedium wird nichts angezeigt. Wenn der Wert gleich vsTaskPriorityLow ist. wird ein Pfeil nach unten angezeigt.

Icon
Object

(Optional) Bestimmt den Symboltyp, der das neue Aufgabenelement darstellt. Die Einstellung muss entweder vsTaskIcon oder ein IPictureDisp sein.

Checkable
Boolean

(Optional) Gibt an, ob das Aufgabenelement ein Kontrollkästchen enthalten soll, mit dem Benutzer angeben können, dass die Aufgabe abgeschlossen ist. Der Standardwert lautet false.

File
String

(Optional) Gibt die Datei oder den Pfad an, der dem neuen Aufgabenelement zugeordnet wird. Der Standardwert ist eine leere Zeichenfolge (""). Wenn dieser Wert verwendet wird. gibt IsSettable[vsTaskListColumn](vsTaskListColumnFile) den Wert false zurück. Der Dateiname kann ein vollständiger Pfad, ein relativer Pfad oder einfach ein Dateiname sein. Beim Zuordnen einer Datei oder eines Pfades zu einem Element wird nicht zwangsläufig eine Aktion ausgeführt.

Line
Int32

(Optional) Gibt die Zeile im Quellcode an, die dem neuen Aufgabenelement zugeordnet wird. Der Standardwert ist 0. Wenn dieser Wert verwendet wird. gibt IsSettable[vsTaskListColumn](vsTaskListColumnLine) den Wert false zurück. Beim Zuordnen einer Zeilennummer zu einem Element wird nicht zwangsläufig eine Aktion ausgeführt.

CanUserDelete
Boolean

(Optional) Gibt an, ob Benutzer das neue Aufgabenelement durch Drücken von ENTFERNEN löschen können, wenn das Element in der Umgebung ausgewählt ist. Der Standardwert lautet true.

FlushItem
Boolean

(Optional) Gibt an, ob ein neues Element sofort im Aufgabenliste sichtbar ist. Wenn FlushItem auf festgelegt ist true , wird der Aufgabenliste sofort nach dem Aufruf von aktualisiert Add . Wenn FlushItem auf festgelegt ist false , wird der Aufgabenliste später aktualisiert, nachdem alle Aktualisierungen vorgenommen wurden. Eine false Einstellung wird hauptsächlich verwendet, um die Leistung zu verbessern, wenn Sie der Aufgabenliste mehrere Elemente gleichzeitig hinzufügen. Der Standardwert lautet true.

Gibt zurück

TaskItem

Ein TaskItem-Objekt.

Implementiert

Attribute

Beispiele

Imports EnvDTE  
Imports EnvDTE80  
Sub TaskItems2Example(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.  
    TLItem = TLItems.Add(" ", " ", "Test task 1.", _  
     vsTaskPriority.vsTaskPriorityHigh, vsTaskIcon.vsTaskIconUser _  
    , True, , 10, , )  
     TLItem = TLItems.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: " & TLItems.Item(2).Description)  
    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 TaskItems2Example(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.Add("MyTask", "MyTask1", "Test task 1."  
, vsTaskPriority.vsTaskPriorityHigh, vsTaskIcon.vsTaskIconUser  
, true,null,10,true,true );  
    TLItem = TLItems.Add("MyTask", "MyTask1", "Test task 2."  
, vsTaskPriority.vsTaskPriorityLow, vsTaskIcon.vsTaskIconComment  
, true, null, 20, true, true);  
    // 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("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);  
}  

Hinweise

Beim Hinzufügen von Bitmaps ist die RGB-Farbe 0x0000ff00 (grün) transparent. Alle Orte in Ihrem Bild, die diesen Wert verwenden, sind transparent, und die Aufgabenliste wird über angezeigt.

Die Breite und Höhe von Bitmaps muss 16 x 16 Pixel betragen.

Wenn Sie verwenden IPictureDisp , muss das PICTYPE-Argument entweder auf oder festgelegt werden Icon Bitmap . Die Einstellungen von Metafiles , Uninitialized oder None funktionieren nicht ordnungsgemäß.

Gilt für