TaskItems2.Add(String, String, String, vsTaskPriority, Object, Boolean, String, Int32, Boolean, Boolean) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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äß.