Sdílet prostřednictvím

TaskItems2.Add2 – metoda

  • Článek

Přidá nový úkol na TaskList.

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

Syntaxe

'Deklarace
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: String

    Povinné.Představuje název kategorie položky úkolu.

  • SubCategory
    Typ: String

    Povinné.Představuje název podkategorie položka úkolu.

  • Description
    Typ: String

    Povinné.Popisuje položku úkolu.

  • Priority
    Typ: Int32

    Nepovinné.A vsTaskPriority konstanta označuje prioritu úkolu zboží: vysoká, střední nebo Nízká.Pokud je hodnota vsTaskPriorityHigh, v prvním sloupci je zobrazena ikona vykřičníku Seznam úkolů.Pokud je hodnota vsTaskPriorityMedium, nic se nezobrazí.Pokud je hodnota vsTaskPriorityLow, šipka dolů je zobrazena ikona.

  • Icon
    Typ: Object

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

  • Checkable
    Typ: 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: 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, relativní cesta nebo jednoduše název souboru.Všimněte si, že přidružení souboru nebo cesty k položce neznamená nezbytně provádí všechny akce.

  • Line
    Typ: 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 neznamená nezbytně provádí všechny akce.

  • CanUserDelete
    Typ: 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: 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 Add se nazývá.Při FlushItem je nastavena na false, Seznam úkolů novější aktualizaci po provedení všech aktualizací.A false nastavení se používá především pro zvýšení výkonu při přidávání tak velké množství položek Seznam úkolů.Výchozí hodnota je true.

  • AutoNavigate
    Typ: Boolean

    Nepovinné.Označuje, zda TaskItem byla povolena funkce AutoNavigate.AutoNavigate je na při nastavení této true; jinak false.

Vrácená hodnota

Typ: 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 jsou průhledné a Seznam úkolů vidět.

Šíř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í Metafiles, Uninitialized, nebo None nepracují správně.

Příklady

Tento příklad přidá dvě položky do seznamu úkolů úkolů pomocí Add2 metoda a některé jejich vlastnosti zobrazí v polích zprávy.Další informace o tom, jak spustit jako doplněk příklad viz Postupy: Kompilace a spuštění příkladů kódu objektu automatizace.

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);
}

Zabezpečení rozhraní .NET Framework

Viz také

Referenční dokumentace

TaskItems2 Rozhraní

EnvDTE80 – obor názvů