TaskItems2.Add2-Methode
Fügt der TaskList ein neues Aufgabenelement hinzu.
Namespace: EnvDTE80
Assembly: EnvDTE80 (in EnvDTE80.dll)
Syntax
'Declaration
Function Add2 ( _
Category As String, _
SubCategory As String, _
Description As String, _
Priority As Integer, _
Icon As Object, _
Checkable As Boolean, _
File As String, _
Line As Integer, _
CanUserDelete As Boolean, _
FlushItem As Boolean, _
AutoNavigate As Boolean _
) As TaskItem
TaskItem Add2(
string Category,
string SubCategory,
string Description,
int Priority,
Object Icon,
bool Checkable,
string File,
int Line,
bool CanUserDelete,
bool FlushItem,
bool AutoNavigate
)
TaskItem^ Add2(
[InAttribute] String^ Category,
[InAttribute] String^ SubCategory,
[InAttribute] String^ Description,
[InAttribute] int Priority,
[InAttribute] Object^ Icon,
[InAttribute] bool Checkable,
[InAttribute] String^ File,
[InAttribute] int Line,
[InAttribute] bool CanUserDelete,
[InAttribute] bool FlushItem,
[InAttribute] bool AutoNavigate
)
abstract Add2 :
Category:string *
SubCategory:string *
Description:string *
Priority:int *
Icon:Object *
Checkable:bool *
File:string *
Line:int *
CanUserDelete:bool *
FlushItem:bool *
AutoNavigate:bool -> TaskItem
function Add2(
Category : String,
SubCategory : String,
Description : String,
Priority : int,
Icon : Object,
Checkable : boolean,
File : String,
Line : int,
CanUserDelete : boolean,
FlushItem : boolean,
AutoNavigate : boolean
) : TaskItem
Parameter
- Category
Typ: System.String
Erforderlich.Stellt den Kategorienamen des neuen Aufgabenelements dar.
- SubCategory
Typ: System.String
Erforderlich.Stellt den Namen der Unterkategorie des Aufgabenelements dar.
- Description
Typ: System.String
Erforderlich.Beschreibt das Aufgabenelement.
- Priority
Typ: System.Int32
Optional.Eine vsTaskPriority-Konstante zeigt die Priorität des Aufgabenelements an: hoch, mittel oder niedrig.Wenn der Wert vsTaskPriorityHigh ist, wird in der ersten Spalte der Aufgabenliste ein Symbol mit Ausrufezeichen angezeigt.Wenn der Wert vsTaskPriorityMedium ist, wird kein besonderes Symbol angezeigt.Wenn der Wert vsTaskPriorityLow ist, wird ein Symbol mit einem Pfeil nach unten angezeigt.
- Icon
Typ: System.Object
Optional.Bestimmt den Symboltyp für das neue Aufgabenelement.Als Einstellung muss entweder vsTaskIcon oder IPictureDisp gewählt werden.
- Checkable
Typ: System.Boolean
Optional.Gibt an, ob zu dem Aufgabenelement ein Kontrollkästchen bereitgestellt wird, das der Benutzer bei Abschluss einer Aufgabe aktivieren kann.Der Standardwert ist false.
- File
Typ: System.String
Optional.Gibt die Datei bzw. den Pfad an, der dem neuen Aufgabenelement zugeordnet ist.Als Standardwert wird eine leere Zeichenfolge ("") verwendet. Bei leerer Zeichenfolge gibt IsSettable(vsTaskListColumnFile) den Wert false zurück.Der Dateiname kann als vollständiger Pfad, relativer Pfad oder einfacher Dateiname angegeben sein.Wenn Sie einem Element eine Datei oder einen Pfad zuordnen, werden dadurch noch nicht zwangsläufig Aktionen ausgelöst.
- Line
Typ: System.Int32
Optional.Gibt die Zeile im Quellcode zurück, der dem neuen Aufgabenelement zugeordnet ist.Als Standardwert wird 0 verwendet. Bei Verwendung von 0 gibt IsSettable(vsTaskListColumnLine) den Wert false zurück.Wenn Sie einem Element eine Zeilennummer zuordnen, werden dadurch noch nicht zwangsläufig Aktionen ausgelöst.
- CanUserDelete
Typ: System.Boolean
Optional.Zeigt an, ob ein Benutzer das neue Aufgabenelement mit der ENTF-TASTE löschen kann, wenn das Element in der Umgebung ausgewählt ist.Der Standardwert ist true.
- FlushItem
Typ: System.Boolean
Optional.Gibt an, ob ein neues Element in der Aufgabenliste sofort sichtbar ist.Wenn FlushItem auf true festgelegt ist, wird die Aufgabenliste sofort nach Aufruf von Add aktualisiert.Wenn FlushItem auf false festgelegt ist, wird die Aufgabenliste erst aktualisiert, nachdem alle anderen Aktualisierungen vorgenommen wurden. Die Festlegung false dient vorwiegend dazu, die Leistung zu verbessern, insbesondere wenn der Aufgabenliste eine große Anzahl von Elementen gleichzeitig hinzugefügt werden soll.Der Standardwert ist true.
- AutoNavigate
Typ: System.Boolean
Optional.Gibt an, ob das AutoNavigate-Feature für das TaskItem aktiviert wurde.Bei Aktivierung ist AutoNavigate auf true festgelegt, andernfalls auf false.
Rückgabewert
Typ: EnvDTE.TaskItem
Ein TaskItem-Objekt.
Hinweise
Beim Hinzufügen von Bitmaps wird die RGB-Farbe 0x0000FF00 (Grün) transparent dargestellt. Alle Bereiche im Bild, die diesen Wert aufweisen, werden durchsichtig angezeigt, sodass die Aufgabenliste durchscheint.
Die Breite und Höhe von Bitmaps muss 16 x 16 Pixel betragen.
Bei IPictureDisp muss das PICTYPE-Argument auf Icon oder Bitmap festgelegt werden. Die Einstellungen von Metafiles, Uninitialized oder None können nicht ordnungsgemäß ausgeführt werden.
Beispiele
In diesem Beispiel werden der Aufgabenliste mithilfe der Add2-Methode zwei Aufgabenelemente hinzugefügt, und einige der zugehörigen 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)
TaskItemsAdd2Example(_applicationObject)
End Sub
Sub TaskItemsAdd2Example(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("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;
TaskItems2Add2Example(_applicationObject);
}
public void TaskItems2Add2Example(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("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.