Cell classe
Cell classe
Encapsule l’objet qui représente une seule cellule de classeur.
Le type Cell expose les membres suivants :
Propriétés
| Propriété | Description |
|---|---|
| worksheet | Obtient la feuille de calcul parent. |
| date_time_value | Obtient la valeur DateTime contenue dans la cellule. |
| row | Obtient le numéro de ligne (basé sur zéro) de la cellule. |
| column | Obtient le numéro de colonne (base zéro) de la cellule. |
| is_formula | Indique si la cellule spécifiée contient une formule. |
| type | Représente le type de valeur de cellule. |
| name | Obtient le nom de la cellule. |
| is_error_value | Vérifie si la valeur de cette cellule est une erreur. |
| is_numeric_value | Indique si la valeur interne de cette cellule est numérique (int, double et datetime) |
| string_value | Obtient la valeur de chaîne contenue dans la cellule. Si le type de cette cellule est une chaîne, renvoyez la valeur de chaîne elle-même.
Pour les autres types de cellules, la valeur de chaîne formatée (formatée avec le style spécifié de cette cellule) sera renvoyée. La valeur de cellule formatée est la même que celle que vous pouvez obtenir d’Excel lors de la copie d’une cellule sous forme de texte (comme copie de la cellule dans un éditeur de texte ou exportation au format csv). |
| string_value_without_format | Obtient la valeur de la cellule sous forme de chaîne sans aucun format. |
| number_category_type | Représente le type de catégorie de la mise en forme des nombres de cette cellule. |
| display_string_value | Obtient la valeur de chaîne mise en forme de cette cellule par le style d’affichage de la cellule. |
| int_value | Obtient la valeur entière contenue dans la cellule. |
| double_value | Obtient la valeur double contenue dans la cellule. |
| float_value | Obtient la valeur flottante contenue dans la cellule. |
| bool_value | Obtient la valeur booléenne contenue dans la cellule. |
| has_custom_style | Indique si cette cellule a des paramètres de style personnalisés (différents de ceux par défaut hérités
de la ligne, de la colonne ou du classeur correspondant). |
| shared_style_index | Obtient l’index de style partagé de la cellule dans le pool de styles. |
| formula | Obtient ou définit une formule du Cell. |
| formula_local | Obtenez la formule formatée locale de la cellule. |
| r1c1_formula | Obtient ou définit une formule R1C1 du Cell. |
| contains_external_link | Indique si cette cellule contient un lien externe.
S’applique uniquement lorsque la cellule est une cellule de formule. |
| is_array_header | Indique que la formule de la cellule est et la formule matricielle
et c’est la première cellule du tableau. |
| is_dynamic_array_formula | Indique si la formule de la cellule est une formule matricielle dynamique (true) ou une formule matricielle héritée (false). |
| is_array_formula | Indique si la formule de la cellule est une formule matricielle. |
| is_in_array | Indique si la formule de la cellule est une formule matricielle. |
| is_shared_formula | Indique si la formule de la cellule fait partie de la formule partagée. |
| is_table_formula | Indique si cette cellule fait partie de la formule du tableau. |
| is_in_table | Indique si cette cellule fait partie de la formule du tableau. |
| value | Obtient la valeur contenue dans cette cellule. |
| is_style_set | Indique si le style de la cellule est défini. Si elle renvoie false, cela signifie que cette cellule a un format de cellule par défaut. |
| is_merged | Vérifie si une cellule fait partie d’une plage fusionnée ou non. |
| comment | Obtient le commentaire de cette cellule. |
| html_string | Obtient et définit la chaîne html qui contient des données et certains formats dans cette cellule. |
Méthodes
| Méthode | Description |
|---|---|
| calculate(options) | Calcule la formule de la cellule. |
| calculate(ignore_error, custom_function) | Calcule la formule de la cellule. |
| put_value(bool_value) | Insère une valeur booléenne dans la cellule. |
| put_value(int_value) | Insère une valeur entière dans la cellule. |
| put_value(double_value) | Met une valeur double dans la cellule. |
| put_value(string_value, is_converted, set_style) | Met une valeur dans la cellule, le cas échéant, la valeur sera convertie en un autre type de données et le format numérique de la cellule sera réinitialisé. |
| put_value(string_value, is_converted) | Insère une valeur de chaîne dans la cellule et convertit la valeur en un autre type de données, le cas échéant. |
| put_value(string_value) | Insère une valeur de chaîne dans la cellule. |
| put_value(date_time) | Place une valeur DateTime dans la cellule. |
| put_value(object_value) | Insère une valeur d’objet dans la cellule. |
| get_display_style() | Obtient le style d’affichage de la cellule.
Si cette cellule est également affectée par d’autres paramètres tels que la mise en forme conditionnelle, les objets de liste, etc., alors le style d’affichage peut être différent de cell.GetStyle(). |
| get_display_style(include_merged_borders) | Obtient le style d’affichage de la cellule.
Si la cellule est au format conditionnel, le style d’affichage n’est pas le même que celui de cell.GetStyle(). |
| get_style() | Obtient le style de cellule. |
| get_style(check_borders) | Si checkBorders est vrai, vérifiez si les bordures des autres cellules affecteront le style de cette cellule. |
| set_style(style) | Définit le style de cellule. |
| set_style(style, explicit_flag) | Appliquez le style de cellule. |
| set_style(style, flag) | Appliquez le style de cellule. |
| set_formula(formula, value) | Définissez la formule et la valeur de la formule. |
| set_formula(formula, is_r1c1, is_local, value) | Définissez la formule et la valeur de la formule. |
| set_formula(formula, options, value) | Définissez la formule et la valeur de la formule. |
| set_array_formula(array_formula, row_number, column_number, is_r1c1, is_local) | Définit une formule matricielle sur une plage de cellules. |
| set_array_formula(array_formula, row_number, column_number) | Définit une formule matricielle (formule matricielle héritée saisie via CTRL + MAJ + ENTRÉE dans ms excel) sur une plage de cellules. |
| set_array_formula(array_formula, row_number, column_number, options) | Définit une formule matricielle sur une plage de cellules. |
| set_array_formula(array_formula, row_number, column_number, options, values) | Définit une formule matricielle sur une plage de cellules. |
| set_shared_formula(shared_formula, row_number, column_number, is_r1c1, is_local) | Définit une formule sur une plage de cellules. |
| set_shared_formula(shared_formula, row_number, column_number) | Définit les formules partagées sur une plage de cellules. |
| set_shared_formula(shared_formula, row_number, column_number, options) | Définit les formules partagées sur une plage de cellules. |
| set_shared_formula(shared_formula, row_number, column_number, options, values) | Définit les formules partagées sur une plage de cellules. |
| get_leafs() | Obtenez toutes les cellules qui font directement référence à cette cellule et doivent être mises à jour lorsque cette cellule est modifiée. |
| get_leafs(recursive) | Obtenir toutes les cellules qui seront mises à jour lorsque cette cellule sera modifiée. |
| set_dynamic_array_formula(array_formula, options, calculate_value) | Définit la formule de tableau dynamique et fait en sorte que la formule se répande dans les cellules voisines si possible. |
| set_dynamic_array_formula(array_formula, options, values, calculate_range, calculate_value) | Définit la formule de tableau dynamique et fait en sorte que la formule se répande dans les cellules voisines si possible. |
| set_dynamic_array_formula(array_formula, options, values, calculate_range, calculate_value, copts) | Définit la formule de tableau dynamique et fait en sorte que la formule se répande dans les cellules voisines si possible. |
| set_table_formula(row_number, column_number, row_input_cell, column_input_cell, values) | Créez une table de données à deux variables pour une plage donnée à partir de cette cellule. |
| set_table_formula(row_number, column_number, input_cell, is_row_input, values) | Créez une table de données à une variable pour une plage donnée à partir de cette cellule. |
| set_table_formula(row_number, column_number, row_index_of_row_input_cell, column_index_of_row_input_cell, row_index_of_column_input_cell, column_index_of_column_input_cell, values) | Créez une table de données à deux variables pour une plage donnée à partir de cette cellule. |
| set_table_formula(row_number, column_number, row_index_of_input_cell, column_index_of_input_cell, is_row_input, values) | Créez une table de données à une variable pour une plage donnée à partir de cette cellule. |
| get_characters() | Renvoie tous les objets Characters
qui représente une plage de caractères dans le texte de la cellule. |
| get_characters(flag) | Renvoie tous les objets Characters
qui représente une plage de caractères dans le texte de la cellule. |
| get_string_value(format_strategy) | Obtient la valeur de chaîne selon une stratégie formatée spécifique. |
| get_width_of_value() | Obtient la largeur de la valeur en unité de pixels. |
| get_height_of_value() | Obtient la hauteur de la valeur en unité de pixels. |
| get_format_conditions() | Obtient les conditions de format qui s’appliquent à cette cellule. |
| get_formula(is_r1c1, is_local) | Obtenez la formule de cette cellule. |
| get_precedents() | Obtient toutes les références apparaissant dans la formule de cette cellule. |
| get_dependents(is_all) | Obtenez toutes les cellules dont la formule fait directement référence à cette cellule. |
| get_precedents_in_calculation() | Obtient tous les précédents (référence aux cellules du classeur en cours) utilisés par la formule de cette cellule lors de son calcul. |
| get_dependents_in_calculation(recursive) | Obtient toutes les cellules dont le résultat calculé dépend de cette cellule. |
| get_array_range() | Obtient la plage de tableau si la formule de la cellule est une formule de tableau. |
| remove_array_formula(leave_normal_formula) | Supprimer la formule matricielle. |
| copy(cell) | Copie les données d’une cellule source. |
| characters(start_index, length) | Renvoie un objet Characters qui représente une plage de caractères dans le texte de la cellule. |
| is_rich_text() | Indique si la valeur de la chaîne de cellule est un texte enrichi. |
| set_characters(characters) | Définit le format de texte enrichi de la cellule. |
| get_merged_range() | Renvoie un objet Range qui représente une plage fusionnée. |
| get_html_string(html5) | Obtient la chaîne html qui contient des données et certains formats dans cette cellule. |
| to_json() | Convertissez les données de structure Cell en JSON. |
| equals(cell) | Vérifie si cet objet fait référence à la même cellule avec un autre objet de cellule. |
| get_conditional_formatting_result() | Obtenez le résultat de la mise en forme conditionnelle. |
| get_validation() | Obtient la validation appliquée à cette cellule. |
| get_validation_value() | Obtient la valeur de validation appliquée à cette cellule. |
| get_table() | Obtient la table qui contient cette cellule. |
Exemple
from aspose.cells import TextAlignmentType, Workbook
from aspose.pydrawing import Color
excel = Workbook()
cells = excel.worksheets[0].cells
# Put a string into a cell
cell = cells.get(0, 0)
cell.put_value("Hello")
first = cell.string_value
# Put an integer into a cell
cell = cells.get("B1")
cell.put_value(12)
second = cell.int_value
# Put a double into a cell
cell = cells.get(0, 2)
cell.put_value(-1.234)
third = cell.double_value
# Put a formula into a cell
cell = cells.get("D1")
cell.formula = "=B1 + C1"
# Put a combined formula: "sum(average(b1,c1), b1)" to cell at b2
cell = cells.get("b2")
cell.formula = "=sum(average(b1,c1), b1)"
# Set style of a cell
style = cell.get_style()
# Set background color
style.background_color = Color.yellow
# Set format of a cell
style.font.name = "Courier New"
style.vertical_alignment = TextAlignmentType.TOP
cell.set_style(style)
Voir également
- module aspose.cells
- classe Cell
- classe Range
