TaskItems.Add – metoda

Článek
10/27/2012

Přidá nový úkol na TaskList.

Obor názvů: EnvDTE
Sestavení: EnvDTE (v EnvDTE.dll)

Syntaxe

'Deklarace
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: System.String
Povinné.Představuje název kategorie položky úkolu.

SubCategory
Typ: System.String
Povinné.Představuje název podkategorie položka úkolu.

Description
Typ: System.String
Povinné.Popisuje položku úkolu.

Priority
Typ: EnvDTE.vsTaskPriority
Nepovinné.A vsTaskPriority konstanta označuje prioritu úkol (vysoká, střední nebo nízké).Pokud je hodnota vsTaskPriorityHigh, zobrazí se ikona vykřičníku v prvním sloupci seznamu úkolů.Pokud je hodnota vsTaskPriorityMedium, nic se nezobrazí.Pokud je hodnota vsTaskPriorityLow, šipka dolů je zobrazena ikona.

Icon
Typ: System.Object
Nepovinné.Určuje typ ikonu představující nový úkol.Nastavení musí být buď vsTaskIcon nebo IPictureDisp.

Checkable
Typ: System.Boolean
Nepovinné.Označuje, zda chcete úkol poskytovat checkbox, který mohou uživatelé provádět kontrolu označuje, že úkol je dokončen.Výchozí hodnota je false.

File
Typ: System.String
Nepovinné.Označuje soubor nebo cesta přidružená nový úkol.Výchozí hodnota je prázdný řetězec (""), a pokud je použit, IsSettable(vsTaskListColumnFile) vrací false.Může být název souboru, úplná cesta a název relativní cesty pouze název souboru.Všimněte si, že přidružení souboru nebo cesty k položce nemusí nutně znamenat, že jej bude provádět žádné akce.

Line
Typ: System.Int32
Nepovinné.Označuje řádek ve zdrojovém kódu přidružené nový úkol.Výchozí hodnota je 0, a pokud je použit, IsSettable(vsTaskListColumnLine) vrací false.Všimněte si, že přidružení číslo řádku položky nemusí nutně znamenat, že jej bude provádět žádné akce.

CanUserDelete
Typ: System.Boolean
Nepovinné.Označuje, zda uživatel může odstranit stisknutím klávesy DELETE vybrána položka prostředí nový úkol.Výchozí hodnota je true.

FlushItem
Typ: System.Boolean
Nepovinné.Označuje, zda je nová položka v bezprostředně viditelné Seznam úkolů.Při FlushItem je nastavena na True, seznam úkolů je aktualizován ihned po přidání se nazývá.Při FlushItem je nastavena na false, seznam úkolů je aktualizován nejpozději po provedení všech aktualizací.A false nastavení slouží především k vylepšení výkonu při přidávání velký počet položek v čase do seznamu úkolů.Výchozí hodnota je true.

Vrácená hodnota

Typ: EnvDTE.TaskItem
Objekt TaskItem.

Poznámky

Při přidávání bitmapy je transparentní barva RGB 0x0000FF00 (zelená).Všechna místa obrázku, které používají tuto hodnotu budou průhledné a Seznam úkolů bude prosvítat.

Šířka a výška bitmapy musí být 16 x 16 pixelů.

Používáte-li IPictureDisp, PICTYPE argument musí být nastaven buď Icon nebo Bitmap.Nastavení buď Metafiles, Uninitialized, nebo None nebudou pracovat správně.

Příklady

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

TaskItems Rozhraní

EnvDTE – obor názvů

Sdílet prostřednictvím