Procédure pas à pas : programmation d'événements d'un contrôle NamedRange

Article
04/28/2010

Mise à jour : novembre 2007

S'applique à
Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés. Type de projet Projets au niveau du document Version de Microsoft Office Excel 2007 Excel 2003 Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés.

Type de projet

Projets au niveau du document

Version de Microsoft Office

Excel 2007
Excel 2003

Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Cette procédure pas à pas explique comment ajouter un contrôle NamedRange à une feuille de calcul Microsoft Office Excel et programmer ses événements à l'aide de Visual Studio Tools pour Office.

Au cours de cette procédure pas à pas, vous apprendrez à :

ajouter un contrôle NamedRange à une feuille de calcul ;
programmer des événements de contrôle NamedRange ;
tester votre projet.

Remarque :
Votre ordinateur est susceptible d'afficher des noms ou des emplacements différents pour certains éléments de l'interface utilisateur Visual Studio mentionné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 Paramètres Visual Studio.

Composants requis

Pour exécuter cette procédure pas à pas, vous devez disposer de la configuration suivante :

Visual Studio Tools pour Office (composant facultatif de Visual Studio 2008 Professional et Visual Studio Team System)
Microsoft Office Excel 2003 ou Microsoft Office Excel 2007

Création du projet

Dans cette étape, vous allez créer un projet de classeur Excel à l'aide de Visual Studio Tools pour Office.

Pour créer un projet

Créez un projet de classeur Excel et attribuez-lui le nom My Named Range Events. Assurez-vous d'avoir sélectionné Créer un nouveau document. Pour plus d'informations, consultez Comment : créer des projets Visual Studio Tools pour Office.

Visual Studio ouvre le nouveau classeur Excel dans le concepteur et ajoute le projet My Named Range Events à l'Explorateur de solutions.

Ajout de texte et de plages nommées à la feuille de calcul

Étant donné que les contrôles hôtes sont des objets Office étendus, vous pouvez les ajouter à votre document de la même manière que si vous ajoutiez l'objet natif. Par exemple, vous pouvez ajouter un contrôle NamedRange Excel à une feuille de calcul en ouvrant le menu Insertion, en pointant sur Nom et en choisissant Définir. Vous pouvez également ajouter un contrôle NamedRange en le faisant glisser de la Boîte à outils sur la feuille de calcul.

Dans cette étape, vous ajouterez deux contrôles de plage nommée à la feuille de calcul à l'aide de la Boîte à outils, puis vous ajouterez du texte à la feuille de calcul.

Pour ajouter une plage à votre feuille de calcul

Vérifiez que le classeur My Named Range Events.xls est ouvert dans le concepteur Visual Studio, avec Sheet1 affiché.
À partir de l'onglet Contrôles Excel de la boîte à outils, faites glisser un contrôle NamedRange vers la cellule A1 dans Sheet1.

La boîte de dialogue Ajouter le contrôle NamedRange s'affiche.
Vérifiez que $A$1 apparaît dans la zone de texte modifiable, et que la cellule A1 est sélectionnée. Si ce n'est pas le cas, cliquez sur la cellule A1 pour la sélectionner.
Cliquez sur OK.

La cellule A1 devient une plage nommée namedRange1. Il n'existe aucune indication visible sur la feuille de calcul, mais namedRange1 apparaît dans la zone Nom (située juste au-dessus de la feuille de calcul sur le côté gauche) lorsque la cellule A1 est sélectionnée.
Ajoutez un autre contrôle NamedRange à la cellule B3.
Vérifiez que $B$3 apparaît dans la zone de texte modifiable, et que la cellule B3 est sélectionnée. Si ce n'est pas le cas, cliquez sur la cellule B3 pour la sélectionner.
Cliquez sur OK.

La cellule B3 devient une plage nommée namedRange2.

Pour ajouter du texte à votre feuille de calcul

Dans la cellule A1, tapez le texte suivant :

Voici un exemple de contrôle NamedRange.
Dans la cellule A3 (à gauche de namedRange2), tapez le texte suivant :

Événements :

Dans les sections suivantes, vous écrirez du code qui insère du texte dans namedRange2 et modifie les propriétés du contrôle namedRange2 en réponse aux événements BeforeDoubleClick, Change et SelectionChange de namedRange1.

Ajout de code pour répondre à l'événement BeforeDoubleClick

Pour insérer du texte dans NamedRange2 à partir de l'événement BeforeDoubleClick

Dans l'Explorateur de solutions, cliquez avec le bouton droit sur Sheet1.vb ou Sheet1.cs, puis sélectionnez Afficher le code.

Ajoutez du code pour que le gestionnaire d'événements namedRange1_BeforeDoubleClick ressemble à ceci :

Private Sub NamedRange1_BeforeDoubleClick( _
    ByVal Target As Microsoft.Office.Interop.Excel.Range, ByRef Cancel As Boolean) _
    Handles NamedRange1.BeforeDoubleClick

    With Me.NamedRange2
        .Value2 = "The BeforeDoubleClick event occurred."
        .Font.Color = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Red)
        .Font.Italic = True
    End With
End Sub

private void namedRange1_BeforeDoubleClick(
    Microsoft.Office.Interop.Excel.Range Target, ref bool Cancel)
{
    this.namedRange2.Value2 = "The BeforeDoubleClick event occurred.";
    this.namedRange2.Font.Color = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Red);
    this.namedRange2.Font.Italic = true;
}

En C#, vous devez ajouter des gestionnaires d'événements pour la plage nommée comme indiqué dans l'événement Startup ci-dessous. Pour plus d'informations sur la création de gestionnaires d'événements, consultez Comment : créer des gestionnaires d'événements dans Visual Studio Tools pour Office.

this.namedRange1.BeforeDoubleClick += new Microsoft.Office.Interop.Excel.
    DocEvents_BeforeDoubleClickEventHandler(namedRange1_BeforeDoubleClick);   

this.namedRange1.Change += new Microsoft.Office.Interop.Excel.
    DocEvents_ChangeEventHandler(namedRange1_Change);

this.namedRange1.SelectionChange +=new Microsoft.Office.Interop.Excel.
    DocEvents_SelectionChangeEventHandler(namedRange1_SelectionChange);

Ajout de code pour répondre à l'événement Change

Pour insérer du texte dans namedRange2 à partir de l'événement Change

Ajoutez du code pour que le gestionnaire d'événements NamedRange1_Change ressemble à ceci :

Private Sub NamedRange1_Change(ByVal Target As Microsoft.Office.Interop.Excel.Range) _
    Handles NamedRange1.Change

    With Me.NamedRange2
        .Value2 = "The Change event occurred."
        .Font.Color = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Blue)
        .Font.Italic = False
    End With
End Sub

private void namedRange1_Change(Microsoft.Office.Interop.Excel.Range Target)
{
    this.namedRange2.Value2 = "The Change event occurred.";
    this.namedRange2.Font.Color = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Blue);
    this.namedRange2.Font.Italic = false;
}

Remarque :
Dans la mesure où le fait de double-cliquer sur une cellule dans une plage Excel fait passer en mode édition, un événement Change se produit lorsque la sélection est déplacée en dehors de la plage, même si aucune modification n'a été apportée au texte.

Ajout de code pour répondre à l'événement SelectionChange

Pour insérer du texte dans namedRange2 à partir de l'événement SelectionChange

Ajoutez du code pour que le gestionnaire d'événements NamedRange1_SelectionChange ressemble à ceci :

Private Sub NamedRange1_SelectionChange(ByVal Target As Microsoft.Office.Interop.Excel.Range) _
    Handles NamedRange1.SelectionChange

    With Me.NamedRange2
        .Value2 = "The SelectionChange event occurred."
        .AddComment("SelectionChange always occurs before BeforeDoubleClick.")
        .Font.Color = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Black)
    End With
End Sub

private void namedRange1_SelectionChange(Microsoft.Office.Interop.Excel.Range Target)
{
    this.namedRange2.Value2 = "The SelectionChange event occurred.";
    this.namedRange2.AddComment("SelectionChange always occurs before BeforeDoubleClick.");
    this.namedRange2.Font.Color = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Black);
}

Remarque :
Dans la mesure où le fait de double-cliquer sur une cellule dans une plage Excel entraîne le déplacement de la sélection dans la plage, un événement SelectionChange se produit avant que l'événement BeforeDoubleClick ne se produise.

Test de l'application

Maintenant, vous pouvez tester votre classeur pour vérifier que le texte qui décrit les événements d'un contrôle NamedRange est inséré dans une autre plage nommée lorsque les événements sont déclenchés.

Pour tester votre document

Appuyez sur F5 pour exécuter votre projet.
Placez votre curseur dans namedRange1 et vérifiez que le texte concernant l'événement SelectionChange est inséré et qu'un commentaire est inséré dans la feuille de calcul.
Double-cliquez dans namedRange1 et vérifiez que le texte concernant les événements BeforeDoubleClick est inséré avec du texte en italique rouge dans namedRange2.
Cliquez en dehors de namedRange1 et notez que l'événement de modification se produit au moment de quitter le mode édition, bien qu'aucune modification n'ait été apportée au texte.
Modifiez le texte dans namedRange1.
Cliquez en dehors de namedRange1 et vérifiez que le texte concernant l'événement Change est inséré avec du texte bleu dans namedRange2.

Étapes suivantes

Cette procédure pas à pas présente les notions de base de la programmation des événements d'un contrôle NamedRange. Vous devrez peut-être ensuite exécuter les opérations suivantes :

Déploiement du projet. Pour plus d'informations, consultez Déploiement de solutions Office.
Programmation d'événements de contrôles view XMLNode. Pour plus d'informations, consultez Procédure pas à pas : modification du volet Actions en fonction du contexte utilisateur.

Voir aussi

Share via