TaskItems2.Add(String, String, String, vsTaskPriority, Object, Boolean, String, Int32, Boolean, Boolean) Método

Definição

Adiciona um novo item de tarefa ao TaskList .

EnvDTE::TaskItem Add(std::wstring const & Category, std::wstring const & SubCategory, std::wstring const & Description, EnvDTE::vsTaskPriority Priority = EnvDTE.vsTaskPriority.vsTaskPriorityMedium, winrt::Windows::Foundation::IInspectable const & Icon, bool Checkable = false, std::wstring const & File = "", int Line = -1, bool CanUserDelete = true, bool FlushItem = true);
[System.Runtime.InteropServices.DispId(4)]
public EnvDTE.TaskItem Add (string Category, string SubCategory, string Description, EnvDTE.vsTaskPriority Priority = EnvDTE.vsTaskPriority.vsTaskPriorityMedium, object Icon, bool Checkable = false, string File = "", int Line = -1, bool CanUserDelete = true, bool FlushItem = true);
[<System.Runtime.InteropServices.DispId(4)>]
abstract member Add : string * string * string * EnvDTE.vsTaskPriority * obj * bool * string * int * bool * bool -> EnvDTE.TaskItem
Public Function Add (Category As String, SubCategory As String, Description As String, Optional Priority As vsTaskPriority = EnvDTE.vsTaskPriority.vsTaskPriorityMedium, Optional Icon As Object, Optional Checkable As Boolean = false, Optional File As String = "", Optional Line As Integer = -1, Optional CanUserDelete As Boolean = true, Optional FlushItem As Boolean = true) As TaskItem

Parâmetros

Category
String

Obrigatórios. Representa o nome da categoria do item de tarefa.

SubCategory
String

Obrigatórios. Representa o nome da subcategoria do item de tarefa.

Description
String

Obrigatórios. Descreve o item de tarefa.

Priority
vsTaskPriority

Opcional. Uma vsTaskPriority constante que indica a prioridade do item de tarefa: alta, média ou baixa. Se o valor for vsTaskPriorityHigh , um ícone de ponto de exclamação será exibido na primeira coluna da lista de tarefas. Se o valor for vsTaskPriorityMedium , nada será exibido. Se o valor for vsTaskPriorityLow , será exibido um ícone de seta para baixo.

Icon
Object

Opcional. Determina o tipo de ícone que representa o novo item de tarefa. A configuração deve ser vsTaskIcon um ou um IPictureDisp .

Checkable
Boolean

Opcional. Indica se você deseja ou não que o item de tarefa forneça uma caixa de seleção que os usuários possam verificar para indicar que a tarefa foi concluída. O valor padrão é false.

File
String

Opcional. Indica o arquivo ou caminho associado ao novo item de tarefa. O valor padrão é uma cadeia de caracteres vazia ("") e, se for usado, IsSettable[vsTaskListColumn] ( vsTaskListColumnFile ) retornará false . O nome do arquivo pode ser um caminho completo, um caminho relativo ou simplesmente um nome de arquivo. Observe que a associação de um arquivo ou caminho a um item não significa necessariamente que ele executa qualquer ação.

Line
Int32

Opcional. Indica a linha no código-fonte associado ao novo item de tarefa. O valor padrão é 0 e, se for usado, IsSettable[vsTaskListColumn] ( vsTaskListColumnLine ) retornará false . Observe que a associação de um número de linha a um item não significa necessariamente que ele executa qualquer ação.

CanUserDelete
Boolean

Opcional. Indica se um usuário pode excluir o novo item de tarefa pressionando DELETE quando o item é selecionado no ambiente. O valor padrão é true.

FlushItem
Boolean

Opcional. Indica se um novo item está visível imediatamente no lista de tarefas. Quando FlushItem é definido como true , o lista de tarefas é atualizado imediatamente após Add ser chamado. Quando FlushItem é definido como false , o lista de tarefas é atualizado posteriormente depois que todas as atualizações são feitas. Uma false configuração é usada principalmente para melhorar o desempenho quando você está adicionando vários itens por vez ao lista de tarefas. O valor padrão é true.

Retornos

TaskItem

Um objeto TaskItem.

Implementações

Atributos

Exemplos

Imports EnvDTE  
Imports EnvDTE80  
Sub TaskItems2Example(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.  
    TLItem = TLItems.Add(" ", " ", "Test task 1.", _  
     vsTaskPriority.vsTaskPriorityHigh, vsTaskIcon.vsTaskIconUser _  
    , True, , 10, , )  
     TLItem = TLItems.Add(" ", " ", "Test task 2." _  
    , vsTaskPriority.vsTaskPriorityLow, vsTaskIcon.vsTaskIconComment _  
    , , , 20, , )  
    ' 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 TaskItems2Example(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.Add("MyTask", "MyTask1", "Test task 1."  
, vsTaskPriority.vsTaskPriorityHigh, vsTaskIcon.vsTaskIconUser  
, true,null,10,true,true );  
    TLItem = TLItems.Add("MyTask", "MyTask1", "Test task 2."  
, vsTaskPriority.vsTaskPriorityLow, vsTaskIcon.vsTaskIconComment  
, true, null, 20, true, true);  
    // 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);  
}  

Comentários

Ao adicionar bitmaps, a cor RGB 0x0000FF00 (verde) é transparente. Todos os locais em sua imagem que usam esse valor são transparentes e o lista de tarefas mostra.

A largura e a altura dos bitmaps devem ter 16 x 16 pixels.

Se estiver usando IPictureDisp , o argumento PICTYPE deverá ser definido como Icon ou Bitmap . As configurações de Metafiles , Uninitialized ou None não funcionam corretamente.

Aplica-se a