Partager via

Comment : ajouter des contrôles NamedRange aux feuilles de calcul

  • Article

Mise à jour : Juillet 2008

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.

Projets au niveau du document

  • Excel 2007

  • Excel 2003

Projets au niveau de l'application

  • Excel 2007

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

Vous pouvez ajouter des contrôles NamedRange à une feuille de calcul Microsoft Office Excel au moment du design et de l'exécution dans des projets au niveau du document.

À partir de Visual Studio 2008 Service Pack 1 (SP1), vous pouvez ajouter des contrôles NamedRange au moment de l'exécution dans des projets de complément d'application.

Cette rubrique décrit les tâches suivantes :

  • Ajout de contrôles NamedRange au moment du design

  • Ajout de contrôles NamedRange au moment de l'exécution dans un projet au niveau du document

  • Ajout de contrôles NamedRange au moment de l'exécution dans un projet au niveau de l'application

Pour plus d'informations sur les contrôles NamedRange, consultez NamedRange, contrôle.

Ajout de contrôles NamedRange au moment du design

Il existe plusieurs manières d'ajouter des contrôles NamedRange à une feuille de calcul Excel dans un projet au niveau du document au moment du design : depuis Excel, à partir de la Boîte à outils Visual Studio et à partir de la fenêtre Sources de données.

Remarque :

Il est possible que votre ordinateur affiche des noms ou des emplacements différents pour certains des éléments d'interface utilisateur Visual Studio 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.

Pour ajouter un contrôle NamedRange à une feuille de calcul à l'aide de la zone Nom dans Excel

  1. Sélectionnez la cellule ou les cellules que vous souhaitez inclure dans la plage nommée.

  2. Dans la zone Nom, tapez le nom de la plage et appuyez sur ENTRÉE.

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

Pour ajouter un contrôle NamedRange à une feuille de calcul à l'aide de la boîte à outils

  1. Ouvrez la Boîte à outils et cliquez sur l'onglet Contrôles Excel.

  2. Cliquez sur NamedRange et faites-le glisser jusqu'à une feuille de calcul.

    La boîte de dialogue Ajouter le contrôle NamedRange s'affiche.

  3. Sélectionnez la cellule ou les cellules que vous souhaitez inclure dans la plage nommée.

  4. Cliquez sur OK.

    Si vous ne souhaitez pas conserver le nom par défaut attribué au contrôle, vous pouvez le modifier dans la fenêtre Propriétés.

Pour ajouter un contrôle NamedRange à une feuille de calcul à l'aide de la fenêtre Sources de données

  1. Ouvrez la fenêtre Sources de données et créez une source de données pour votre projet. Pour plus d'informations, consultez Comment : établir une connexion à des données d'une base de données.

  2. Faites glisser un champ unique de la fenêtre Sources de données vers votre feuille de calcul.

    Un contrôle NamedRange lié aux données est ajouté à la feuille de calcul. Pour plus d'informations, consultez Liaison de données et Windows Forms.

Ajout de contrôles NamedRange au moment de l'exécution dans un projet au niveau du document

Vous pouvez ajouter un contrôle NamedRange par programme à votre feuille de calcul au moment de l'exécution. Cela vous permet de créer les contrôles hôtes en réponse à des événements. Les plages nommées créées dynamiquement ne restent pas dans la feuille de calcul comme contrôles hôtes lorsque la feuille de calcul est fermée. Pour plus d'informations, consultez Ajout de contrôles à des documents Office au moment de l'exécution.

Pour ajouter par programme un contrôle NamedRange à une feuille de calcul

  • Dans le gestionnaire d'événements Startup de Sheet1, insérez le code suivant pour ajouter le contrôle NamedRange à la cellule A1 et affectez à la propriété Value2 la valeur Hello world!.

    Dim textInCell As Microsoft.Office.Tools.Excel.NamedRange
textInCell = Me.Controls.AddNamedRange(Me.Range("A1"), "cellText")

textInCell.Value2 = "Hello world!"

    Microsoft.Office.Tools.Excel.NamedRange textInCell;
textInCell = this.Controls.AddNamedRange(this.get_Range("A1", missing), "cellText");

textInCell.Value2 = "Hello world!";

Ajout de contrôles NamedRange au moment de l'exécution dans un projet au niveau de l'application

Vous pouvez ajouter par programme un contrôle NamedRange à toute feuille de calcul ouverte dans un projet au niveau de l'application. Les plages nommées créées dynamiquement ne restent pas dans la feuille de calcul comme contrôles hôtes lorsque la feuille de calcul est fermée. Pour plus d'informations, consultez Extension de documents Word et de classeurs Excel dans des compléments d'application au moment de l'exécution..

Pour ajouter par programme un contrôle NamedRange à une feuille de calcul

  • Le code suivant génère un élément hôte de feuille de calcul basé sur la feuille de calcul ouverte, puis ajoute un contrôle NamedRange à la cellule A1 et affecte à sa propriété Value2 la valeur Hello world!.

    Private Sub AddNamedRange()
    Dim textInCell As Microsoft.Office.Tools.Excel.NamedRange

    Dim worksheet As Worksheet = CType(Application.ActiveWorkbook.Worksheets(1),  _
        Excel.Worksheet).GetVstoObject()
    Dim cell As Excel.Range = worksheet.Range("A1")
    textInCell = worksheet.Controls.AddNamedRange(cell, "MyNamedRange")
    textInCell.Value2 = "Hello World"
End Sub

    private void AddNamedRange()
{
    Microsoft.Office.Tools.Excel.NamedRange textInCell;

    Worksheet worksheet =
        ((Excel.Worksheet)Application.
              ActiveWorkbook.Worksheets[1]).GetVstoObject();
    Excel.Range cell = worksheet.Range["A1", missing]; 
    textInCell = worksheet.Controls.AddNamedRange(cell, "MyNamedRange");
    textInCell.Value2 = "Hello World";
 }

Voir aussi

Tâches

Comment : supprimer des contrôles NamedRange au moment du design

Comment : redimensionner les contrôles NamedRange

Concepts

Extension de documents Word et de classeurs Excel dans des compléments d'application au moment de l'exécution.

Développement d'un complément d'application pour Excel

NamedRange, contrôle

Vue d'ensemble des éléments hôtes et des contrôles hôtes

Limitations de programmation des éléments hôtes et des contrôles hôtes

Autres ressources

Contrôles sur des documents Office

Contrôles hôtes Excel

Historique des modifications

Date

Historique

Raison

Juillet 2008

Ajout d'une section qui montre comment ajouter un contrôle de plage nommée à une feuille de calcul dans un complément d'application.

Modifications de fonctionnalités dans le SP1.