Método TaskItems.Add

Adiciona um novo item de tarefa para o TaskList.

Namespace:  EnvDTE
Assembly:  EnvDTE (em EnvDTE.dll)

Sintaxe

'Declaração
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

Parâmetros

• Category
  Tipo: String

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

• SubCategory
  Tipo: String

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

• Description
  Tipo: String

  Obrigatório. Descreve o item de tarefa.

• Priority
  Tipo: EnvDTE.vsTaskPriority

  Opcional. A vsTaskPriority constante que indica a prioridade do item de tarefa (alto, médio ou baixo). 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 é exibido. Se o valor for vsTaskPriorityLow, uma seta para baixo o ícone é exibido.

• Icon
  Tipo: Object

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

• Checkable
  Tipo: Boolean

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

• File
  Tipo: String

  Opcional. Indica o arquivo ou caminho associados com o novo item de tarefa. O valor padrão é uma seqüência vazia (""), e se isso for usado, IsSettable(vsTaskListColumnFile) retorna false. O nome do arquivo pode ser um nome de caminho completo, um nome de caminho relativo ou simplesmente um nome de arquivo. Observe que a associação de um arquivo ou caminho com um item não significa necessariamente que executará qualquer ação.

• Line
  Tipo: Int32

  Opcional. Indica a linha no código fonte associada com o novo item de tarefa. O valor padrão é 0, e se isso for usado, IsSettable(vsTaskListColumnLine) retorna false. Observe que a associar a um item de um número de linha não significa necessariamente que executará qualquer ação.

• CanUserDelete
  Tipo: 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
  Tipo: Boolean

  Opcional. Indica se um novo item é imediatamente visível no Lista de tarefas. Quando FlushItem for definido como True, a lista de tarefas é atualizada imediatamente depois de adicionar é chamado. Quando FlushItem for definido como false, a lista de tarefas é atualizada mais tarde, depois de todas as atualizações são feitas. A false configuração é usada principalmente para melhorar o desempenho quando você está adicionando um grande número de itens em um horário à lista de tarefas. O valor padrão é true.

Valor de retorno

Tipo: EnvDTE.TaskItem
A TaskItem object.

Comentários

Ao adicionar bitmaps, a cor RGB 0x0000FF00 (verde) é transparente. Todos os lugares na sua figura que usam esse valor será transparentes e o Lista de tarefas ficará visível através dela.

A largura e altura de bitmaps devem ser 16 x 16 pixels.

Se usando IPictureDisp, o PICTYPE argumento deve ser definido de qualquer Icon ou Bitmap. As configurações de um Metafiles, Uninitialized, ou None não funcionará corretamente.

Exemplos

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

Segurança do .NET Framework

• Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

TaskItems Interface

Namespace EnvDTE