Exemplarische Vorgehensweise: Vererben eines Windows Forms-Steuerelements mit Visual Basic

Artikel
09/02/2008

Aktualisiert: November 2007

Mit Visual Basic können Sie leistungsstarke benutzerdefinierte Steuerelemente durch Vererbung erstellen. Durch Vererbung können Sie Steuerelemente mit der gesamten Funktionalität von standardmäßigen Windows Forms-Steuerelementen erstellen, die zusätzlich über benutzerdefinierte Funktionalität verfügen. In dieser exemplarischen Vorgehensweise erstellen Sie ein einfaches geerbtes Steuerelement mit der Bezeichnung ValueButton. Diese Schaltfläche erbt die Funktionalität des standardmäßigen Windows Forms-Steuerelements Button und macht eine benutzerdefinierte Eigenschaft mit der Bezeichnung ButtonValue verfügbar.

Hinweis:
Je nach den aktiven Einstellungen oder der verwendeten Version können die angezeigten Dialogfelder und Menübefehle von den in der Hilfe beschriebenen abweichen. Klicken Sie im Menü Extras auf Einstellungen importieren und exportieren, um die Einstellungen zu ändern. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Erstellen des Projekts

Wenn Sie ein neues Projekt erstellen, geben Sie dessen Namen an, um Stammnamespace, Assemblyname und Projektname einzurichten und sicherzustellen, dass die Standardkomponente sich im richtigen Namespace befindet.

So erstellen Sie die ValueButtonLib-Steuerelementbibliothek und das ValueButton-Steuerelement

Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt, um das Dialogfeld Neues Projekt zu öffnen.
Wählen Sie in der Liste der Visual Basic-Projekte die Projektvorlage Windows-Steuerelementbibliothek aus, und geben Sie im Feld Name die Zeichenfolge ValueButtonLib ein.

Der Projektname ValueButtonLib wird standardmäßig auch dem Stammnamespace zugewiesen. Der Stammnamespace wird dazu verwendet, die Namen der Komponenten in der Assembly zu qualifizieren. Wenn beispielsweise zwei Assemblys Komponenten mit der Bezeichnung ValueButton bereitstellen, können Sie die zu verwendende ValueButton-Komponente mit ValueButtonLib.ValueButton spezifizieren. Weitere Informationen finden Sie unter Namespaces in Visual Basic.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf UserControl1.vb, und wählen Sie im Kontextmenü Umbenennen aus. Ändern Sie den Dateinamen in ValueButton.vb. Klicken Sie auf die Schaltfläche Ja, wenn Sie gefragt werden, ob Sie alle Verweise auf das Codeelement 'UserControl1' umbenennen möchten.
Klicken Sie im Projektmappen-Explorer auf die Schaltfläche Alle Dateien anzeigen.
Öffnen Sie den Knoten ValueButton.vb, um die vom Designer generierte Codedatei ValueButton.Designer.vb anzuzeigen. Öffnen Sie diese Datei im Code-Editor.
Suchen Sie die Class-Anweisung Partial Public Class ValueButton, und ändern Sie den Typ, von dem dieses Steuerelement von UserControl erbt, in Button. Dadurch kann das geerbte Steuerelement die gesamte Funktionalität des Button-Steuerelements erben.
Suchen Sie die InitializeComponent-Methode, und entfernen Sie die Zeile, die die AutoScaleMode-Eigenschaft zuweist. Diese Eigenschaft ist im Button-Steuerelement nicht vorhanden.
Klicken Sie im Menü Datei auf Alle speichern, um das Projekt zu speichern.

Beachten Sie, dass kein visueller Designer mehr verfügbar ist. Da sich das Button-Steuerelement selbst zeichnet, können Sie dessen Darstellung im Designer nicht ändern. Die visuelle Darstellung des Steuerelements entspricht genau der Klasse, von der es erbt (in diesem Fall Button), sofern im Code keine Änderung vorgenommen wurde.

Hinweis:
Sie können weiterhin Komponenten, die über keine Benutzeroberflächenelemente verfügen, der Entwurfsoberfläche hinzufügen.

Hinzufügen einer Eigenschaft zum geerbten Steuerelement

Eine Möglichkeit, geerbte Windows Forms-Steuerelemente zu verwenden, besteht darin, Steuerelemente zu erstellen, die in Darstellung und Verhalten mit den standardmäßigen Windows Forms-Steuerelementen identisch sind, dabei aber benutzerdefinierte Eigenschaften verfügbar machen. In diesem Abschnitt fügen Sie dem Steuerelement eine Eigenschaft mit der Bezeichnung ButtonValue hinzu.

So fügen Sie die Value-Eigenschaft hinzu

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf ValueButton.vb, und klicken Sie dann im Kontextmenü auf Code anzeigen.
Suchen Sie die Public Class ValueButton-Anweisung. Fügen Sie direkt darunter den folgenden Code ein:

[Visual Basic]
```
' Creates the private variable that will store the value of your 
' property.
Private varValue as integer
' Declares the property.
Property ButtonValue() as Integer
' Sets the method for retrieving the value of your property.
   Get
      Return varValue
   End Get
' Sets the method for setting the value of your property.
   Set(ByVal Value as Integer)
      varValue = Value
   End Set
End Property
```
Durch diesen Code werden die Methoden festgelegt, mit denen die ButtonValue-Eigenschaft gespeichert und abgerufen wird. Die Get-Anweisung legt den Wert fest, der für den in der privaten Variable varValue gespeicherten Wert zurückgegeben wird, und die Set-Anweisung legt den Wert der privaten Variable mithilfe des Value-Schlüsselworts fest.
Klicken Sie im Menü Datei auf Alle speichern, um das Projekt zu speichern.

Testen des Steuerelements

Steuerelemente sind keine eigenständigen Projekte und müssen daher in einem Container untergebracht werden. Um das Steuerelement zu testen, müssen Sie ein Testprojekt erstellen, in dem es ausgeführt wird. Sie müssen außerdem dem Testprojekt den Zugriff auf das Steuerelement ermöglichen, indem Sie das Testprojekt erstellen (kompilieren). In diesem Abschnitt erstellen Sie das Steuerelement und testen es in einem Windows Form.

So erstellen Sie das Steuerelement

Klicken Sie im Menü Erstellen auf Projektmappe erstellen.

Das Build sollte erfolgreich und ohne Compilerfehler oder -warnungen abgeschlossen werden.

So erstellen Sie ein Testprojekt

Zeigen Sie im Menü Datei auf Hinzufügen, und klicken Sie auf Neues Projekt, um das Dialogfeld Neues Projekt hinzufügen zu öffnen.
Wählen Sie den Projektknoten Visual Basic aus, und klicken Sie auf Windows-Anwendung.
Geben Sie im Feld Name die Zeichenfolge Test ein.
Klicken Sie im Projektmappen-Explorer auf die Schaltfläche Alle Dateien anzeigen.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Knoten Verweise für das Testprojekt, und klicken Sie im Kontextmenü auf Verweis hinzufügen, um das Dialogfeld Verweis hinzufügen anzuzeigen.
Klicken Sie auf die Registerkarte Projekte.
Klicken Sie auf die Registerkarte Projekte. Das ValueButtonLib-Projekt wird unter Projektname aufgeführt. Doppelklicken Sie auf das Projekt, um dem Testprojekt den Verweis hinzuzufügen.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Test, und wählen Sie Erstellen aus.

So fügen Sie das Steuerelement dem Formular hinzu

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Form1.vb, und wählen Sie im Kontextmenü Designer anzeigen aus.
Klicken Sie in der Toolbox auf ValueButtonLib Components. Doppelklicken Sie auf ValueButton.

In dem Formular wird ein ValueButton angezeigt.
Klicken Sie mit der rechten Maustaste auf ValueButton, und wählen Sie im Kontextmenü Eigenschaften aus.
Prüfen Sie im Eigenschaftenfenster die Eigenschaften des Steuerelements. Beachten Sie, dass diese mit Ausnahme einer Eigenschaft (der ButtonValue-Eigenschaft) mit den durch eine standardmäßige Schaltfläche verfügbar gemachten Eigenschaften übereinstimmen.
Legen Sie für die ButtonValue-Eigenschaft 5 fest.
Doppelklicken Sie auf der Registerkarte Alle Windows Forms der Toolbox auf Label, um dem Formular ein Label-Steuerelement hinzuzufügen.
Verschieben Sie das Label-Steuerelement in die Mitte des Formulars.
Doppelklicken Sie auf ValueButton1.

Der Code-Editor wird geöffnet und springt zum ValueButton1_Click-Ereignis.
Geben Sie folgende Codezeile ein.

[Visual Basic]
```
Label1.Text = CStr(ValueButton1.ButtonValue)
```
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Test, und wählen Sie im Kontextmenü Als Startprojekt festlegen.
Wählen Sie im Menü Debuggen die Option Debuggen starten.

Form1 wird angezeigt.
Klicken Sie auf Valuebutton1.

In Label1 wird die Zahl '5' angezeigt, was darauf hinweist, dass die ButtonValue-Eigenschaft des geerbten Steuerelements mithilfe der ValueButton1_Click-Methode an Label1 übergeben wurde. Somit erbt das ValueButton-Steuerelement alle Funktionen der Windows Forms-Standardschaltfläche, macht jedoch eine zusätzliche benutzerdefinierte Eigenschaft verfügbar.