Partilhar via


Exibir e editar código usando Peek Definition (Alt+F12)

Você pode usar o comando Peek Definition para exibir e editar código sem se afastar do código que está escrevendo. Peek Definition e Go To Definition mostram as mesmas informações, mas Peek Definition mostra em uma janela pop-up e Go To Definition mostra o código em uma janela de código separada. Ir para definição faz com que seu contexto (ou seja, a janela de código ativo, a linha atual e a posição do cursor) alterne para a janela de código de definição. Usando Peek Definition, você pode visualizar e editar a definição e mover-se dentro do arquivo de definição, mantendo seu lugar no arquivo de código original.

Você pode usar Peek Definition com código C#, Visual Basic e C++. No Visual Basic, Peek Definition mostra um link para o Pesquisador de Objetos para símbolos que não têm metadados de definição (por exemplo, tipos .NET internos). Alguns idiomas e tipos de arquivo podem não suportar Peek Definition; por exemplo, arquivos CSS.

Usar definição de espiada

Abrir uma janela Peek Definition

  1. Você pode espreitar uma definição escolhendo Espreitar Definição no menu de contexto para um tipo ou membro que você deseja explorar. Se a opção estiver ativada, você também pode espiar uma definição usando o mouse, pressionando Ctrl (ou outro modificador) e clicando no nome do membro. Ou, a partir do teclado, prima Alt+F12.

    Esta ilustração mostra a janela Peek Definition para um método chamado Print():

    Janela de Espreitar

    A janela de definição aparece abaixo da linha printer.Print("Hello World!") no arquivo original. A janela não oculta nenhum código no ficheiro original. As linhas que se seguem a printer.Print("Hello World!") aparecem debaixo da janela de definição.

  2. Você pode mover o cursor para diferentes locais na janela de definição rápida. Você também pode navegar na janela de código original.

  3. Você pode copiar uma cadeia de caracteres da janela de definição e colá-la no código original. Você também pode arrastar e soltar a cadeia de caracteres da janela de definição para o código original sem excluí-la da janela de definição.

  4. Você pode fechar a janela de definição escolhendo a tecla Esc ou o botão Fechar na guia da janela de definição.

Abrir uma janela "Peek Definition" de dentro de uma janela "Peek Definition"

Se já tiver uma janela Peek Definition aberta, poderá chamar Peek Definition novamente no código dessa janela. Abre-se outra janela de definição. Um conjunto de migalhas aparece ao lado do separador da janela de definição, que pode ser usado para navegar entre as janelas de definição. A dica de ferramenta em cada ponto mostra o nome do arquivo e o caminho do arquivo de definição que o ponto representa.

Janela de espreitar dentro de uma janela de espreitar

Visualização de definição com vários resultados

Se utilizar Peek Definition no código que tem mais de uma definição (por exemplo, uma classe parcial), uma lista de resultados aparecerá à direita da vista de definição de código. Você pode escolher qualquer resultado na lista para exibir sua definição.

Janela de vista para múltiplos resultados

Editar dentro da janela Peek Definition

Quando começa a editar dentro de uma janela Peek Definition, o ficheiro que está a modificar abre automaticamente como um separador no editor de código e reflete as alterações que foram feitas. Você pode continuar a fazer, desfazer e salvar alterações na janela Peek Definition e a guia continuará a refletir essas alterações. Mesmo que feches a janela Definição de Espreitar sem guardar as alterações, podes fazer, desfazer e guardar mais alterações no separador, retomando exatamente de onde paraste na janela Definição de Espreitar.

Editando dentro de uma janela de visualização

Para alterar as opções de Definição de Visualização

  1. Abra o painelOpções de> e expanda a seção Todas as Configurações>Editor de Texto>Geral.

  2. Marque a caixa de seleção Ativar o clique do mouse para usar Ir para definição.

  3. Marque a caixa de seleção Abrir definição no modo de exibição de visualização .

    Captura de tela que mostra como definir a opção de definição de espiada com o botão do mouse no Visual Studio.

  1. Abra a caixa de diálogo Ferramentas>Opções e expanda a secção Editor de Texto>Geral.

  2. Marque a caixa de seleção Ativar clique do rato para realizar Ir para a Definição.

  3. Marque a caixa de seleção Abrir definição em modo de visualização e, em seguida, selecione OK.

    Captura de ecrã que mostra como definir a opção de visualização rápida através do clique do rato.

Atalhos de teclado para Peek Definition

Pode utilizar estes atalhos de teclado com a janela Peek Definição:

Funcionalidade Atalho de teclado
Abrir a janela de definição Alt+F12
Fechar a janela de definição Esc
Promover a janela de definição para um separador de documento normal Ctrl+Alt+Início
Navegar entre janelas de definição Ctrl+Alt+- e Ctrl+Alt+=
Navegar entre vários resultados F8 e Shift+F8
Alternar entre a janela do editor de código e a janela de definição Turno+Esc

Observação

Você também pode usar os mesmos atalhos de teclado para editar código em uma janela Peek Definition tal como usa em outros lugares no Visual Studio.