Share via


Cómo: Exponer propiedades de controles constituyentes

Actualización: noviembre 2007

Los controles que forman un control compuesto se denominan controles constituyentes. Estos controles suelen declararse como privados, por lo que no resultan accesibles al programador. Si desea que las propiedades de estos controles estén disponibles para futuros usuarios, deberá exponerlas a los usuarios. Para exponer una propiedad de un control constituyente, se crea una propiedad en el control de usuario; a continuación, se utilizan los descriptores de acceso get y set de esta propiedad para ejecutar el cambio en la propiedad privada del control constituyente.

Considere 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, se pasa automáticamente ese valor a la propiedad BackColor de MyButton y se ejecuta el código set, lo que cambia 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;
   }
}
/** @property */
public Color get_ButtonColor()
{
   return myButton.get_BackColor();
}
/** @property */
public void set_ButtonColor(Color value)
{
   myButton.set_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 desea 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.

Vea también

Conceptos

Variedades de controles personalizados

Referencia

UserControl

Otros recursos

Propiedades de los controles de formularios Windows Forms