Créer un contrôle de boîte à outils WPF

Article
12/21/2023

Le modèle de contrôle de boîte à outils WPF (Windows Presentation Framework) vous permet de créer des contrôles WPF qui sont automatiquement ajoutés à la boîte à outils lorsque l’extension est installée. Cette procédure pas à pas montre comment utiliser le modèle pour créer un contrôle Boîte à outils que vous pouvez distribuer à d’autres utilisateurs.

Créer le contrôle De boîte à outils

Créer une extension avec un contrôle de boîte à outils WPF

Créez un projet VSIX nommé MyToolboxControl. Vous trouverez le modèle de projet VSIX dans la boîte de dialogue Nouveau projet en recherchant « vsix ».
Lorsque le projet s’ouvre, ajoutez un modèle d’élément de contrôle de boîte à outils WPF nommé MyToolboxControl. Dans le Explorateur de solutions, cliquez avec le bouton droit sur le nœud du projet, puis sélectionnez Ajouter>un nouvel élément. Dans la boîte de dialogue Ajouter un nouvel élément, accédez à Visual C#>Extensibilité et sélectionnez Contrôle de boîte à outils WPF. Dans le champ Nom en bas de la fenêtre, remplacez le nom du fichier de commande par MyToolboxControl.cs.

La solution contient désormais un contrôle utilisateur, un ProvideToolboxControlAttributeRegistrationAttribute contrôle qui ajoute le contrôle à la boîte à outils et une entrée de ressource Microsoft.VisualStudio.ToolboxControl Asset dans le manifeste VSIX pour le déploiement.

Pour créer l’interface utilisateur du contrôle

Ouvrez MyToolboxControl.xaml dans le concepteur.

Le concepteur affiche un contrôle Grid contenant un contrôle Button.
Organiser la disposition de la grille. Lorsque vous sélectionnez le Grid contrôle, les barres de contrôle bleues apparaissent en haut et à gauche de la grille. Vous pouvez ajouter des lignes et des colonnes à la grille en cliquant sur les barres.
Ajoutez des contrôles enfants à la grille. Vous pouvez positionner un contrôle enfant en le faisant glisser de la boîte à outils vers une section de la grille, ou en définissant ses attributs et Grid.Column ses Grid.Row attributs dans le code XAML. L’exemple suivant ajoute deux étiquettes sur la ligne supérieure de la grille et un bouton sur la deuxième ligne.
```
<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>
```

Renommage du contrôle

Par défaut, votre contrôle apparaît dans la boîte à outils en tant que MyToolboxControl dans un groupe nommé MyToolboxControl.MyToolboxControl. Vous pouvez modifier ces noms dans le fichier MyToolboxControl.xaml.cs .

Ouvrez MyToolboxControl.xaml.cs dans la vue de code.
Recherchez la classe et renommez-la MyToolboxControl en TestControl. (La méthode la plus rapide consiste à renommer la classe, puis à sélectionner Renommez-le à partir du menu contextuel et effectuez les étapes. (Pour plus d’informations sur le Commande Renommer, consultez Renommer la refactorisation (C#).)
Accédez à l’attribut ProvideToolboxControl et remplacez la valeur du premier paramètre par Test. Il s’agit du nom du groupe qui contiendra le contrôle dans la boîte à outils.

Le code résultant doit ressembler à ceci :
```
[ProvideToolboxControl("Test", true)]
public partial class TestControl : UserControl
{
    public TestControl()
    {
        InitializeComponent();
    }
}
```

Générer, tester et déployer

Lorsque vous déboguez le projet, vous devez trouver le contrôle installé dans la boîte à outils de l’instance expérimentale de Visual Studio.

Pour générer et tester le contrôle

Régénérez le projet et démarrez le débogage.
Dans la nouvelle instance de Visual Studio, créez un projet d’application WPF. Vérifiez que le Concepteur XAML est ouvert.
Recherchez votre contrôle dans la boîte à outils et faites-la glisser vers l’aire de conception.
Démarrez le débogage de l’application WPF.
Vérifiez que votre contrôle s’affiche.

Pour déployer le contenu

Après avoir généré le projet testé, vous pouvez trouver le fichier .vsix dans le dossier *\bin\debug* du projet.
Vous pouvez l’installer sur un ordinateur local en double-cliquant sur le fichier .vsix et en suivant la procédure d’installation. Pour désinstaller le contrôle, accédez à Extensions d’outils>et Mises à jour et recherchez l’extension de contrôle, puis cliquez sur Désinstaller.
Chargez le fichier .vsix sur un réseau ou sur un site Web.

Si vous chargez le fichier sur le site web De la Place de marché Visual Studio, d’autres utilisateurs peuvent utiliser des extensions d’outils>et Mises à jour dans Visual Studio pour rechercher le contrôle en ligne et l’installer.