Personalizar a barra de rolagem

Ao trabalhar com arquivos de código longos, pode ser difícil manter o controle de onde tudo está no arquivo. É possível personalizar a barra de rolagem do editor de código para ter um panorama geral do que está acontecendo no código.

Anotações

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

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

  2. Selecione Mostrar anotações sobre a 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

    Dica

    A opção Exibir marcas inclui pontos de interrupção e indicadores.

Experimente abrir um arquivo de código grande e substituir algumas partes do texto que ocorrem em vários locais no arquivo. A barra de rolagem mostra o efeito das substituições, de modo que você pode desfazer suas alterações se tiver substituído algo que não deveria.

Esta é a aparência da barra de rolagem após o usuário pesquisar por uma cadeia de caracteres. Observe que todas as instâncias da cadeia de caracteres são exibidas na barra de rolagem.

Visual Studio scroll bar after searching for a string

Esta é a barra de rolagem após a substituição de todas as instâncias da cadeia de caracteres. As marcas vermelhas na barra de rolagem mostram em que local a substituição de texto introduziu erros.

Visual Studio scroll bar after replacing a string with errors

Tabela de anotações

Curioso para saber quais anotações da barra de rolagem e suas cores associadas correspondem a quais ações? Confira 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.

Arquivos rastreados (em um repositório Git)

Color Anotação padrão Status Nome das configurações
Verde Screenshot of the default annotation in scroll bar that indicates a tracked addition that's saved. Não salvo Acompanhar adições em arquivos sob controle do código-fonte
Verde Screenshot of the default annotation in scroll bar that indicates a tracked addition that's unsaved. Salvo Acompanhar adições em arquivos sob controle do código-fonte
Vermelho Screenshot of the default annotation in scroll bar that indicates a tracked deletion. Excluído Acompanhar exclusões em arquivos sob controle do código-fonte
Azul Screenshot of the default annotation in scroll bar that indicates a tracked modification that's unsaved. Não salvo Acompanhar modificações em arquivos sob controle do código-fonte
Azul Screenshot of the default annotation in scroll bar that indicates a tracked modification that's saved. Salvo Acompanhar modificações em arquivos sob controle do código-fonte

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

Color Anotação padrão Status Nome das configurações
Ouro Screenshot of the default annotation in scroll bar that indicates change in a file before it's saved. Não salvo Acompanhar alterações em arquivos antes de salvá-los
Verde Screenshot of the default annotation in scroll bar that indicates a change in a file after it's saved. Salvo Acompanhar alterações em arquivos após salvá-los
Azul Screenshot of the default annotation in scroll bar that indicates a reverted change in a file. Revertida Acompanhar alterações revertidas em arquivos

Marks

As marcas são anotadas na seção intermediária da barra de rolagem vertical.

Color Anotação padrão Nome das configurações
Cinza escuro Screenshot of the default annotation in scroll bar that indicates a bookmark in a file. Indicador
Amarelo Screenshot of the default annotation in scroll bar that indicates a find match status. Localizar correspondência
Vermelho escuro Screenshot of the default annotation in scroll bar that indicates a breakpoint in a file. Ponto de interrupção
Cinza claro Screenshot of the default annotation in scroll bar that indicates a selection match in a file. Correspondência de seleção
Azul Screenshot of the default annotation in scroll bar that indicates a view definition mark in a file. Exibir definição

Erro, Aviso, Informações ou Sugestão

Erros, Avisos, Informações e Sugestões são anotados no lado direito da barra de rolagem vertical.

Color Anotação padrão Nome das configurações
Vermelho Screenshot of the default annotation in scroll bar that indicates a syntax error in a file. Erro de sintaxe
Verde Screenshot of the default annotation in scroll bar that indicates a warning in a file. Aviso
Azul Screenshot of the default annotation in scroll bar that indicates information in a file. Informações
Cinza claro Screenshot of the default annotation in scroll bar that indicates a suggestion in a file. Reticências de sugestão (…)

Posição do cursor

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

Color Anotação padrão Nome das configurações
Azul-escuro Screenshot of the default annotation in scroll bar that indicates an overview caret in a file. Visão geral do cursor

Modos de exibição

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

Modo de barra

O 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 pula para esse local no arquivo.

Modo de mapa

O modo de mapa exibe linhas de código, em miniatura, na barra de rolagem. É possível escolher a largura da coluna do mapa selecionando um valor em Visão geral do Código-fonte. Para habilitar uma visualização maior do código quando você parar o ponteiro no mapa, selecione a opção Mostrar Dica de Ferramenta de Visualização. As regiões recolhidas ficam sombreadas de forma diferente e são expandidas quando você clica duas vezes nelas.

Dica

Você pode desabilitar a exibição de código em miniatura no modo de mapa definindo a opção Visão geral do código-fonte como Desabilitada. Se a opção Mostrar Dica de Ferramenta de Visualização estiver selecionada, você ainda verá uma visualização do código nesse local ao passar o ponteiro do mouse sobre a barra de rolagem e, o cursor ainda o levará para esse local no arquivo quando você clicar.

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

Visual Studio scroll bar in map mode

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

Visual Studio scroll bar with a tooltip

Dica

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