Procédure pas à pas : collecter des données à l’aide d’un Windows Form

  • Article

Cette procédure pas à pas montre comment ouvrir un Windows Form à partir d’une personnalisation au niveau du document pour Microsoft Office Excel, recueillir des informations auprès de l’utilisateur et écrire ces informations dans une cellule de feuille de calcul.

S’applique à : les informations contenues dans cette rubrique s’appliquent aux projets au niveau du document et aux projets de complément VSTO. Consultez les fonctionnalités disponibles par application Office lication et le type de projet.

Bien que cette procédure pas à pas utilise spécifiquement un projet au niveau du document pour Excel, les concepts présentés ici s’appliquent également à d’autres projets Office.

Prérequis

Vous devez disposer des éléments suivants pour exécuter cette procédure pas à pas :

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 Visual Studio.

Création d'un projet

La première étape consiste à créer un projet de classeur Excel.

Pour créer un projet

  1. Créez un projet de classeur Excel nommé WinFormInput, puis sélectionnez Créer un nouveau document dans l’Assistant. Pour plus d’informations, consultez Guide pratique pour créer des projets Bureau dans Visual Studio.

    Visual Studio ouvre le nouveau classeur Excel dans le concepteur et ajoute le projet WinFormInput à l’ Explorateur de solutions.

Ajouter un contrôle NamedRange à la feuille de calcul

Pour ajouter une plage nommée à Sheet1

  1. Sélectionnez la cellule A1 sur Sheet1.

  2. Dans la zone Nom , tapez formInput.

    La zone Nom se trouve à gauche de la barre de formule, juste au-dessus de la colonne A de la feuille de calcul.

  3. Appuyez sur Entrée.

    Un contrôle NamedRange est ajouté à la cellule A1. Il n’existe aucune indication visible sur la feuille de calcul, mais formInput apparaît dans la zone Nom (juste au-dessus de la feuille de calcul sur le côté gauche) et dans la fenêtre Propriétés quand la cellule A1 est sélectionnée.

Ajouter un Windows Form au projet

Créez un Windows Form pour inviter l’utilisateur à fournir des informations.

Pour ajouter un Windows Form

  1. Sélectionnez le projet WinFormInput dans l’ Explorateur de solutions.

  2. Dans le menu Projet , cliquez sur Ajouter un formulaire Windows.

  3. Nommez le formulaire GetInputString.vb ou GetInputString.cs, puis cliquez sur Ajouter.

    Le nouveau formulaire s’ouvre dans le concepteur.

  4. Ajoutez un TextBox et un Button au formulaire.

  5. Sélectionnez le bouton, recherchez la propriété Texte dans la fenêtre Propriétés et remplacez le texte par OK.

    Ajoutez ensuite du code à ThisWorkbook.vb ou ThisWorkbook.cs pour recueillir des informations auprès de l’utilisateur.

Afficher windows Form et collecter des informations

Créez une instance du Windows Form GetInputString et affichez-la, puis écrivez les informations de l’utilisateur dans une cellule de la feuille de calcul.

Pour afficher le formulaire et recueillir des informations

  1. Cliquez avec le bouton droit sur ThisWorkbook.vb ou ThisWorkbook.cs dans l’ Explorateur de solutions, puis cliquez sur Afficher le code.

  2. Dans le gestionnaire d’événements Open de ThisWorkbook, ajoutez le code suivant pour déclarer une variable pour le formulaire GetInputString puis afficher le formulaire.

    Remarque

    En C#, vous devez ajouter un gestionnaire d’événements comme indiqué dans l’événement Startup ci-dessous. Pour plus d’informations sur la création de gestionnaires d’événements, consultez Guide pratique pour créer des gestionnaires d’événements dans Bureau projets.

    private void ThisWorkbook_Startup(object sender, System.EventArgs e)
{
    this.Open += new 
        Microsoft.Office.Interop.Excel.WorkbookEvents_OpenEventHandler(ThisWorkbook_Open);
}

private void ThisWorkbook_Open()
{
    GetInputString inputForm = new GetInputString();
    inputForm.ShowDialog();
}

  3. Créez une méthode nommée WriteStringToCell qui écrit du texte dans une plage nommée. Cette méthode est appelée à partir du formulaire et l’entrée de l’utilisateur est passée au contrôle NamedRange , formInput, sur la cellule A1.

    public void WriteStringToCell(string formData)
{
    Globals.Sheet1.formInput.Value2 = formData;
}

    Ajoutez ensuite du code au formulaire pour gérer l’événement de clic du bouton.

Envoyer des informations à la feuille de calcul

Pour envoyer des informations à la feuille de calcul

  1. Cliquez avec le bouton droit sur GetInputString dans l’ Explorateur de solutions, puis cliquez sur Concepteur de vues.

  2. Double-cliquez sur le bouton pour ouvrir le fichier de code où le gestionnaire d’événements Click du bouton est ajouté.

  3. Ajoutez du code au gestionnaire d’événements pour prendre l’entrée de la zone de texte, l’envoyer à la fonction WriteStringToCell, puis fermer le formulaire.

    Globals.ThisWorkbook.WriteStringToCell(this.textBox1.Text);
this.Dispose();

Test

Vous pouvez à présent exécuter le projet. Le Windows Form s’affiche et votre entrée apparaît dans la feuille de calcul.

Pour tester votre classeur

  1. Appuyez sur F5 pour exécuter votre projet.

  2. Vérifiez que le Windows Form s’affiche.

  3. Tapez Hello World dans la zone de texte, puis cliquez sur OK.

  4. Vérifiez que Hello World apparaît dans la cellule A1 de la feuille de calcul.

Étapes suivantes

Cette procédure pas à pas présente les notions de base de l’affichage d’un Windows Form et du passage de données à une feuille de calcul. Voici quelques autres tâches que vous pourriez souhaiter effectuer :

  • Utiliser des contrôles Windows Forms sur un classeur Excel ou un document Word. Pour plus d’informations, consultez les contrôles Windows Forms sur Bureau vue d’ensemble des documents.

  • Modifiez l’interface utilisateur d’un complément Microsoft application Office lication à partir d’une personnalisation au niveau du document ou d’un complément VSTO. Pour plus d’informations, consultez Bureau Personnalisation de l’interface utilisateur.

Contenu connexe