Erstellen eines WPF-Toolbox-Steuerelements

Artikel
12/21/2023

Mit der Steuerelementvorlage für die WPF-Toolbox (Windows Presentation Framework) können Sie WPF-Steuerelemente erstellen, die automatisch der Toolbox hinzugefügt werden, wenn die Erweiterung installiert wird. In dieser exemplarischen Vorgehensweise wird gezeigt, wie Sie mithilfe der Vorlage ein Toolbox-Steuerelement erstellen, das Sie an andere Benutzer verteilen können.

Erstellen des Toolbox-Steuerelements

Erstellen einer Erweiterung mit einem WPF-Toolbox-Steuerelement

Erstellen Sie ein VSIX-Projekt 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-Steuerelement 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. Wechseln Sie im Dialogfeld "Neues Element hinzufügen" zu Visual C#>Erweiterbarkeit, und wählen Sie WPF-Toolbox-Steuerelement aus. Ändern Sie im Feld "Name " unten im Fenster den Befehlsdateinamen in "MyToolboxControl.cs".

Die Lösung enthält nun ein Benutzersteuerelement, ein ProvideToolboxControlAttributeRegistrationAttribute Steuerelement, mit dem das Steuerelement der Toolbox und ein Microsoft.VisualStudio.ToolboxControl Asset-Eintrag im VSIX-Manifest für die Bereitstellung hinzugefügt wird.

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.
Fügen Sie dem Raster untergeordnete Steuerelemente hinzu. Sie können ein untergeordnetes Steuerelement positionieren, indem Sie es aus der Toolbox in einen Abschnitt des Rasters ziehen oder dessen Attribute Grid.Column im XAML-Code festlegenGrid.Row. 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 dannBenennen Sie das 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 enthält.

Der resultierende Code 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 Debuggen.
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.
Starten Sie das 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 VSIX-Datei 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 VSIX-Datei in ein Netzwerk oder auf eine Website hoch.

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

Share via