Partilhar via

Alterar assinatura

O quê: Permite modificar os parâmetros de uma função.

Quando: Você deseja reordenar, adicionar, remover ou modificar os parâmetros de uma função que são usados em vários locais.

Porquê: Você mesmo pode alterar manualmente esses parâmetros e, em seguida, encontrar todas as chamadas para essa função e alterá-las uma a uma, mas isso pode levar a erros. Esta ferramenta de refatoração executará a tarefa automaticamente.

Como:

  1. Coloque o texto ou o cursor do mouse dentro do nome do método a ser modificado ou de um de seus usos:

    Captura de tela do código com o cursor do mouse na função ChangeUserInfo.

  2. Em seguida, siga um destes procedimentos:

    • Teclado
      • Prima Ctrl+R e, em seguida, Ctrl+O. (Seu atalho de teclado pode ser diferente dependendo do perfil selecionado.)
      • Pressione Ctrl+. para acionar o menu Ações Rápidas e Refatorações e selecione Alterar Assinatura no menu de contexto.
    • Rato
      • Selecione Editar > Refatorar > Reordenar Parâmetros.
      • Clique com o botão direito do mouse no código, selecione o menu Ações rápidas e refatorações e selecione Alterar assinatura no menu de contexto.

  3. Na caixa de diálogo Alterar assinatura que aparece, você pode usar os botões do lado direito para alterar a assinatura do método:

    Captura de ecrã da caixa de diálogo Alterar Assinatura para a função ChangeName(). Os parâmetros são listados por nome, tipo e valor associado, se houver.

    Botão Descrição
    Sobe/Desce Mover o parâmetro selecionado para cima e para baixo na lista
    Adicionar Adicionar um novo parâmetro à lista
    Remover Remover o parâmetro selecionado da lista
    Modificar Modifique o parâmetro selecionado alterando seu tipo, nome, se é opcional e qual seria seu valor injetado
    Reverter Restaurar o parâmetro selecionado seu estado original
    Reverter tudo Restaurar todos os parâmetros para o seu estado original

    Sugestão

    Use a caixa de seleção Ignorar as alterações de referência na visualização se todas as referências forem confirmadas para fazer as alterações imediatamente, sem que a janela de visualização apareça antes.

    Ao adicionar ou modificar um parâmetro, você verá a janela Adicionar parâmetro ou Editar parâmetro .

    Captura de tela da janela Adicionar parâmetro onde você pode editar ou definir o tipo, o nome e se é padrão ou opcional de um parâmetro.

    Aqui, você pode fazer o seguinte:

    Entrada Descrição
    Tipo O tipo do parâmetro (int, double, float, etc.)
    Nome O nome do parâmetro
    Parâmetro opcional Tornar o parâmetro opcionalmente especificado
    Valor injetado O valor inserido em quaisquer chamadas para a função onde o parâmetro não é especificado (válido apenas para Add)
    Valor predefinido O valor usado pela função se o chamador não especificar um (válido apenas para parâmetros opcionais)

  4. Use a lista suspensa Escopo de pesquisa para selecionar se as alterações serão aplicadas ao projeto ou a toda a solução.

  5. Quando terminar, pressione o botão OK para fazer as alterações. Certifique-se de que as alterações que você está solicitando estão sendo feitas adequadamente. Use as caixas de seleção na metade superior da janela para habilitar ou desabilitar a renomeação de qualquer item.

    Captura de ecrã de uma pré-visualização de Alterar Assinatura. Em todos os lugares onde a função é chamada é visualizada para que você possa verificar cada alteração.

  6. Quando tudo estiver bem, clique no botão Aplicar e a função será alterada no seu código-fonte.

    Captura de ecrã da alteração resultante. Os parâmetros para ChangeUserInfo() são agora: std::string lastName, std::string firstname, int age = -1).

  • Last updated on