Plages nommées
Création d’une plage nommée
Utilisation de Microsoft Excel
Les étapes suivantes décrivent comment nommer une cellule ou une plage de cellules à l’aide de Microsoft Excel. Cette méthode s’applique à Microsoft Office Excel 2003, Microsoft Excel 97, 2000 et 2002.
- Sélectionnez la cellule ou la plage de cellules que vous souhaitez nommer.
- Cliquez sur la zone de nom à l’extrémité gauche de la barre de formule.
- Saisissez le nom des cellules.
- Appuyez sur ENTRÉE.
Utilisation d’Aspose.Cells
Ici, nous utilisons l’API Aspose.Cells pour effectuer la tâche.
Aspose.Cells fournit une classe, Workbook, qui représente un fichier Microsoft Excel. La classe Workbook contient une collection WorksheetCollection qui permet d’accéder à chaque feuille de calcul dans un fichier Excel. Une feuille de calcul est représentée par la classe Worksheet. La classe Worksheet fournit une collection Cells.
Il est possible de créer une plage nommée en appelant la méthode surchargée createRange de la collection Cells. Une version typique de la méthode createRange prend les paramètres suivants :
- Nom de la cellule supérieure gauche, le nom de la cellule supérieure gauche dans la plage.
- Nom de la cellule inférieure droite, le nom de la cellule inférieure droite de la plage.
Lorsque la méthode createRange est appelée, elle renvoie la plage nommée nouvellement créée en tant qu’instance de la classe Range.
L’exemple suivant montre comment créer une plage nommée de cellules s’étendant sur B4:G14.
Accès à toutes les plages nommées dans une feuille de calcul
Appelez la méthode getNamedRanges de la collection WorksheetCollection pour obtenir toutes les plages nommées dans une feuille de calcul. La méthode getNamedRanges renvoie un tableau de toutes les plages nommées dans la collection WorksheetCollection.
L’exemple suivant montre comment accéder à toutes les plages nommées dans un classeur.
Accéder à une plage nommée spécifique
Appelez la méthode getRangeByName de la collection WorksheetCollection pour obtenir une plage spécifiée par son nom. Une méthode typique getRangeByName prend le nom de la plage nommée et renvoie la plage nommée spécifiée en tant qu’instance de la classe Range.
L’exemple suivant montre comment accéder à une plage spécifiée par son nom.
Identifier les cellules dans une plage nommée
À l’aide d’Aspose.Cells, vous pouvez insérer des données dans les cellules individuelles d’une plage. Supposons que vous ayez une plage nommée de cellules, c’est-à-dire A1:C4. Ainsi, la matrice constituera 4 * 3 = 12 cellules et les cellules de plage individuelles sont disposées de manière séquentielle. Aspose.Cells vous propose certaines propriétés utiles de la classe Range pour accéder aux cellules individuelles dans la plage. Vous pouvez utiliser les méthodes suivantes pour identifier les cellules dans la plage:
- getFirstRow renvoie l’index de la première ligne dans la plage nommée.
- getFirstColumn renvoie l’index de la première colonne dans la plage nommée.
L’exemple suivant montre comment saisir certaines valeurs dans les cellules d’une plage spécifiée.
Saisir des données dans les cellules de la plage nommée
À l’aide d’Aspose.Cells, vous pouvez insérer des données dans les cellules individuelles d’une plage. Supposons que vous ayez une plage nommée de cellules, à savoir H1:J4. Ainsi, la matrice constituera 4 * 3 = 12 cellules et les cellules de plage individuelles sont disposées de manière séquentielle. Aspose.Cells vous propose certaines propriétés utiles de la classe Range pour accéder aux cellules individuelles dans la plage. Vous pouvez utiliser les propriétés suivantes pour identifier les cellules dans la plage:
- getFirstRow renvoie l’index de la première ligne dans la plage nommée.
- getFirstColumn renvoie l’index de la première colonne dans la plage nommée.
L’exemple suivant montre comment saisir certaines valeurs dans les cellules d’une plage spécifiée.
Format des plages… Définition de la couleur de fond et des attributs de police pour une plage nommée
Pour appliquer une mise en forme, définissez un objet Style pour spécifier les paramètres de style et appliquez-le à l’objet Range.
L’exemple suivant montre comment définir la couleur de remplissage solide (couleur ombrage) avec les paramètres de police pour une plage.
Format des plages… Ajout de bordures à une plage nommée
Il est possible d’ajouter des bordures à une plage de cellules au lieu d’une seule cellule. L’objet Range fournit une méthode setOutlineBorders qui prend les paramètres suivants pour ajouter une bordure à la plage de cellules:
- borderStyle: le type de bordure, sélectionné dans l’énumération CellBorderType.
- borderColor: la couleur de ligne de la bordure, sélectionnée dans l’énumération Color.
L’exemple suivant montre comment définir une bordure de contour à une plage.
Le résultat suivant serait généré après l’exécution du code ci-dessus :
Appliquer un style aux cellules dans une plage
Parfois, vous voulez appliquer un style aux cellules dans une Plage. Pour cela, vous pouvez parcourir les cellules de la plage et utiliser la méthode Cell.setStyle pour appliquer le style à la cellule.
L’exemple suivant montre comment appliquer des styles aux cellules dans une plage.
Supprimer une Plage Nommée
Aspose.Cells fournit la méthode NameCollection.RemoveAt() pour effacer le nom de la plage. Pour effacer le contenu de la plage, utilisez la méthode Cells.ClearRange() . L’exemple suivant montre comment supprimer une plage nommée avec son contenu.
borderColors