Tutorial: Heredar de un control de formularios Windows Forms con Visual Basic

Artículo
10/07/2008

Actualización: noviembre 2007

Con Visual Basic, puede crear controles personalizados eficaces mediante la herencia. A través de la herencia, podrá crear controles que retengan toda la funcionalidad heredada de los controles estándar de formularios Windows Forms y que incorporen también funcionalidad personalizada. En este tutorial, creará un control heredado sencillo denominado ValueButton. Este botón heredará la funcionalidad del botón estándar del control Button de los formularios Windows Forms y expondrá una propiedad personalizada denominada ButtonValue.

Nota:
Los cuadros de diálogo y comandos de menú que se ven pueden diferir de los descritos en la Ayuda, en función de la configuración activa o la edición. Para cambiar la configuración, elija la opción Importar y exportar configuraciones en el menú Herramientas. Para obtener más información, vea Valores de configuración de Visual Studio.

Crear el proyecto

Cuando cree un nuevo proyecto, debe especificar su nombre para establecer el espacio de nombres de la raíz, el nombre de ensamblado y el de proyecto, además de asegurarse de que el componente predeterminado estará en el espacio de nombres correcto.

Para crear la biblioteca de controles ValueButtonLib y el control ValueButton

En el menú Archivo, elija Nuevo y, a continuación, haga clic en Proyecto para abrir el cuadro de diálogo Nuevo proyecto.
Seleccione la plantilla de proyecto Biblioteca de controles de Windows en la lista de Proyectos de Visual Basic y escriba ValueButtonLib en el cuadro Nombre.

El nombre del proyecto, ValueButtonLib, se asigna también de forma predeterminada al espacio de nombres de la raíz. El espacio de nombres de la raíz se utiliza para calificar los nombres de los componentes del ensamblado. Por ejemplo, si dos ensamblados proporcionan componentes denominados ValueButton, puede especificar el componente ValueButton utilizando ValueButtonLib.ValueButton. Para obtener más información, vea Espacios de nombres en Visual Basic.
En el Explorador de soluciones, haga clic con el botón secundario del mouse (ratón) en UserControl1.vb, a continuación, elija Cambiar nombre en el menú de acceso directo. Cambie el nombre del archivo a ValueButton.vb. Haga clic en el botón Sí cuando se le pregunte si desea cambiar el nombre de todas las referencias al elemento de código 'UserControl1'.
En el Explorador de soluciones, haga clic en el botón Mostrar todos los archivos.
Abra el nodo ValueButton.vb para mostrar el archivo de código generado por el diseñador, ValueButton.Designer.vb. Abra este archivo en el Editor de código.
Busque la instrucción Class, Partial Public Class ValueButton, y cambie el tipo desde el que este control hereda de UserControl a Button. Esta opción permite al control heredado heredar toda la funcionalidad del control Button.
Busque el método InitializeComponent y quite la línea que asigna la propiedad AutoScaleMode. Esta propiedad no existe en el control Button.
En el menú Archivo, elija Guardar todo para guardar el proyecto.

Tenga en cuenta que ya no hay ningún diseñador visual disponible. Dado que el control Button realiza su propia presentación, no podrá modificar su apariencia en el diseñador. Su representación visual será exactamente la misma que la de la clase desde la que hereda (es decir, Button) a menos que se modifique en el código.

Nota:
Todavía puede agregar componentes, que no tengan ningún elemento de la interfaz de usuario, a la superficie de diseño.

Agregar una propiedad al control heredado

Uno de los usos posibles de los controles heredados de formularios Windows Forms es la creación de controles idénticos en apariencia y comportamiento a los controles estándar de formularios Windows Forms, pero que expongan propiedades personalizadas. En esta sección, agregará al control una propiedad denominada ButtonValue.

Para agregar la propiedad Value

En el Explorador de soluciones, haga clic con el botón secundario del mouse en ValueButton.vb y, a continuación, haga clic en Ver código en el menú de acceso directo.
Busque la instrucción Public Class ValueButton. Inmediatamente a continuación de esta instrucción, escriba el código siguiente:

[Visual Basic]
```
' Creates the private variable that will store the value of your 
' property.
Private varValue as integer
' Declares the property.
Property ButtonValue() as Integer
' Sets the method for retrieving the value of your property.
   Get
      Return varValue
   End Get
' Sets the method for setting the value of your property.
   Set(ByVal Value as Integer)
      varValue = Value
   End Set
End Property
```
Este código establece los métodos mediante los cuales se almacena y se recupera la propiedad ButtonValue. La instrucción Get establece el valor devuelto como el valor almacenado en la variable privada varValue, y la instrucción Set establece el valor de la variable privada mediante el uso de la palabra clave Value.
En el menú Archivo, elija Guardar todo para guardar el proyecto.

Probar el control

Los controles no son proyectos independientes; deben alojarse en un contenedor. Para probar el control, debe proporcionar un proyecto de prueba en el que ejecutarlo. También debe hacer que el control sea accesible para el proyecto de prueba generándolo (compilándolo). En esta sección, generará el control y lo probará en un formulario Windows Forms.

Para generar el control

En el menú Generar, haga clic en Generar solución.

La generación debe ser correcta, sin errores ni advertencias del compilador.

Para crear un proyecto de prueba

En el menú Archivo, elija Agregar y, a continuación, haga clic en Nuevo proyecto para abrir el cuadro de diálogo Agregar nuevo proyecto.
Seleccione el nodo de proyectos de Visual Basic, y haga clic en Aplicación para Windows.
En el cuadro Nombre, escriba Test.
En el Explorador de soluciones, haga clic en el botón Mostrar todos los archivos.
En el Explorador de soluciones, haga clic con el botón secundario del mouse (ratón) en el nodo Referencias del proyecto de prueba y, a continuación, seleccione Agregar referencia en el menú de acceso directo para mostrar el cuadro de diálogo Agregar referencia.
Haga clic en la ficha Proyectos.
Haga clic en la ficha Proyectos. El proyecto ValueButtonLib aparecerá en la lista Nombre de proyecto. Haga doble clic en el proyecto para agregar la referencia al proyecto de prueba.
En el Explorador de soluciones, haga clic con el botón secundario del mouse en Test y seleccione Generar.

Para agregar el control al formulario

En el Explorador de soluciones, haga clic con el botón secundario en Form1.vb y elija Diseñador de vistas en el menú de acceso directo.
En el Cuadro de herramientas, haga clic en Componentes de ValueButtonLib. Haga doble clic en ValueButton.

Aparecerá un control ValueButton en el formulario.
Haga clic con el botón secundario en ValueButton y elija Propiedades en el menú de acceso directo.
En la ventana Propiedades, examine las propiedades de este control. Observe que son idénticas a las propiedades expuestas por un botón estándar, excepto en que hay una propiedad adicional, ButtonValue.
Establezca la propiedad ButtonValue en 5.
En la ficha Todos los formularios Windows Forms del Cuadro de herramientas, haga doble clic en Etiqueta para agregar un control de Label a su formulario.
Coloque de nuevo la etiqueta en el centro del formulario.
Haga doble clic en ValueButton1

Se abrirá el Editor de código en el evento ValueButton1_Click.
Escriba la siguiente línea de código.

[Visual Basic]
```
Label1.Text = CStr(ValueButton1.ButtonValue)
```
En el Explorador de soluciones, haga clic con el botón secundario del mouse en Test y elija Establecer como proyecto de inicio en el menú de acceso directo.
En el menú Depurar, elija Iniciar depuración.

Aparece Form1.
Haga clic en Valuebutton1.

Se muestra el número '5' en Label1, que muestra que la propiedad ButtonValue del control heredado se ha pasado a Label1 mediante el método ValueButton1_Click. Así, el control ValueButton hereda toda la funcionalidad del botón estándar de formularios Windows Forms, pero expone una propiedad adicional, personalizada.