Freigeben über


Gewusst wie: Verfügbarmachen der Eigenschaften konstituierender Steuerelemente

Aktualisiert: November 2007

Die Steuerelemente, aus denen ein zusammengesetztes Steuerelement besteht, werden als konstituierende Steuerelemente bezeichnet. Sie werden im Allgemeinen als privat deklariert, daher kann der Entwickler nicht auf sie zugreifen. Wenn Eigenschaften dieser Steuerelemente zukünftigen Benutzern verfügbar gemacht werden sollen, müssen sie dem Benutzer gegenüber verfügbar gemacht werden. Eine Eigenschaft eines konstituierenden Steuerelements wird verfügbar gemacht, indem eine Eigenschaft im Benutzersteuerelement erstellt wird. Anschließend werden die Accessoren get und set dieser Eigenschaft verwendet, um die Änderung in der privaten Eigenschaft des konstituierenden Steuerelements auszuführen.

Stellen Sie sich ein hypothetisches Benutzersteuerelement mit einer konstituierenden Schaltfläche mit dem Namen MyButton vor. Wenn ein Benutzer in diesem Beispiel die ConstituentButtonBackColor-Eigenschaft anfordert, wird der Wert übermittelt, der in der BackColor-Eigenschaft von MyButton gespeichert ist. Wenn der Benutzer dieser Eigenschaft einen Wert zuweist, wird dieser automatisch an die BackColor-Eigenschaft von MyButton übergeben. Außerdem wird der set-Code ausgeführt, sodass sich die Farbe von MyButton ändert.

Im nachstehenden Beispiel wird gezeigt, wie die BackColor-Eigenschaft der konstituierenden Schaltfläche verfügbar gemacht wird:

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

So machen Sie eine Eigenschaft eines konstituierenden Steuerelements verfügbar

  1. Erstellen Sie eine öffentliche Eigenschaft für das Benutzersteuerelement.

  2. Schreiben Sie im get-Abschnitt der Eigenschaft Code, mit dem der Wert der Eigenschaft abgerufen wird, die verfügbar gemacht werden soll.

  3. Schreiben Sie im set-Abschnitt der Eigenschaft Code, mit dem der Wert der Eigenschaft an die verfügbar gemachte Eigenschaft des konstituierenden Steuerelements übergeben wird.

Siehe auch

Konzepte

Arten von benutzerdefinierten Steuerelementen

Referenz

UserControl

Weitere Ressourcen

Eigenschaften von Windows Forms-Steuerelementen