Travailler avec Cells GridWeb

Accéder au Cells dans la feuille de calcul

Cette rubrique traite des cellules, en examinant la fonctionnalité la plus élémentaire de GridWeb : l’accès aux cellules.

Chaque feuille de calcul contient un objet GridCells, une collection d’objets GridCell. Un objet GridCell représente une cellule dans Aspose.Cells.GridWeb. Il est possible d’accéder à n’importe quelle cellule en utilisant GridWeb. Il existe deux méthodes préférées :

Ci-dessous, chaque approche est discutée.

Utilisation du nom Cell

Toutes les cellules ont un nom unique. Par exemple, A1, A2, B1, B2, etc. Aspose.Cells.GridWeb permet aux développeurs d’accéder à n’importe quelle cellule souhaitée en utilisant le nom de la cellule. Transmettez simplement le nom de la cellule (sous forme d’index) à la collection GridCells de GridWorksheet.

Utilisation des index de lignes et de colonnes

Une cellule peut également être reconnue par son emplacement en termes d’indices de ligne et de colonne. Transmettez simplement les indices de ligne et de colonne d’une cellule à la collection GridCells de GridWorksheet. Cette approche est plus rapide que celle ci-dessus.

Accéder et modifier la valeur d’un Cell

Accéder au Cells dans la feuille de calcul discuté de l’accès aux cellules. Cette rubrique étend cette discussion pour montrer comment accéder et modifier les valeurs de cellule à l’aide de GridWeb API.

Accéder et modifier la valeur d’un Cell

Valeurs de chaîne

Avant d’accéder et de modifier la valeur d’une cellule, vous devez savoir comment accéder aux cellules. Pour plus de détails sur les différentes approches d’accès aux cellules, reportez-vous àAccéder au Cells dans la feuille de calcul.

Chaque cellule possède une propriété nommée getStringValue(). Une fois l’accès à une cellule effectué, les développeurs peuvent accéder à la méthode getStringValue() pour accéder à la valeur de la chaîne de la cellule.

Tous types de valeurs

Aspose.Cells.GridWeb fournit également une méthode spéciale, putValue, pour chaque cellule. Avec cette méthode, il est possible d’insérer ou de modifier tout type de valeur (Boolean, int, double, DateTime et string) dans une cellule.

Il existe également une version surchargée de la méthode putValue qui peut prendre n’importe quel type de valeur au format chaîne et la convertir automatiquement en un type de données approprié. Pour y parvenir, transmettez la valeur booléenne true à un autre paramètre de la méthode putValue comme indiqué ci-dessous dans l’exemple.

Ajout de formules au Cells

La fonctionnalité la plus précieuse offerte par Aspose.Cells.GridWeb est la prise en charge des formules ou des fonctions. Aspose.Cells.GridWeb possède son propre moteur de formule qui calcule les formules dans les feuilles de calcul. Aspose.Cells.GridWeb prend en charge les fonctions ou formules intégrées et définies par l’utilisateur. Cette rubrique explique en détail l’ajout de formules aux cellules à l’aide de Aspose.Cells.GridWeb API.

Comment ajouter et calculer une formule ?

Il est possible d’ajouter, d’accéder et de modifier des formules dans des cellules en utilisant la propriété Formule d’une cellule. Aspose.Cells.GridWeb prend en charge les formules définies par l’utilisateur allant du simple au complexe. Cependant, un grand nombre de fonctions ou formules intégrées (similaires à Microsoft Excel) sont également fournies avec Aspose.Cells.GridWeb. Pour voir la liste complète des fonctions intégrées, veuillez vous référer à ceciliste des fonctions prises en charge.

Formule ajoutée à la cellule B3 mais non calculée par GridWeb

tâche : image_alt_text

Dans la capture d’écran ci-dessus, vous pouvez voir qu’une formule a été ajoutée à B3 mais n’a pas encore été calculée. Pour calculer toutes les formules, appelez la méthode calculateFormula du contrôle GridWeb GridWorksheetCollection après avoir ajouté des formules aux feuilles de calcul, comme indiqué ci-dessous.

Les utilisateurs peuvent également calculer des formules en cliquant sur Soumettre*.

En cliquant sur le bouton Soumettre de GridWeb

tâche : image_alt_text

IMPORTANT : Si un utilisateur clique sur Enregistrer ouannuler ou les onglets de la feuille, toutes les formules sont calculées automatiquement par GridWeb.

Résultat de la formule après calcul

tâche : image_alt_text

Référencement à Cells à partir d’autres feuilles de calcul

En utilisant Aspose.Cells.GridWeb, il est possible de référencer des valeurs stockées dans différentes feuilles de calcul dans leurs formules, créant ainsi des formules complexes.

La syntaxe permettant de référencer une valeur de cellule à partir d’une autre feuille de calcul est SheetName!CellName.

Créer une validation de données dans une GridCell de GridWeb

Aspose.Cells.GridWeb vous permet d’ajouterLa validation des données en utilisant la méthode GridWorksheet.getValidations().add(). En utilisant cette méthode, vous devez spécifier leCell Gamme. Mais si vous souhaitez créer une validation de données dans un seul GridCell, vous pouvez le faire directement en utilisant la méthode GridCell.createValidation(). De même, vous pouvez supprimer ** Validation des données** à partir d’un GridCell en utilisant la méthode GridCell.removeValidation().

L’exemple de code suivant crée unLa validation des données dans une cellule B3. Si vous entrez une valeur qui n’est pas comprise entre 20 et 40, la cellule B3 afficheraerreur de validation sous la forme deRouge XXXX comme le montre cette capture d’écran.

tâche : image_alt_text

Création de boutons de commande personnalisés

Aspose.Cells.GridWeb contient des boutons spéciaux tels que Soumettre, Enregistrer et Annuler. Tous ces boutons effectuent des tâches spécifiques pour Aspose.Cells.GridWeb. Il est également possible d’ajouter des boutons personnalisés qui effectuent des tâches personnalisées. Cette rubrique explique comment utiliser cette fonctionnalité.

L’exemple de code suivant explique comment créer un bouton de commande personnalisé et comment gérer son événement de clic. Vous pouvez utiliser n’importe quelle icône pour votre bouton de commande personnalisé. À des fins d’illustration, nous avons utilisé cette icône d’image.

tâche : image_alt_text

Comme vous pouvez le voir dans la capture d’écran suivante, lorsque l’utilisateur clique sur le bouton de commande personnalisé, il ajoute un texte dans la cellule A1 disant :“Mon bouton de commande personnalisé est cliqué."

tâche : image_alt_text

Gestion des événements du bouton de commande personnalisé

L’exemple de code suivant explique comment effectuer la gestion des événements du bouton de commande personnalisé.

Formatage des cellules pour GridWeb

Scénarios d’utilisation possibles

GridWeb permet désormais aux utilisateurs de saisir les données de cellule au format de pourcentage, tel que 3 %, et les données de la cellule seront automatiquement formatées à 3,00 %. Cependant, vous devrez définir le style de cellule sur Format de pourcentage qui est soit GridTableItemStyle.NumberType a 9 ou 10. Le nombre 9 formatera 3 % à 3 %, mais le nombre 10 formatera 3 % à 3,00 %.

Entrez les données Cell de la feuille de calcul GridWeb au format pourcentage

L’exemple de code suivant définit la cellule A1 GridTableItemStyle.NumberType sur 10, donc les données d’entrée 3 % sont automatiquement formatées à 3,00 %, comme indiqué dans la capture d’écran.

tâche : image_alt_text

Exemple de code