Gewusst wie: Erstellen Sie ein Toolbox-Steuerelement, die WPF verwendet

Die WPF Toolbox-Steuerelementvorlage, die in Visual Studio 2010 SDK enthalten ist, können Sie WPF-Steuerelemente (Windows Presentation Foundation) erstellen, die automatisch mitToolboxhinzugefügt werden, wenn die Erweiterung installiert ist. In diesem Thema wird gezeigt, wie die Vorlage zum Anzeigen eines Toolbox-Steuerelement zu erstellen, das Sie an andere Benutzer verteilen können. Eine vollständige Implementierung eines Toolbox-Steuerelements WPF finden Sie unter Exemplarische Vorgehensweise: Ein WPF Toolbox-Steuerelement erstellen.

Hinweis

Weitere Informationen über das Visual Studio-SDK finden Sie unter Erweitern von Visual Studio Overview.Um herauszufinden finden Sie unter wie das Visual Studio-SDK, auf Visual Studio Extensibility Developer Center der MSDN-Website herunterlädt.

Ein Toolbox-Steuerelement erstellen

Verwenden Sie die WPF Toolbox-Steuerelementvorlage, um das Projekt zu erstellen, und erstellen Sie dann eine Benutzeroberfläche im Designer XAML (Extensible Application Markup Language).

So erstellen Toolbox-Steuerelementprojekt a WPF

1. Klicken Sie im Menü Datei auf Neu und dann auf Projekt.

2. Im Dialogfeld Neues Projekt unter Installierte Vorlagen, klicken Sie auf den Knoten für die bevorzugte Programmiersprache, und klicken Sie dann auf Erweiterungen. Klicken Sie in der Liste der Projekttypen die Option WPF-Toolbox-Steuerelement.

3. Geben Sie im Feld Name Geben Sie den Namen ein, den Sie für das Projekt verwenden möchten. Klicken Sie auf OK.

   Visual Studio erstellt eine Projektmappe, die ein Benutzersteuerelement ein Attribut enthält, um das Steuerelement in Toolboxeinzufügen und ein VSIX-Manifest für die Bereitstellung.

Um das Steuerelement Benutzeroberfläche erstellen

1. In Projektmappen-ExplorerDoppelklick ToolboxControl.xaml, um sie im Designer zu öffnen.

   Der Designer zeigt ein Grid-Steuerelement veranschaulicht, das ein Button-Steuerelement enthält.

2. Ordnen Sie das Rasterlayout an.

   Wenn Sie das Grid-Steuerelement auswählen, werden die blaue Steuerleisten in der oberen und den linken Rand des Datenblatts. Sie können Zeilen und Spalten hinzufügen, indem Sie dem Raster auf die Balken klicken.

3. Fügen Sie dem Raster untergeordnete Steuerelemente hinzu.

   Sie können ein untergeordnetes Steuerelement positionieren, indem Sie sie aus Toolbox zu einem Abschnitt des Rasters ziehen oder indem Sie seine Grid.Row und Grid.Column-Attribute in XAML festlegen. Im folgenden Beispiel werden zwei Positionen Bezeichnungen auf der obersten Zeile des Rasters positioniert und eine Schaltfläche auf der zweiten Zeile.

   <Button Content="Reset" Name="button1" Click="button1_Click" Grid.Row="1" Grid.ColumnSpan="2" />
   <Label Content="{Binding Text}" Grid.Row="0" Grid.Column="0" Name="label1" />
   <Label Content="{Binding Count}" Grid.Row="0" Grid.Column="1" Name="label2" />
   

Das Steuerelement Codieren

Standardmäßig wird das Steuerelement in Toolbox als ToolboxControl1 in einer Gruppe Toolboxelement, die den gleichen Namen wie die Lösung verfügt. Sie können diese Namen in der ToolboxControl.xaml.cs-Datei ändern.

Wenn das Steuerelement Code

1. In Projektmappen-Explorermit der rechten Maustaste auf ToolboxControl.xaml.cs, und klicken Sie dann auf Code anzeigen , um die Datei in der Codeansicht zu öffnen.

2. Bei der Definition der partiellen Klasse, die das Steuerelement implementiert, klicken mit der rechten Maustaste auf den Klassennamen, klicken Sie auf Umgestalten, und klicken Sie dann auf Umbenennen. Ändern Sie den Namen der Klasse in den Namen, den Sie in Toolbox angezeigt werden soll, wenn das Steuerelement installiert ist.

3. Fügen Sie direkt oberhalb der Klassendefinition in der ProvideToolboxControl-Attributdeklaration, Änderung der Wert des ersten Parameters dem Namen der Elementgruppe, die das Steuerelement in Toolboxwird.

   Im folgenden Beispiel wird das ProvideToolboxControl-Attribut und die angepasste Klassendefinition für ein Steuerelement veranschaulicht, das Indikator in der Allgemein-Elementgruppe benannt ist.

   [ProvideToolboxControl("General", true)]
   public partial class Counter : UserControl
   

4. Implementieren Sie die Eigenschaften, Methoden und Ereignisse für das Steuerelement.

Builds, Tests und Bereitstellung

Drücken Sie F5, erstellt das Projekt mit einer VSIX-Bereitstellungsdatei enthält, und öffnet eine zweite Instanz von Visual Studio, das das Steuerelement enthält, das in Toolboxinstalliert ist.

Um das Steuerelement erstellen und testen

1. Drücken Sie F5.

2. In der neuen Instanz von Visual Studio, erstellen Sie ein WPF-Anwendungsprojekt.

3. Suchen Sie das Steuerelement in Toolbox und ziehen Sie es auf die Entwurfsoberfläche.

4. Klicken Sie im Fenster Eigenschaften Sie sicher, dass die Eigenschaften wie erwartet angezeigt werden.

5. Fügen Sie allen Code oder zusätzlichen Steuerelemente hinzu, die erforderlich sind, um die Methoden und Ereignisse zu testen.

6. Drücken Sie F5, um die WPF-Anwendung zu öffnen.

7. Stellen Sie sicher, dass die Eigenschaften, Methoden und Ereignisse des Steuerelements sich erwartungsgemäß verhalten.

Um das Steuerelement bereitstellen

1. Nachdem Sie das getestete Projekts öffnen Sie " \ bin \ Debug \ des Projekts in Windows Explorer, und suchen Sie die VSIX-Datei.

2. Laden Sie die VSIX-Datei in einem Netzwerk oder auf einer Website hoch.

   Wenn Sie die Datei zur Visual Studio Gallery Website hochladen, können andere Benutzer Erweiterungs-Manager in Visual Studio verwenden, um das Steuerelement zu suchen und sie zu installieren.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Ein WPF Toolbox-Steuerelement erstellen

Gewusst wie: Erstellen Sie ein Toolbox-Steuerelement, die Windows Forms verwendet

Weitere Ressourcen

Toolbox (Visual Studio SDK)