Procedimiento para exponer propiedades de controles constituyentes

  • Artículo

Los controles que componen un control compuesto se denominan controles constituyentes. Normalmente, estos controles se declaran como privados y, por tanto, el desarrollador no puede acceder a ellos. Si desea que las propiedades de estos controles estén disponibles para futuros usuarios, debe exponerlas al usuario. Para exponer una propiedad de un control constituyente, hay que crear una propiedad en el control de usuario y usar los descriptores de acceso get y set de esa propiedad para que el cambio surta efecto en la propiedad privada del control constituyente.

Imaginemos un hipotético control de usuario con un botón constituyente denominado MyButton. En este ejemplo, cuando el usuario solicita la propiedad ConstituentButtonBackColor, se entrega el valor almacenado en la propiedad BackColor de MyButton. Cuando el usuario asigna un valor a esta propiedad, ese valor se pasa automáticamente a la propiedad BackColor de MyButton y el código set se ejecutará, lo que hace que cambie el color de MyButton.

En el ejemplo siguiente se muestra cómo exponer la propiedad BackColor del botón constituyente:

Public Property ButtonColor() as System.Drawing.Color
   Get
      Return MyButton.BackColor
   End Get
   Set(Value as System.Drawing.Color)
      MyButton.BackColor = Value
   End Set
End Property

public Color ButtonColor
{
   get
   {
      return(myButton.BackColor);
   }
   set
   {
      myButton.BackColor = value;
   }
}

Para exponer una propiedad de un control constituyente

  1. Cree una propiedad pública para el control de usuario.

  2. En la sección get de la propiedad, escriba código que recupere el valor de la propiedad que quiere exponer.

  3. En la sección set de la propiedad, escriba código que pase el valor de la propiedad a la propiedad expuesta del control constituyente.

Consulte también