Gewusst wie: Erstellen eines WPF-UserControl-Bibliotheksprojekts

Artikel
09/03/2008

Aktualisiert: November 2007

Zum Kombinieren der Funktionalität eines oder mehrerer WPF-Steuerelemente (Windows Presentation Foundation) mit benutzerdefiniertem Code können Sie ein Benutzersteuerelement erstellen, das auch als zusammengesetztes Steuerelement bezeichnet wird. Mithilfe von Benutzersteuerelementen kann die schnelle Entwicklung von Steuerelementen mit der Funktionalität von WPF-Standardsteuerelementen und der Vielseitigkeit von benutzerdefinierten Eigenschaften und Methoden kombiniert werden. Sobald ein Benutzersteuerelement erstellt wird, wird ein visueller Designer angezeigt, auf dem WPF-Standardsteuerelemente positioniert werden können. Die untergeordneten Steuerelemente werden als konstituierende Steuerelemente bezeichnet.

Diese konstituierenden Steuerelemente behalten sowohl ihre inhärente Funktionalität als auch das Aussehen und Verhalten von WPF-Standardsteuerelementen bei. Wenn sie jedoch einmal in das Benutzersteuerelement integriert sind, sind sie für den Entwickler über Code nicht länger verfügbar. Vom Benutzersteuerelement wird sowohl das eigene Zeichnen als auch die gesamte grundlegende Funktionalität behandelt, die mit Steuerelementen verbunden ist.

Hinweis:
Je nach den aktivierten Einstellungen oder der verwendeten Version können sich die angezeigten Dialogfelder und Menübefehle von den in der Hilfe beschriebenen unterscheiden. Wählen Sie im Menü Extras die Option Einstellungen importieren und exportieren aus, um die Einstellungen zu ändern. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

So erstellen Sie ein WPF-Benutzersteuerelement-Projekt

Starten Sie eine Version von Visual Studio, die die WPF-Entwicklung unterstützt, z. B. Visual Studio 2008.
Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt. Das Dialogfeld Neues Projekt wird angezeigt.
Wählen Sie im Bereich Projekttypen die Programmiersprache aus, die Sie verwenden möchten.

Wählen Sie im Bereich Vorlagen die Option WPF-Benutzersteuerelementbibliothek für Visual Basic-Projekte oder Visual C#-Projekte aus. Weitere Informationen über die ausgewählte Vorlage werden unter den Bereichen Projekttypen und Vorlagen angezeigt.

Hinweis:
Wenn die WPF-Benutzersteuerelementbibliothek-Vorlage nicht angezeigt wird, sollten Sie sicherstellen, dass Sie auf eine Version von .NET Framework abzielen, die WPF unterstützt. Legen Sie im Dialogfeld Neues Projekt mit der Dropdownliste für die .NET Framework-Version in der oberen rechten Ecke .NET Framework 3.0 oder höher fest.

Geben Sie dem Projekt im Feld Name einen eindeutigen, sinnvollen Namen, der auf den Verwendungszweck des Steuerelements hinweist.
Geben Sie im Textfeld Speicherort das Verzeichnis ein, unter dem das Projekt gespeichert werden soll, oder klicken Sie auf die Schaltfläche Durchsuchen, um zum Verzeichnis zu navigieren.

Klicken Sie auf OK. Windows Presentation Foundation (WPF)-Designer für Visual Studio wird geöffnet und zeigt UserControl1 des von Ihnen erstellten Projekts an.

Visual Basic-Hinweis:
Jede ausführbare Datei, die Sie mit Visual Basic 2005 erstellen, enthält einen Namespace mit dem gleichen Namen wie das Projekt. Weitere Informationen finden Sie unter Namespaces in Visual Basic.

Ziehen Sie zwei Steuerelemente aus der Toolbox auf das Benutzersteuerelement.

Die Steuerelemente sollten so positioniert und entworfen werden, wie sie im fertig gestellten Steuerelement angezeigt werden sollen. Wenn Entwickler in der Lage sein sollen, auf die konstituierenden Steuerelemente zuzugreifen, müssen diese als öffentlich deklariert werden. Wahlweise müssen Eigenschaften des konstituierenden Steuerelements selektiv verfügbar gemacht werden.