Metoda TaskItems2.Add2 —
Dodaje nowy element zadania, aby TaskList.
Przestrzeń nazw: EnvDTE80
Zestaw: EnvDTE80 (w EnvDTE80.dll)
Składnia
'Deklaracja
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
Parametry
Category
Typ: StringWymagane.Reprezentuje nazwę kategorii w elemencie zadania.
SubCategory
Typ: StringWymagane.Reprezentuje nazwę podkategorii elementu zadania.
Description
Typ: StringWymagane.Zawiera opis elementu zadania.
Priority
Typ: Int32Opcjonalne.A vsTaskPriority stałą oznaczający priorytet elementu zadania: wysoki, średni lub niski.Jeśli wartość jest vsTaskPriorityHigh, w pierwszej kolumnie wyświetlana jest ikona wykrzyknika Listy zadań.Jeśli wartość jest vsTaskPriorityMedium, nic nie jest wyświetlane.Jeśli wartość jest vsTaskPriorityLow, Strzałka w dół jest wyświetlana ikona.
Icon
Typ: ObjectOpcjonalne.Określa typ ikonę przedstawiającą element nowego zadania.To ustawienie musi być albo vsTaskIcon lub IPictureDisp.
Checkable
Typ: BooleanOpcjonalne.Wskazuje, czy nie ma elementu zadania, aby zapewnić checkbox, że użytkownicy mogą sprawdzać, aby wskazać, że zadanie zostało wykonane.Wartością domyślną jest false.
File
Typ: StringOpcjonalne.Wskazuje plik lub ścieżkę skojarzoną z nowego elementu zadania.Wartością domyślną jest ciąg pusty (""), i jeśli jest używany, IsSettable(vsTaskListColumnFile) zwraca false.Nazwa pliku może być pełną ścieżkę, ścieżkę względną lub po prostu nazwy pliku.Należy zauważyć, że skojarzenie pliku lub ścieżkę z elementu niekoniecznie oznacza wykonuje żadnych akcji.
Line
Typ: Int32Opcjonalne.Wskazuje wiersz kodu źródłowego, skojarzone z elementem nowego zadania.Wartością domyślną jest 0, i jeśli jest używany, IsSettable(vsTaskListColumnLine) zwraca false.Należy zauważyć, że skojarzenie numer wiersza z elementu nie musi oznaczać, wykonuje żadnych akcji.
CanUserDelete
Typ: BooleanOpcjonalne.Wskazuje, czy użytkownik może usunąć nowy element zadania przez naciśnięcie klawisza DELETE, gdy element jest zaznaczony w środowisku.Wartością domyślną jest true.
FlushItem
Typ: BooleanOpcjonalne.Wskazuje, czy nowy element jest natychmiast widoczne w Listy zadań.Podczas FlushItem jest ustawiona na true, Listy zadań jest zaktualizowane natychmiast po Add jest wywoływana.Gdy FlushItem jest ustawiona na false, Listy zadań jest aktualizowany później, po dokonaniu wszystkich aktualizacji.A false ustawienie jest używane głównie w celu zwiększenia wydajności podczas dodawania wielu elementów jednocześnie, Listy zadań.Wartością domyślną jest true.
AutoNavigate
Typ: BooleanOpcjonalne.Wskazuje, czy TaskItem ma włączoną funkcją AutoNavigate.AutoNavigate jest na, gdy jest ustawiony na true; w przeciwnym razie false.
Wartość zwracana
Typ: TaskItem
A TaskItem object.
Uwagi
Podczas dodawania mapy bitowe, kolor RGB 0x0000FF00 (zielony) jest przezroczysty.Wszystkie miejsca obrazu, które za pomocą tej wartości są przejrzyste i Listy zadań widoczne.
Szerokość i wysokość bitmapy musi być 16 x 16 pikseli.
Jeśli za pomocą IPictureDisp, PICTYPE argument musi być ustawiona do albo Icon lub Bitmap.Ustawienia Metafiles, Uninitialized, lub None nie działają poprawnie.
Przykłady
W tym przykładzie dodaje elementy do listy zadań dwóch zadań za pomocą Add2 metody i wyświetla niektóre ich właściwości w polach komunikatu.Aby uzyskać więcej informacji o sposobach uruchamiania w tym przykładzie jako dodatek, zobacz Porady: kompilowanie i uruchamianie kodu modelu obiektów automatyzacji — przykłady.
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);
}
Zabezpieczenia programu .NET Framework
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.