Partilhar via


Personalizar a barra de rolagem

Quando você está trabalhando com arquivos de código longos, pode ser difícil manter o controle de onde tudo está no arquivo. Você pode personalizar a barra de rolagem do editor de código para fornecer uma imagem geral do que está acontecendo em seu código.

Anotações

Você pode selecionar se a barra de rolagem mostra anotações, como alterações de código, pontos de interrupção, marcadores, erros e posição do cursor.

  1. Abra a página das Barras de rolagem escolhendo Ferramentas>, Opções>, Editor de Texto>, Todos os Idiomas>, Barras de Rolagem.

  2. Selecione Mostrar anotações na barra de rolagem vertical e selecione as anotações que deseja ver. As anotações disponíveis são:

    • alterações
    • marcas
    • erros
    • Posição do cursor

    Sugestão

    A opção Mostrar marcas inclui pontos de interrupção e marcadores.

Experimente abrindo um arquivo de código grande e substituindo algum texto que ocorre em vários lugares no arquivo. A barra de rolagem mostra o efeito das substituições, para que você possa recuar suas alterações se tiver substituído algo que não deveria ter.

Veja como a barra de rolagem fica após uma pesquisa por uma cadeia de caracteres. Observe que todas as instâncias da cadeia de caracteres aparecem na barra de rolagem.

Barra de rolagem do Visual Studio depois de procurar uma cadeia de caracteres

Aqui está a barra de rolagem depois de substituir todas as instâncias da cadeia de caracteres. As marcas vermelhas na barra de rolagem mostram onde a substituição de texto introduziu erros.

Barra de rolagem do Visual Studio após substituir uma cadeia de caracteres com erros

Tabela de anotações

Curioso para saber quais anotações da barra de rolagem e suas cores associadas correspondem a quais ações? Consulte as tabelas a seguir para obter detalhes.

Alterações de código

As alterações de código são anotadas no lado esquerdo da barra de rolagem vertical. Para modificar a configuração Controlar alterações, vá para Ferramentas>Opções>Editor de Texto>Configurações.

Arquivos rastreados (em um repositório Git)

Cor Anotação padrão Situação Nome das configurações
Verde Imagem de ecrã da anotação predefinida na barra de rolagem que indica uma adição registada que foi salva. Não guardado Rastreie adições em arquivos sob controle do código-fonte
Verde Captura de ecrã da anotação predefinida na barra de rolagem que indica uma adição monitorizada não guardada. Guardado Rastreie adições em arquivos sob controle do código-fonte
Vermelho Captura de tela da anotação padrão na barra de rolagem que indica uma exclusão controlada. Suprimido Rastreie exclusões em arquivos sob controle do código-fonte
Azul Captura de tela da anotação padrão na barra de rolagem que indica uma modificação controlada que não foi salva. Não guardado Controlar modificações em arquivos sob controle do código-fonte
Azul Captura de ecrã da anotação padrão na barra de rolagem que indica uma modificação controlada que foi guardada. Guardado Controlar modificações em arquivos sob controle do código-fonte

Arquivos não rastreados (não em um repositório Git)

Cor Anotação padrão Situação Nome das configurações
Ouro Captura de tela da anotação padrão na barra de rolagem que indica a alteração em um arquivo antes de ser salvo. Não guardado Controlar alterações em arquivos antes de salvar
Verde Captura de tela da anotação padrão na barra de rolagem que indica uma alteração em um arquivo depois que ele é salvo. Guardado Controlar alterações em arquivos após salvar
Azul Captura de tela da anotação padrão na barra de rolagem que indica uma alteração revertida em um arquivo. Revertida Rastrear alterações revertidas em ficheiros

Marcas

As marcas são anotadas na seção do meio da barra de rolagem vertical.

Cor Anotação padrão Nome das configurações
Cinzento escuro Captura de tela da anotação padrão na barra de rolagem que indica um marcador em um arquivo. Marcador
Amarelo Captura de ecrã da anotação predefinida na barra de deslocamento que indica um estado de correspondência de localização. Encontrar correspondência
Vermelho escuro Captura de tela da anotação padrão na barra de rolagem que indica um ponto de interrupção em um arquivo. Ponto de interrupção
Cinzento claro Captura de tela da anotação padrão na barra de rolagem que indica uma correspondência de seleção em um arquivo. Jogo de seleção
Azul Captura de tela da anotação padrão na barra de rolagem que indica uma marca de definição de exibição em um arquivo. Ver definição

Erro, aviso, informação ou sugestão

Erros, avisos, informações e sugestões são anotados no lado direito da barra de rolagem vertical.

Cor Anotação padrão Nome das configurações
Vermelho Captura de tela da anotação padrão na barra de rolagem que indica um erro de sintaxe em um arquivo. Erro de sintaxe
Verde Captura de tela da anotação padrão na barra de rolagem que indica um aviso em um arquivo. Advertência
Azul Captura de tela da anotação padrão na barra de rolagem que indica informações em um arquivo. Informação
Cinzento claro Captura de tela da anotação padrão na barra de rolagem que indica uma sugestão em um arquivo. Sugestão de elipses (...)

Posição do Cursor

A posição do cursor também é anotada no extremo direito da barra de rolagem vertical.

Cor Anotação padrão Nome das configurações
Azul escuro Captura de ecrã da anotação padrão na barra de deslocamento que indica um marcador de resumo em um ficheiro. Cursor de visão geral

Modos de exibição

A barra de rolagem tem dois modos: modo de barra e modo de mapa.

Modo de barra

modo de barra exibe indicadores de anotação na barra de rolagem. Clicar na barra de rolagem rola a página para cima ou para baixo, mas não salta para esse local no arquivo.

Modo de mapa

O modo Mapa exibe linhas de código, em miniatura, na barra de rolagem. Você pode escolher a largura da coluna do mapa selecionando um valor na Visão geral da fonte. Para habilitar uma visualização maior do código quando você posicionar o ponteiro no mapa, selecione a opção Mostrar de dica de ferramenta de visualização. As regiões recolhidas são sombreadas de forma diferente e expandem-se quando faz duplo clique nelas.

Sugestão

Você pode desativar a visualização de código em miniatura no modo de mapa definindo de visão geral do código-fonte como Desativado. Se Mostrar dica de ferramenta de visualização estiver selecionada, você ainda verá uma visualização do código nesse local quando passar o ponteiro do mouse na barra de rolagem, e o cursor ainda salta para esse local no arquivo quando você clica.

A imagem a seguir mostra o exemplo de pesquisa quando o modo de mapa está ativado e a largura está definida como Média:

Barra de rolagem do Visual Studio no modo de mapa

A imagem a seguir mostra a opção Mostrar dica de visualização de ferramenta:

Barra de rolagem do Visual Studio com uma dica de ferramenta

Sugestão

Para alterar as cores que vê no modo de mapa, escolha Ferramentas>Opções>Ambiente>Fontes e Cores. Em seguida, em Exibir itens, escolha qualquer um dos itens precedidos de "Visão geral", faça as alterações de cor desejadas e escolha OK.