Metoda TaskItems.Add —

Dodaje nowy element zadania, aby TaskList.

Przestrzeń nazw:  EnvDTE
Zestaw:  EnvDTE (w EnvDTE.dll)

Składnia

'Deklaracja
Function Add ( _
    Category As String, _
    SubCategory As String, _
    Description As String, _
    Priority As vsTaskPriority, _
    Icon As Object, _
    Checkable As Boolean, _
    File As String, _
    Line As Integer, _
    CanUserDelete As Boolean, _
    FlushItem As Boolean _
) As TaskItem

TaskItem Add(
    string Category,
    string SubCategory,
    string Description,
    vsTaskPriority Priority,
    Object Icon,
    bool Checkable,
    string File,
    int Line,
    bool CanUserDelete,
    bool FlushItem
)

TaskItem^ Add(
    [InAttribute] String^ Category, 
    [InAttribute] String^ SubCategory, 
    [InAttribute] String^ Description, 
    [InAttribute] vsTaskPriority Priority, 
    [InAttribute] Object^ Icon, 
    [InAttribute] bool Checkable, 
    [InAttribute] String^ File, 
    [InAttribute] int Line, 
    [InAttribute] bool CanUserDelete, 
    [InAttribute] bool FlushItem
)

abstract Add : 
        Category:string * 
        SubCategory:string * 
        Description:string * 
        Priority:vsTaskPriority * 
        Icon:Object * 
        Checkable:bool * 
        File:string * 
        Line:int * 
        CanUserDelete:bool * 
        FlushItem:bool -> TaskItem

function Add(
    Category : String, 
    SubCategory : String, 
    Description : String, 
    Priority : vsTaskPriority, 
    Icon : Object, 
    Checkable : boolean, 
    File : String, 
    Line : int, 
    CanUserDelete : boolean, 
    FlushItem : boolean
) : TaskItem

Parametry

• Category
  Typ: String

  Wymagane.Reprezentuje nazwę kategorii w elemencie zadania.

• SubCategory
  Typ: String

  Wymagane.Reprezentuje nazwę podkategorii elementu zadania.

• Description
  Typ: String

  Wymagane.Zawiera opis elementu zadania.

• Priority
  Typ: EnvDTE.vsTaskPriority

  Opcjonalne.A vsTaskPriority stałą oznaczający priorytet elementu zadania (wysoki, średni lub niski).Jeśli wartość jest vsTaskPriorityHigh, w pierwszej kolumnie listy zadań wyświetlana jest ikona wykrzyknika.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: Object

  Opcjonalne.Określa typ ikonę przedstawiającą element nowego zadania.To ustawienie musi być albo vsTaskIcon lub IPictureDisp.

• Checkable
  Typ: Boolean

  Opcjonalne.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: String

  Opcjonalne.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ć nazwą pełną ścieżkę, nazwę ścieżki względnej lub po prostu nazwy pliku.Należy zauważyć, że skojarzenie pliku lub ścieżkę z elementu nie musi oznaczać będzie wykonywać żadnych akcji.

• Line
  Typ: Int32

  Opcjonalne.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 niekoniecznie oznacza, że będzie wykonywać żadnych akcji.

• CanUserDelete
  Typ: Boolean

  Opcjonalne.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: Boolean

  Opcjonalne.Wskazuje, czy nowy element jest natychmiast widoczne w Listy zadań.Gdy FlushItem jest ustawiona na True, na liście zadań jest aktualizowany natychmiast po nosi nazwę dodatku.Gdy FlushItem jest ustawiona na false, na liście 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 do listy zadań.Wartością domyślną jest true.

Wartość zwracana

Typ: EnvDTE.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 będzie przezroczysty i Listy zadań będzie 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 albo Metafiles, Uninitialized, lub None nie będzie działać poprawnie.

Przykłady

Sub TaskItemsAddExample1()
   Dim win As Window = DTE.Windows.Item(Constants.vsWindowKindTaskList)
   Dim TL As TaskList = win.Object
   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, _
   "c:\temp.txt", 10, , )
   TLItem = TL.TaskItems.Add(" ", " ", "Test task 2.", _
   vsTaskPriority.vsTaskPriorityLow, vsTaskIcon.vsTaskIconComment, _
   False, "c:\temp2.txt", 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(1).Delete()
   MsgBox("Total number of task items: " & TL.TaskItems.Count)
End Sub

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.

Zobacz też

Informacje

TaskItems Interfejs

Przestrzeń nazw EnvDTE