Como controlar a Lista de Tarefas

Os suplementos do Visual Studio foram substituídos no Visual Studio 2013. Você deve atualizar seus suplementos para as extensões VSPackage. Para obter mais informações sobre atualização, consulte Perguntas frequentes: convertendo suplementos em extensões VSPackage.

A Lista de Tarefas e seu conteúdo podem ser controlados usando automação. É representada no modelo de automação do Visual Studio pelos seguintes objetos e coleção.

Nome do objeto	Descrição
Objeto TaskList	Representa a Lista de Tarefas.
Coleção TaskItems	Representa todas as tarefas na Lista de Tarefas.
Objeto TaskItem	Representa um único item de tarefa na Lista de Tarefas.
Objeto TaskListEvents	Permite a resposta de eventos que ocorrem na Lista de Tarefas.

Usando esses objetos e coleções, será possível:

• Crie um item de tarefa e adicione-o à Lista de Tarefas (método deAdd ) ou exclua-o da Lista de Tarefas (método deDelete).

• Obtenha itens que estejam atualmente na Lista de Tarefas (método Select ).

• Exibir um documento associado a um item de tarefa (método deNavigate).

• Selecionar um item de tarefa (método Select).

• Responder quando um item de tarefa é adicionado, removido, modificado ou selecionado (TaskAdded, TaskRemoved, TaskModified e eventos TaskNavigated.)

Além de controlar o conteúdo da Lista de tarefas, você também pode controlar suas características, como largura e altura. Para obter mais informações, consulte Como alterar características da janela.

Dica

As caixas de diálogo e os comandos de menu que você vê podem diferir das descritas no Help dependendo de suas configurações ativas ou de edição.Esses procedimentos foram desenvolvidos com as Configurações Gerais de Desenvolvimento ativas.Para alterar as configurações, escolha Importar e ExportarConfigurações no menu de Ferramentas.Para obter mais informações, consulte Personalizando configurações de desenvolvimento no Visual Studio.

Exemplo

O exemplo a seguir do suplemento demonstra como referenciar e usar vários membros do modelo de automação da Lista de Tarefas. Esse exemplo adiciona novas tarefas à Lista de Tarefas, lista o número de tarefas e exclui uma tarefa. Antes de executar o exemplo a seguir, selecione Lista de Tarefas do menu Modo de exibição. As tarefas aparecem na categoria Suplementos e Macros.

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)
    ' Pass the applicationObject member variable to the code example.
    TaskListExample(_applicationObject)
End Sub

Sub TaskListExample(ByVal dte As DTE2)
    Dim tl As TaskList = dte.ToolWindows.TaskList
    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, , 10, , )
    tlItem = tl.TaskItems.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: " & _
      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(2).Delete()
    MsgBox("Total number of task items: " & tl.TaskItems.Count)
End Sub

using System.Windows.Forms;
public void OnConnection(object application, ext_ConnectMode   
connectMode, object addInInst, ref Array custom)
{
    _applicationObject = (DTE2)application;
    _addInInstance = (AddIn)addInInst;
    // Pass the applicationObject member variable to the code example.
    TaskListExample(_applicationObject);
}

public void TaskListExample(DTE2 dte)
{
    TaskList tl = (TaskList)dte.ToolWindows.TaskList;
    TaskItem tlItem;
    
    // Add a couple of tasks to the Task List.
    tlItem = tl.TaskItems.Add(" ", " ", "Test task 1.",  
      vsTaskPriority.vsTaskPriorityHigh, vsTaskIcon.vsTaskIconUser, 
      true, "", 10, true, true);
    tlItem = tl.TaskItems.Add(" ", " ", "Test task 2.", 
      vsTaskPriority.vsTaskPriorityLow, vsTaskIcon.vsTaskIconComment, 
      true, "", 20, true,true);

    // List the total number of task list items after adding the new 
    // task items.
    System.Windows.Forms.MessageBox.Show("Task Item 1 description: 
      "+tl.TaskItems.Item(2).Description);
    System.Windows.Forms.MessageBox.Show("Total number of task items: 
      "+tl.TaskItems.Count);

    // Remove the second task item. The items list in reverse numeric 
    // order.
    System.Windows.Forms.MessageBox.Show("Deleting the second task 
      item");
    tl.TaskItems.Item(2).Delete();
    System.Windows.Forms.MessageBox.Show("Total number of task items: 
      "+tl.TaskItems.Count);
}

Consulte também

Tarefas

Como alterar características da janela

Como criar um suplemento

Instruções passo a passo: criando um assistente

Referência

<Pave Over> Lista de tarefas (Visual Studio)

Conceitos

Gráfico do modelo de objetos automation

Outros recursos

Criando e controlando janelas de ambiente

Criando suplementos e assistentes

Referência sobre automação e extensibilidade