Paso 6: Asignar un nombre a los controles de botón

Hay solo un control PictureBox en el formulario.Al agregarlo, el IDE lo denominó automáticamente pictureBox1.Solamente hay una casilla, denominada checkBox1.Pronto, escribirá código, y ese código hará referencia a CheckBox y PictureBox.Como no hay más que un ejemplar de cada control, entenderá lo que significan los términos pictureBox1 o checkBox1 cuando los vea en su código.

[!NOTA]

En Visual Basic, la primera letra del nombre de un control se pone en mayúscula de forma predeterminada, de modo que los nombres son PictureBox1, CheckBox1, etc.

Hay cuatro botones en el formulario, que el IDE ha denominado button1, button2, button3 y button4.Solo con mirar los nombres actuales no sabemos cuál es el botón Cerrar ni cuál es el botón Mostrar una imagen.Por ello, resulta útil dar nombres a los controles de botón.

vínculo a vídeoPara obtener una versión en vídeo de este tema, vea tutorial 1: Crear un visor de imagen en Visual Basic - vídeo 3 o tutorial 1: Crear un visor de imagen en C# - vídeo 3.

Para dar un nombre a los controles de botón

  1. Haga clic en el botón Cerrar.(Si todavía están seleccionados todos los botones, presione la tecla ESC para cancelar la selección.) Desplácese en la ventana Propiedades hasta que vea la propiedad (Name).(La propiedad (Name) se encuentra cerca de la parte superior cuando las propiedades están por orden alfabético.) Cambie el nombre a closeButton, como se muestra en la siguiente imagen.

    Ventana Propiedades con el nombre closeButton

    Ventana Propiedades mostrando el nombre closeButton

    [!NOTA]

    Si intenta cambiar el nombre del botón por BotónCerrar, con un espacio entre las palabras Botón y Cerrar, el IDE muestra el mensaje de error: "El valor de propiedad no es válido". En los nombres de los controles no se permiten espacios (ni algunos otros caracteres).

  2. Cambie el nombre de los otros tres botones a backgroundButton, clearButton y showButton.Puede comprobar los nombres haciendo clic en la lista desplegable de selección de controles en la ventana Propiedades.Aparecerán los nuevos nombres de los botones.

  3. Haga doble clic en el botón Mostrar una imagen en el Diseñador de Windows Forms.Al hacerlo, el IDE abre una nueva pestaña en la ventana principal denominada pestaña Form1.cs, como se muestra en la siguiente imagen.

    Pestaña Form1.cs con código de Visual C#

    Pestaña Form1.cs con código de Visual C#

  4. Céntrese en esta parte del código.

    Private Sub showButton_Click() Handles showButton.Click

End Sub

    private void showButton_Click(object sender, EventArgs e)
{
}

    Se trata de un método denominado showButton_Click().El IDE lo agregó al hacer clic en el botón showButton.Este método contiene código que se ejecuta cuando se hace clic en el botón Mostrar una imagen.

    [!NOTA]

    En este tutorial, el código de Visual Basic que se genera automáticamente se ha simplificado quitando todo lo que hay entre los paréntesis ().Siempre que esto sucede, se puede quitar el mismo código.El programa funcionará en ambos casos.En el resto de los tutoriales, se simplifica el código generado automáticamente siempre que sea posible.

  5. Vaya a la pestaña del diseñador (pestaña Form1.cs [Design] en Visual C# o Form1.vb [Design] en Visual Basic) y haga doble clic en el botón Borrar la imagen.Repita el procedimiento para los dos últimos botones.Cada vez, el IDE agrega un nuevo método al código del formulario.

  6. Haga doble clic en el control CheckBox en el Diseñador de Windows Forms, para que el IDE agregue un método checkBox1_CheckedChanged() más.Se llama a este método cada vez que el usuario activa o desactiva la casilla.

    [!NOTA]

    Cuando se trabaja en un programa, a menudo se utilizan alternativamente el editor de código y el Diseñador de Windows Forms.El IDE facilita la navegación en el proyecto.El Explorador de soluciones se utiliza para abrir el Diseñador de Windows Forms haciendo doble clic en Form1.cs en Visual C# o en Form1.vb en Visual Basic.

    A continuación se muestra el nuevo código que aparece en el editor de código.

    Private Sub clearButton_Click() Handles clearButton.Click

End Sub

Private Sub backgroundButton_Click() Handles backgroundButton.Click

End Sub

Private Sub closeButton_Click() Handles closeButton.Click

End Sub

Private Sub CheckBox1_CheckedChanged() Handles CheckBox1.CheckedChanged

End Sub

    private void clearButton_Click(object sender, EventArgs e)
{
}

private void backgroundButton_Click(object sender, EventArgs e)
{
}

private void closeButton_Click(object sender, EventArgs e)
{
}

private void checkBox1_CheckedChanged(object sender, EventArgs e)
{
}

    [!NOTA]

    Los cinco métodos que ha agregado se denominan controladores de eventos, porque el programa los llama cada vez que se produce un evento (por ejemplo, cuando un usuario hace clic en un botón o activa una casilla).

    Al hacer doble clic en un control en el IDE, este agrega un método de control de eventos para ese control.Por ejemplo, cuando se hace doble clic en un botón, el IDE agrega un controlador para este evento Click (al que se llamará cada vez que el usuario haga clic en el botón).Cuando se hace doble clic en una casilla, el IDE agrega un controlador para el evento CheckedChanged correspondiente (al que se llamará cada vez que el usuario active o desactive la casilla).

    Después de agregar un controlador de eventos para un control, puede volver en cualquier momento a él desde el Diseñador de Windows Forms haciendo doble clic en el control.

    [!NOTA]

    Los nombres son importantes al compilar programas. Los métodos (incluso los controladores de eventos) pueden tener cualquier nombre que se desee.Al agregar un controlador de eventos con el IDE, este elige un nombre basado en el nombre del control y en el evento que se controla.Por ejemplo, el evento Click para un botón denominado showButton se denomina método de control de eventos showButton_Click().Además, se suelen agregar paréntesis de apertura y cierre () después del nombre de método para dejar claro que se trata de un método.

Para continuar o revisar

  • Last updated on