Información detallada: agregar propiedades con valores con nombre

Artículo
10/07/2008

Actualización: noviembre 2007

En esta lección, obtendrá información sobre cómo agregar una propiedad que contiene una lista de valores a su control de usuario.

Valores con nombre

Las propiedades que ha agregado hasta ahora al control de usuario toman valores de cadena, pero las propiedades pueden ser de muchos tipos diferentes. En ocasiones, es conveniente proporcionar una lista de valores predefinidos entre los que elegir, como la propiedad SizeMode del control PictureBox que ha establecido en una lección anterior.

Supongamos, por ejemplo, que desea crear una propiedad para NamesControl que le permita elegir cómo muestra el nombre la etiqueta FullName. Necesitará una lista de valores entre los que elegir: nombre en primer lugar, apellido en primer lugar, sólo nombre y apellido, etc.

En Visual Basic, puede crear una enumeración que contenga los valores que desea. "Enumeración" en realidad significa "lista numerada"; Visual Basic almacena los números, de forma que puede hacer referencia a los valores por el nombre. Una enumeración se declara mediante la palabra clave Enum, como en el ejemplo siguiente.

Public Enum Display
    FirstMiddleLast
    FirstLast
    LastFirstMiddle
    LastFirst
End Enum

Cuando ha creado una enumeración, puede utilizarla como cualquier otro tipo de datos. Para agregar una propiedad que muestre una lista de valores, en primer lugar declare una variable del mismo tipo de datos que Enum y, a continuación, declare una propiedad del mismo tipo de datos. En tiempo de diseño, una lista de valores incluida en la enumeración aparecerá en la ventana Propiedades.

¡Inténtelo!

Para agregar una propiedad que muestre una lista de valores

Abra el proyecto NamesUserControl que creó en la lección anterior. Si no lo guardó, primero debe volver a la lección anterior, Agregar código al control de usuario, y completar los procedimientos de esa lección.
En el Explorador de soluciones, seleccione NamesControl.vb y en el menú Ver haga clic en Código.

En el Editor de código, agregue el siguiente código para crear una enumeración.

Public Enum Display
    FirstMiddleLast
    FirstLast
    LastFirstMiddle
    LastFirst
End Enum

Agregue el siguiente código para agregar una nueva propiedad.

Private DisplayStyleList As Display 
Property DisplayStyle() As Display
    Get
        Return DisplayStyleList
    End Get
    Set(ByVal value As Display)
        DisplayStyleList = value
    End Set
End Property

Elimine el código existente en el controlador de eventos FirstName_TextChanged y reemplácelo con el código siguiente.

Select Case DisplayStyleList
    Case Display.FirstLast
        FullName.Text = FirstName.Text & " " & LastName.Text
    Case Display.FirstMiddleLast
        FullName.Text = FirstName.Text & " " & MiddleName.Text & " " & LastName.Text
    Case Display.LastFirst
        FullName.Text = LastName.Text & ", " & FirstName.Text
    Case Display.LastFirstMiddle
        FullName.Text = LastName.Text & ", " & FirstName.Text & " " & MiddleName.Text
End Select

Presione F5 para ejecutar el programa. Escriba el nombre, el apellido y la inicial en los tres cuadros de texto.
En UserControl TestContainer, desplácese a la parte inferior de la cuadrícula Propiedades y seleccione la propiedad DisplayStyle. Seleccione un valor diferente y, a continuación, cambie el texto de uno de los cuadros de texto para ver cómo afecta a la etiqueta.
En el menú Archivo, haga clic en Guardar todo para guardar el trabajo.

Pasos siguientes

En esta lección, aprendió a usar una enumeración para crear una propiedad con una lista de valores. En la lección siguiente, aprenderá a probar el control de usuario colocándolo en un formulario.

Siguiente lección: Probar un control de usuario