Compartir vía

Cambiar firma

  • Artículo

Qué: Permite modificar los parámetros de una función.

Cuándo: desea reordenar, agregar, quitar o modificar los parámetros de una función que se usan en varias ubicaciones.

Por qué: Podría cambiar el orden de estos parámetros manualmente y, después, buscar todas las llamadas a esa función y cambiarlas una por una, pero esto podría provocar errores. Esta herramienta de refactorización realizará la tarea automáticamente.

Cómo:

  1. Coloque el cursor del ratón o texto en el nombre del método que se va a modificar, o bien uno de sus usos:

    Captura de pantalla del código con el cursor del mouse en la función ChangeUserInfo.

  2. A continuación, realice alguno de los siguientes procedimientos:

    • Teclado
      • Presione Ctrl+R y después Ctrl+O. (El método abreviado de teclado puede variar en función del perfil que se haya seleccionado).
      • Presione Ctrl+. para desencadenar el menú Acciones rápidas y refactorizaciones, y seleccione Cambiar firma en el menú contextual.
    • Mouse
      • Seleccione Editar > Refactorizar > Reordenar parámetros.
      • Haga clic con el botón derecho en el código, seleccione el menú Acciones rápidas y refactorizaciones y elija Cambiar firma en el menú contextual.

  3. En el cuadro de diálogo Cambiar firma que aparece, puede usar los botones a la derecha para cambiar la firma del método:

    Captura de pantalla del cuadro de diálogo Cambiar firma para la función ChangeName(). Los parámetros se enumeran por nombre, tipo y valor asociado, si existe.

    Botón Descripción
    Up/Down Mueve el parámetro seleccionado hacia arriba y hacia abajo en la lista.
    Add Agrega un parámetro nuevo a la lista
    Remove Quita el parámetro seleccionado de la lista.
    Modificar Modifica el parámetro seleccionado, cambiando su tipo, nombre y si es opcional, y cuál debería ser su valor insertado
    Revertir Restaura el parámetro seleccionado a su estado original.
    Revertir todo Restaura todos los parámetros a su estado original.

    Sugerencia

    Use la casilla Omitir la vista previa de los cambios de referencia si todas las referencias están confirmadas, para realizar los cambios de manera inmediata sin que primero se abra la ventana de vista previa.

    Al agregar o modificar un parámetro, verá la ventana Agregar parámetro o Editar parámetro.

    Captura de pantalla de la ventana Agregar parámetro donde puede editar o establecer el tipo, el nombre de un parámetro y si su valor predeterminado o opcional.

    Aquí, puede realizar lo siguiente:

    Entrada Descripción
    Type El tipo del parámetro (int, double, float, etc.)
    Nombre El nombre del parámetro.
    Parámetro opcional Haga que el parámetro se especifique de manera opcional
    Valor insertado El valor insertado en las llamadas a la función donde no se especifica el parámetro (solo es válido para Agregar).
    Valor predeterminado El valor que usa la función si el autor de la llamada no especifica ninguno (solo es válido para Parámetros opcionales).

  4. Use la lista desplegable Ámbito de búsqueda para seleccionar si los cambios se van a aplicar al proyecto o a toda la solución.

  5. Cuando haya terminado, presione el botón Aceptar para realizar los cambios. Asegúrese de que los cambios que está solicitando se están realizando de manera correcta. Use las casillas de la mitad superior de la ventana para habilitar o deshabilitar el cambio de nombre de cualquier elemento.

    Captura de pantalla de una vista previa de Cambiar firma. Todas las partes en las que se llama a la función se obtiene una vista previa para que pueda comprobar cada cambio.

  6. Cuando todo parezca correcto, haga clic en el botón Aplicar y la función se cambiará en el código fuente.

    Captura de pantalla del cambio resultante. Los parámetros de ChangeUserInfo() ahora son: std::string lastName, std::string firstname, int age = -1).