How to: Controlar a Lista de Tarefas

O Lista de tarefas e seu conteúdo pode ser controlado por meio de automação. Ela é representada na Visual Studio o modelo de automação pelos objetos a seguir e coleção.

Nome do objeto	Descrição
TaskListobjeto	Representa o lista de tarefas.
TaskItemscoleção	Representa todas as tarefas de A lista de tarefas.
TaskItemobjeto	Representa um item de tarefa único na Lista de tarefas.
TaskListEventsobjeto	Permite que você responda a eventos que ocorrem na Lista de tarefas.

Usando esses objetos e coleções, você pode:

• Criar um item de tarefa e adicioná-lo para o Lista de tarefas (Add método) ou excluí-lo do Lista de tarefas (Delete método).

• Obter itens no momento o Lista de tarefas (Select método).

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

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

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

Para além de controlar o conteúdo do Lista de tarefas, você também pode controlar suas características, como, por exemplo, largura e altura. Para obter mais informações, consulte How to: Alterar Características da janela.

Observação

As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritos na Ajuda, dependendo das configurações ativas ou configurações de edição. Esses procedimentos foram desenvolvidos com o General Development Settings ativo. Para alterar as configurações, escolha importação e Exportar configurações sobre o Ferramentas menu. Para obter mais informações, consulte Trabalhando com configurações.

Exemplo

O exemplo a seguir suplemento demonstra como referência e usar os vários membros de na Lista de tarefas o modelo de automação. Este exemplo adiciona novas tarefas para o Lista de tarefas, lista o número de tarefas e, em seguida, exclui uma tarefa. Antes de executar o exemplo a seguir, selecione Lista de tarefas da Exibir menu. As tarefas aparecem na Addin suplementos e Macros categoria.

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

How to: Alterar Características da janela

How to: Criar um Adicionar-

Walkthrough: Criando um assistente

Referência

Lista de Tarefas (Visual Studio)

Conceitos

Automation Object Model Chart

Outros recursos

Criar e controlar o ambiente Windows

Criação de assistentes e ins Adicionar-

Automation and Extensibility Reference