Condividi tramite


Procedura: esporre le proprietà dei controlli costitutivi

Aggiornamento: novembre 2007

I controlli che costituiscono un controllo composito sono detti controlli costitutivi. Essi sono generalmente dichiarati Private e non sono pertanto accessibili allo sviluppatore. Per rendere disponibili le proprietà di questi controlli agli utenti futuri, è necessario esporle all'utente. La proprietà di un controllo costitutivo viene esposta creando una proprietà nel controllo utente e utilizzando le funzioni di accesso get e set di tale proprietà per rendere effettiva la modifica nella proprietà Private del controllo costitutivo.

Si consideri un controllo utente ipotetico con un pulsante costitutivo denominato MyButton. In questo esempio, quando l'utente richiede la proprietà ConstituentButtonBackColor, viene inviato il valore memorizzato nella proprietà BackColor di MyButton. Quando l'utente assegna un valore a questa proprietà, tale valore viene automaticamente passato alla proprietà BackColor di MyButton e viene eseguito il codice set che modifica il colore di MyButton.

L'esempio seguente mostra come esporre la proprietà BackColor del pulsante costitutivo:

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);
}

Per esporre una proprietà di un controllo costitutivo

  1. Creare una proprietà Public per il controllo utente.

  2. Nella sezione get della proprietà scrivere il codice che recupera il valore della proprietà che si desidera esporre.

  3. Nella sezione set della proprietà scrivere il codice che passa il valore della proprietà alla proprietà esposta del controllo costitutivo.

Vedere anche

Concetti

Tipi di controlli personalizzati

Riferimenti

UserControl

Altre risorse

Proprietà dei controlli Windows Form