Création d’un contrôle de boîte à outils WPFCreating a WPF Toolbox Control

Le modèle de contrôle de boîte à outils WPF (Windows Presentation Framework) vous permet de créer des contrôles WPF sont automatiquement ajoutés à la boîte à outils lorsque l’extension est installée.The WPF (Windows Presentation Framework) Toolbox Control template lets you create WPF controls that are automatically added to the Toolbox when the extension is installed. Cette rubrique montre comment utiliser le modèle pour créer un boîte à outils contrôle que vous pouvez distribuer à d’autres utilisateurs.This topic shows how to use the template to create a Toolbox control that you can distribute to other users.

À partir de Visual Studio 2015, vous n’installez pas le Kit de développement logiciel Visual Studio à partir du centre de téléchargement.Starting in Visual Studio 2015, you do not install the Visual Studio SDK from the download center. Il est inclus comme une fonctionnalité facultative dans le programme d’installation de Visual Studio.It is included as an optional feature in Visual Studio setup. Vous pouvez également installer le kit SDK VS ultérieurement.You can also install the VS SDK later on. Pour plus d’informations, consultez l’installation de Visual Studio SDK.For more information, see Installing the Visual Studio SDK.

Création d’un contrôle de boîte à outils WPFCreating a WPF Toolbox Control

Créer une Extension avec un contrôle de boîte à outils WPFCreate an Extension with a WPF Toolbox Control

  1. Créez un projet VSIX nommé MyToolboxControl.Create a VSIX project named MyToolboxControl. Vous pouvez trouver le modèle de projet VSIX dans le nouveau projet boîte de dialogue sous Visual c# / extensibilité.You can find the VSIX project template in the New Project dialog under Visual C# / Extensibility.

  2. Lorsque le projet s’ouvre, ajoutez un contrôle de boîte à outils WPF modèle d’élément nommé MyToolboxControl.When the project opens, add a WPF Toolbox Control item template named MyToolboxControl. Dans le l’Explorateur de solutions, cliquez sur le nœud du projet et sélectionnez Ajouter / nouvel élément.In the Solution Explorer, right-click the project node and select Add / New Item. Dans le ajouter un nouvel élément boîte de dialogue, accédez à Visual c# / extensibilité et sélectionnez contrôle de boîte à outils WPF.In the Add New Item dialog, go to Visual C# / Extensibility and select WPF Toolbox Control. Dans le nom au bas de la fenêtre, modifiez le nom de fichier de commande pour MyToolboxControl.cs.In the Name field at the bottom of the window, change the command file name to MyToolboxControl.cs.

    La solution contient désormais un contrôle utilisateur, un ProvideToolboxControlAttribute RegistrationAttribute qui ajoute le contrôle à la boîte à outilset un Microsoft.VisualStudio.ToolboxControl entrée de ressource dans le manifeste VSIX pour déploiement.The solution now contains a user control, a ProvideToolboxControlAttributeRegistrationAttribute that adds the control to the Toolbox, and a Microsoft.VisualStudio.ToolboxControl Asset entry in the VSIX manifest for deployment.

Pour créer le contrôle de l’interface utilisateurTo create the control UI

  1. Ouvrez MyToolboxControl.xaml dans le concepteur.Open MyToolboxControl.xaml in the designer.

    Le concepteur affiche un Grid contrôle contenant un Button contrôle.The designer shows a Grid control that contains a Button control.

  2. Modifier la disposition de grille.Arrange the grid layout. Lorsque vous sélectionnez le Grid contrôler, barres de contrôles bleu apparaissent sur les bords supérieur et gauche de la grille.When you select the Grid control, blue control bars appear on the top and left edges of the grid. Vous pouvez ajouter des lignes et des colonnes à la grille en cliquant sur les barres.You can add rows and columns to the grid by clicking the bars.

  3. Ajouter des contrôles enfants dans la grille.Add child controls to the grid. Vous pouvez positionner un contrôle enfant en le faisant glisser à partir de la boîte à outils à une section de la grille, ou en définissant sa Grid.Row et Grid.Column attributs dans le code XAML.You can position a child control by dragging it from the Toolbox to a section of the grid, or by setting its Grid.Row and Grid.Column attributes in the XAML. L’exemple suivant ajoute deux contrôles Label sur la ligne du haut de la grille et un bouton sur la deuxième ligne.The following example adds two labels on the top row of the grid and a button on the second row.

    <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>  
    

Renommer le contrôleRenaming the control

Par défaut, votre contrôle s’affiche dans le boîte à outils en tant que MyToolboxControl dans un groupe nommé MyToolboxControl.MyToolboxControl.By default, your control will appear in the Toolbox as MyToolboxControl in a group named MyToolboxControl.MyToolboxControl. Vous pouvez modifier ces noms dans le fichier MyToolboxControl.xaml.cs.You can change these names in the MyToolboxControl.xaml.cs file.

  1. Ouvrez MyToolboxControl.xaml.cs dans le mode code.Open MyToolboxControl.xaml.cs in the code view.

  2. Rechercher la classe MyToolboxControl et renommez-le TestControl.Find the MyToolboxControl class and rename it to TestControl. (La plus rapide pour ce faire consiste à renommer la classe, puis sélectionnez renommer dans le menu contextuel et effectuez les étapes.(The fastest way to do this is to rename the class, then select Rename from the context menu and complete the steps. (Pour plus d’informations sur la renommer command, consultez Renommer (refactorisation c#).)(For more information about the Rename command, see Rename Refactoring (C#).)

  3. Accédez à la ProvideToolboxControl d’attribut et modifiez la valeur du premier paramètre à Test.Go to the ProvideToolboxControl attribute and change the value of the first parameter to Test. Il s’agit du nom du groupe qui contient le contrôle dans le boîte à outils.This is the name of the group that will contain the control in the Toolbox.

    Le code résultant doit ressembler à ceci :The resulting code should look like this:

    [ProvideToolboxControl("Test", true)]  
    public partial class TestControl : UserControl  
    {  
        public TestControl()  
        {  
            InitializeComponent();  
        }  
    }  
    

Génération, test et déploiementBuilding, Testing, and Deployment

Lorsque vous déboguez le projet, vous devez rechercher le contrôle est installé dans le boîte à outils de l’instance expérimentale de Visual Studio.When you debug the project, you should find the control installed in the Toolbox of the experimental instance of Visual Studio.

Pour générer et tester le contrôleTo build and test the control

  1. Régénérez le projet et démarrer le débogage.Rebuild the project and start debugging.

  2. Dans la nouvelle instance de Visual Studio, créez un projet d’application WPF.In the new instance of Visual Studio, create a WPF Application project. Assurez-vous que le concepteur XAML est ouvert.Make sure the XAML Designer is open.

  3. Recherchez votre contrôle dans la boîte à outils et faites-la glisser vers l’aire de conception.Find your control in the Toolbox and drag it to the design surface.

  4. Démarrez le débogage de l’application WPF.Start debugging the WPF application.

  5. Vérifiez que votre contrôle s’affiche.Verify that your control appears.

Pour déployer le contenuTo deploy the control

  1. Une fois que vous générez le projet testé, vous trouverez le fichier .vsix dans le dossier \bin\debug\ du projet.After you build the tested project, you can find the .vsix file in the \bin\debug\ folder of the project.

  2. Vous pouvez l’installer sur un ordinateur local en double-cliquant sur le fichier .vsix et en suivant la procédure d’installation.You can install it on a local computer by double-clicking the .vsix file and following the installation procedure. Pour désinstaller le contrôle, accédez à outils / Extensions et mises à jour et recherchez l’extension de contrôle, puis cliquez sur désinstallation.To uninstall the control, go to Tools / Extensions and Updates and look for the control extension, then click Uninstall.

  3. Chargez le fichier .vsix sur un réseau ou un site web.Upload the .vsix file to a network or to a Web site.

    Si vous téléchargez le fichier à la galerie Visual Studio site Web, les autres utilisateurs peuvent utiliser outils / Extensions et mises à jour dans Visual Studio pour rechercher le contrôle en ligne et l’installer.If you upload the file to the Visual Studio Gallery Web site, other users can use Tools / Extensions and Updates in Visual Studio to find the control online and install it.