Partager via


Ajouter des contrôles Windows Forms à Bureau documents

Vous pouvez ajouter des contrôles Windows Forms à des documents Microsoft Office Excel et Microsoft Office Word au moment du design dans les projets au niveau du document. Au moment de l’exécution, vous pouvez ajouter des contrôles dans des personnalisations au niveau du document et dans des compléments VSTO. Par exemple, vous pouvez ajouter un ComboBox contrôle à votre feuille de calcul afin que les utilisateurs puissent sélectionner dans une liste d’options.

S’applique à : les informations contenues dans cette rubrique s’appliquent aux projets de niveau document et aux projets de complément VSTO pour Excel et Word. Pour plus d’informations, consultez Fonctionnalités disponibles par application Office lication et le type de projet.

Cette rubrique décrit les tâches suivantes :

Ajouter des contrôles au moment du design

Il existe plusieurs façons d'ajouter des contrôles Windows Forms au document dans un projet au niveau du document au moment du design.

Remarque

Il est possible que pour certains des éléments de l'interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d’informations, consultez Personnaliser l’IDE.

Pour faire glisser un contrôle Windows Forms vers le document

  1. Créez ou ouvrez un projet de classeur Excel ou un projet de document Word dans Visual Studio pour que le document soit visible dans le concepteur. Pour plus d’informations sur la création de projets, consultez How to : Create Bureau projects in Visual Studio.

  2. Sous l’onglet Contrôles communs de la boîte à outils, cliquez sur le contrôle que vous souhaitez ajouter, puis faites-le glisser vers le document.

    Remarque

    Quand vous sélectionnez un contrôle dans Excel, vous voyez =EMBED("WinForms.Control.Host","") dans la Barre de formule. Ce texte est nécessaire et ne doit pas être supprimé.

Pour dessiner un contrôle Windows Forms sur le document

  1. Créez ou ouvrez un projet de classeur Excel ou un projet de document Word dans Visual Studio pour que le document soit visible dans le concepteur. Pour plus d’informations sur la création de projets, consultez How to : Create Bureau projects in Visual Studio.

  2. Sous l’onglet Contrôles communs de la boîte à outils, cliquez sur le contrôle que vous souhaitez ajouter.

  3. Dans le document, cliquez à l'endroit où l'angle supérieur gauche du contrôle doit se trouver, puis faites glisser le curseur vers l'endroit où l'angle inférieur droit du contrôle doit se trouver.

    Le contrôle est ajouté au document avec l'emplacement et la taille spécifiés.

    Remarque

    Quand vous sélectionnez un contrôle dans Excel, vous voyez =EMBED("WinForms.Control.Host","") dans la Barre de formule. Ce texte est nécessaire et ne doit pas être supprimé.

Pour ajouter un contrôle Windows Forms au document en cliquant une fois sur le contrôle

  1. Créez ou ouvrez un projet de classeur Excel ou un projet de document Word dans Visual Studio pour que le document soit visible dans le concepteur. Pour plus d’informations sur la création de projets, consultez How to : Create Bureau projects in Visual Studio.

  2. Sous l’onglet Contrôles communs de la boîte à outils, cliquez sur le contrôle que vous souhaitez ajouter

  3. Dans le document, cliquez à l'emplacement où vous souhaitez ajouter le contrôle.

    Le contrôle est ajouté au document avec la taille par défaut.

    Remarque

    Quand vous sélectionnez un contrôle dans Excel, vous voyez =EMBED("WinForms.Control.Host","") dans la Barre de formule. Ce texte est nécessaire et ne doit pas être supprimé.

Pour ajouter un contrôle Windows Forms au document en double-cliquant sur le contrôle

  1. Créez ou ouvrez un projet de classeur Excel ou un projet de document Word dans Visual Studio pour que le document soit visible dans le concepteur. Pour plus d’informations sur la création de projets, consultez How to : Create Bureau projects in Visual Studio.

  2. Sous l’onglet Contrôles communs de la boîte à outils, double-cliquez sur le contrôle que vous souhaitez ajouter.

    Le contrôle est ajouté au document, au centre de ce dernier ou du volet actif.

    Remarque

    Quand vous sélectionnez un contrôle dans Excel, vous voyez =EMBED("WinForms.Control.Host","") dans la Barre de formule. Ce texte est nécessaire et ne doit pas être supprimé.

Pour ajouter un contrôle Windows Forms au document en appuyant sur la touche Entrée

  1. Créez ou ouvrez un projet de classeur Excel ou un projet de document Word dans Visual Studio pour que le document soit visible dans le concepteur. Pour plus d’informations sur la création de projets, consultez How to : Create Bureau Projects in Visual Studio.

  2. Sous l’onglet Contrôles communs de la boîte à outils, cliquez sur le contrôle que vous souhaitez ajouter, puis appuyez sur la touche Entrée .

    Le contrôle est ajouté au document, au centre de ce dernier ou du volet actif.

    Remarque

    Quand vous sélectionnez un contrôle dans Excel, vous voyez =EMBED("WinForms.Control.Host","") dans la Barre de formule. Ce texte est nécessaire et ne doit pas être supprimé.

Ajouter des contrôles au moment de l’exécution dans les projets au niveau du document

Vous pouvez ajouter par programmation des contrôles Windows Forms à un document au moment de l’exécution. Dans Word, utilisez les méthodes de la propriété Controls de la classe ThisDocument. Dans Excel, utilisez des méthodes de la Controls propriété d’une Sheetclasse n . Chaque méthode a plusieurs surcharges qui vous permettent de spécifier l'emplacement du contrôle de différentes façons.

Lorsque vous ajoutez un contrôle Windows Forms à un document au moment de l’exécution, le contrôle n’est pas conservé dans le document lorsque le document est fermé. Vous pouvez recréer le contrôle à la prochaine ouverture du document. Pour plus d’informations, consultez Ajouter des contrôles à Bureau documents au moment de l’exécution.

Pour ajouter un contrôle Windows Forms au moment de l’exécution

  1. Utilisez une méthode qui a le nom Add<control class> (où la classe de contrôle est le nom de classe du contrôle Windows Forms que vous souhaitez ajouter, par AddButtonexemple).

    L’exemple de code suivant montre comment ajouter une Button cellule C5 dans Sheet1 un projet au niveau du document pour Excel.

    private void Sheet1_Startup(object sender, System.EventArgs e)
    {
        Microsoft.Office.Tools.Excel.Controls.Button salesButton;
        salesButton = this.Controls.AddButton(this.get_Range("C5"), "salesButton");
        salesButton.Text = "Calculate Total Sales";
    }
    

Ajouter des contrôles au moment de l’exécution dans les compléments VSTO

Vous pouvez ajouter des contrôles Windows Forms par programmation à n’importe quel document ouvert au moment de l’exécution. Tout d'abord, générez un élément hôte basé sur un document ouvert ou une feuille de calcul ouverte. Dans Word, utilisez les méthodes de la propriété Controls du nouvel élément hôte. Dans Excel, utilisez les méthodes de la propriété Controls du nouvel élément hôte. Chaque méthode a plusieurs surcharges qui vous permettent de spécifier l'emplacement du contrôle de différentes façons.

Lorsque vous ajoutez un contrôle Windows Forms à un document au moment de l’exécution, le contrôle n’est pas conservé dans le document lorsque le document est fermé. Vous pouvez recréer le contrôle à la prochaine ouverture du document. Pour plus d’informations, consultez Ajouter des contrôles à Bureau documents au moment de l’exécution.

Pour plus d’informations sur la génération d’éléments hôtes dans des projets de complément VSTO, consultez Étendre des documents Word et des classeurs Excel dans des compléments VSTO au moment de l’exécution.

Pour ajouter un contrôle Windows Forms au moment de l’exécution

  1. Utilisez une méthode qui a le nom Add<control class> (où la classe de contrôle est le nom de classe du contrôle Windows Forms que vous souhaitez ajouter, par AddButtonexemple).

    Remarque

    Dans les projets de complément VSTO qui ciblent .NET Framework 4 ou version ultérieure, vous devez ajouter une référence à Microsoft.Bureau. Tools.Excel.v4.0.Utilities.dll ou Microsoft.Bureau. Assembly Tools.Word.v4.0.Utilities.dll avant de pouvoir accéder aux méthodes de classe> De contrôle Add<.

    L’exemple de code suivant montre comment ajouter Button au premier paragraphe du document actif en utilisant un complément Word VSTO.

    Microsoft.Office.Tools.Word.Controls.Button salesButton;
    
    Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    
    
    extendedDocument.Paragraphs[1].Range.InsertParagraphBefore();
    salesButton = extendedDocument.Controls.AddButton(
        extendedDocument.Paragraphs[1].Range, 75, 18, "salesButton");
    salesButton.Text = "Calculate Sales";