Usar a Lista de Tarefas com comentários e atalhos de código

A ferramenta Lista de Tarefas no Visual Studio permite que você acompanhe comentários de código que usam tokens como TODO e HACK ou tokens personalizados. Você também pode usar esse recurso para gerenciar atalhos de tarefas que o levam diretamente a um local predefinido no código. Por padrão, a Lista de Tarefas é aberta na parte inferior da janela do aplicativo no IDE (Ambiente de Desenvolvimento Interativo) do Visual Studio:

Captura de tela da janela Lista de Tarefas na parte inferior da janela do aplicativo no Visual Studio.

Se você não vir a janela Lista de Tarefas, selecione Exibir>Lista de Tarefas ou use o atalho de teclado Ctrl+\,T. Como outras janelas de recursos no IDE do Visual Studio, você pode mover a janela Lista de Tarefas para qualquer local na superfície do IDE.

Usar tokens predefinidos

O Visual Studio prepara o conteúdo da Lista de Tarefas examinando seu código em busca de marcadores de comentários e tokens. Vários tokens predefinidos estão disponíveis para programas C/C++, C# e Visual Basic: HACK, TODO, UNDONE e UnresolvedMergeConflict. Esses rótulos de token não diferenciam maiúsculas de minúsculas.

O Visual Studio reconhece um comentário quando ele consiste em três componentes:

  • O marcador de comentário, como //, #, <!--

  • O prefixo do token de comentário, como TODO, hack, MoveToHeader

  • O texto do comentário que segue o token

Aqui está um exemplo de um comentário de código em C#:

// TODO: Load state from previously suspended application

Quando o Visual Studio reconhece um token predefinido, ele exibe o texto do comentário como uma tarefa na Lista de Tarefas.

Criar tokens personalizados

Você pode criar tokens personalizados para qualquer linguagem de programação seguindo estas etapas:

  1. No menu Ferramentas do Visual Studio, selecione Opções.

  2. Expanda a seção Ambiente e selecione a guia Lista de Tarefas. A página de opções da Lista de Tarefas é aberta:

    Captura de tela que mostra como adicionar tokens para a Lista de Tarefas no Visual Studio, incluindo tokens predefinidos e personalizados.

  3. Na caixa de texto Nome, insira o nome do token personalizado, como Otimizar.

  4. Expanda a lista suspensa Prioridade e selecione uma prioridade padrão para o token personalizado.

  5. Para adicionar o token personalizado à lista de tokens, selecione Adicionar.

  6. Para aplicar as alterações, selecione OK.

Quando o Visual Studio reconhece um token personalizado, ele exibe o texto do comentário como uma tarefa na Lista de Tarefas.

Adicionar atalhos de tarefa de código

Um atalho de tarefa de código é um indicador que você adiciona ao código que o Visual Studio rastreia na Lista de Tarefas. Esse tipo de atalho tem um ícone diferente de um indicador normal.

  1. Para criar um atalho de tarefa de código, insira o ponteiro no código no local em que deseja colocar um atalho.

  2. Selecione Editar>Indicadores>Adicionar Atalho da Lista de Tarefas ou use o atalho do teclado Ctrl+K, Ctrl+H.

    Captura de tela que mostra como adicionar um indicador para criar um atalho de tarefa de código na Lista de Tarefas.

Usar tarefas e atalhos para acessar o código

Depois que o Visual Studio atualizar a Lista de Tarefas com suas instâncias de token de comentário de código e atalhos de tarefa de código, você poderá usar esses itens para ir rapidamente para os locais vinculados em seu código:

  1. Para ir até o local em seu código para qualquer tarefa, clique duas vezes no item de tarefa na Lista de Tarefas.

  2. Para ir até o local do código da tarefa anterior ou seguinte na lista, clique com o botão direito do mouse na tarefa atual na lista e selecione Próxima Tarefa ou Tarefa Anterior. Essas ações também estão disponíveis no menu Exibir do Visual Studio.

Classificar itens da lista

Você pode alterar a ordem de classificação dos itens da lista:

  1. Para alterar a ordem de classificação primária da lista, selecione um cabeçalho de coluna. O Visual Studio classifica o conteúdo da lista de acordo com os itens na coluna selecionada.

  2. Para aplicar uma ordem de classificação secundária, selecione Deslocar e um cabeçalho de coluna diferente. O Visual Studio classifica o conteúdo da lista pela primeira coluna selecionada seguida pela segunda coluna selecionada.

Você pode continuar essa abordagem e aplicar uma classificação mais refinada selecionando Deslocar e outro cabeçalho de coluna.

Mostrar, ocultar e ordenar colunas

Você também pode trabalhar com colunas específicas na lista:

  1. Para mostrar uma coluna, clique com o botão direito do mouse em qualquer lugar da lista e selecione Mostrar Colunas. No submenu, selecione as colunas a serem mostradas. As seguintes colunas estão disponíveis: Prioridade, Descrição, Projeto, Classificação do Projeto, Caminho, Arquivo, Linha e Coluna.

    • No submenu, o Visual Studio exibe uma marca de seleção ao lado de uma coluna visível.

    • Para ocultar uma coluna, desmarque o nome da coluna no submenu. O Visual Studio remove a marca de seleção.

  2. Para alterar a ordem das colunas na lista, arraste os cabeçalhos das colunas até a posição desejada.

Dica

A coluna Classificação do Projeto representa as dependências do projeto. Projetos com uma classificação de 1 não dependem de nenhum outro projeto. Projetos com uma classificação de 2 dependem de um ou mais projetos com uma classificação de 1 e assim por diante. Para obter mais informações, confira Definições padrão de colunas de tabela: campo classificação do projeto.