Erstellen eines WPF-Toolbox-Steuerelements

Artikel
07/12/2024

Mit der Vorlage WPF-Toolbox-Steuerelement (Windows Presentation Framework) können Sie WPF-Steuerelemente erstellen, die der Toolbox automatisch hinzugefügt werden, wenn die Erweiterung installiert wird. Diese Vorgehensweise veranschaulicht, wie Sie die Vorlage verwenden, um ein Toolbox -Steuerelement zu erstellen, das Sie an andere Benutzer verteilen können.

Erstellen der Toolbox Control

Erstellen einer Erweiterung mit einem WPF Toolbox Control

Erstellen Sie ein VSIX-Anwendungsprojekt mit dem Namen MyToolboxControl. Sie finden die VSIX-Projektvorlage im Dialogfeld Neues Projekt, indem Sie nach vsix suchen.
Wenn das Projekt geöffnet wird, fügen Sie eine Elementvorlage für das WPF Toolbox Control-Element mit dem Namen MyToolboxControlhinzu. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektknoten, und wählen Sie Hinzufügen>Neues Element aus. Gehen Sie im Dialogfeld Neues Element hinzufügen zu Visual C#>Erweiterbarkeit und wählen Sie WPF Toolbox Control. Ändern Sie im FeldName unten im Fenster den Befehlsdateinamen in MyToolboxControl.cs.

Die Lösung enthält jetzt ein Benutzersteuerelement, ein ProvideToolboxControlAttribute RegistrationAttribute das das Steuerelement zur Toolbox hinzufügt, und einen Microsoft.VisualStudio.ToolboxControl Asset-Eintrag im VSIX-Manifest für die Bereitstellung

So erstellen Sie eine Steuerelement-Benutzeroberfläche

Öffnen Sie MyToolboxControl.xaml im Designer.

Der Designer zeigt ein Grid-Steuerelement an, das ein Button-Steuerelement enthält.
Ordnen Sie das Rasterlayout an. Wenn Sie das Grid Steuerelement auswählen, werden blaue Steuerleisten am oberen und linken Rand des Rasters angezeigt. Sie können dem Raster Zeilen und Spalten hinzufügen, indem Sie auf die Balken klicken.
Hinzufügen von untergeordneten Steuerelementen zum Raster Sie können ein untergeordnetes Steuerelement positionieren, indem Sie es aus der Toolbox in einen Abschnitt des Rasters ziehen oder indem Sie seine Attribute Grid.Row und Grid.Column im XAML festlegen. Im folgenden Beispiel werden der obersten Zeile des Rasters zwei Beschriftungen und eine Schaltfläche in der zweiten Zeile hinzugefügt.
```
<Grid>
    <Label Grid.Row="0" Grid.Column="0" Name="label1" />
    <Label Grid.Row="0" Grid.Column="1" Name="label2" />
    <Button Name="button1" Click="button1_Click" Grid.Row="1" Grid.ColumnSpan="2" />
</Grid>
```

Umbenennen des Steuerelements

Ihr Steuerelement wird standardmäßig in der Toolbox als MyToolboxControl in einer Gruppe mit dem Namen "MyToolboxControl.MyToolboxControl" angezeigt. Sie können diese Namen in der Datei MyToolboxControl.xaml.cs ändern.

Öffnen Sie MyToolboxControl.xaml.cs in der Codeansicht.
Suchen Sie die MyToolboxControl Klasse, und benennen Sie sie in TestControl um. (Die schnellste Möglichkeit hierzu besteht darin, die Klasse umzubenennen, und wählen Sie Umbenennen aus dem Kontextmenü um, und führen Sie die Schritte aus. (Weitere Informationen zum Befehl Umbenennen finden Sie unter Umbenennen der Umgestaltung (C#).)
Wechseln Sie zum ProvideToolboxControl Attribut, und ändern Sie den Wert des ersten Parameters in Test. Dies ist der Name der Gruppe, die das Steuerelement in der Toolbox enthalten ist.

Der resultierende Ausschnitt sollte wie folgt aussehen:
```
[ProvideToolboxControl("Test", true)]
public partial class TestControl : UserControl
{
    public TestControl()
    {
        InitializeComponent();
    }
}
```

Erstellen, Testen und Bereitstellen

Wenn Sie das Projekt debuggen, sollten Sie das Steuerelement finden, das in der Toolbox der experimentellen Instanz von Visual Studio installiert ist.

So erstellen Sie das Steuerelement und testen es

Erstellen Sie das Projekt neu und starten Sie das Debugging.
Erstellen Sie in der neuen Instanz von Visual Studio ein WPF-Anwendungsprojekt. Stellen Sie sicher, dass der XAML-Designer geöffnet ist.
Suchen Sie in der Toolbox nach dem Steuerelement, und ziehen Sie es dann auf die Entwurfsoberfläche.
Beginnen Sie mit dem Debuggen der WPF-Anwendung.
Überprüfen Sie, ob Ihr Steuerelement angezeigt wird.

So stellen Sie das Steuerelement bereit

Nachdem Sie das getestete Projekt erstellt haben, finden Sie die Datei.vsix im Ordner *\bin\debug* des Projekts.
Sie können es auf einem lokalen Computer installieren, indem Sie auf die .vsix-Datei doppelklicken und dem Installationsvorgang folgen. Um das Steuerelement zu deinstallieren, wechseln Sie zu Tools-Erweiterungen>und -Updates, und suchen Sie nach der Steuerelementerweiterung, und klicken Sie dann auf Deinstallieren.
Laden Sie die Datei .vsix in ein Netzwerk oder auf eine Website hoch.

Wenn Sie die Datei auf die Website Visual Studio Marketplace hochladen, können andere Benutzer Tools>Erweiterungen und Updates in Visual Studio verwenden, um das Steuerelement online zu finden und zu installieren.

Freigeben über