Cell classe
Cell classe
Encapsule l’objet qui représente une seule cellule du 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 (à partir de zéro) de la cellule. |
| column | Obtient le numéro de colonne (à partir de zéro) de la cellule. |
| is_formula | Représente si la cellule spécifiée contient une formule. |
| has_custom_function | Vérifie s’il existe une fonction personnalisée (fonction non prise en charge) dans la formule de cette cellule. |
| 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 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, renvoie 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 la cellule formatée est la même que celle que vous pouvez obtenir à partir d’Excel lorsque vous copiez une cellule sous forme de texte (par exemple (copie de 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 du formatage numérique de cette cellule. |
| display_string_value | Obtient la valeur de chaîne formatée 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 possède des paramètres de style personnalisés (différents de ceux par défaut hérités) à partir 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 par les paramètres régionaux 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 une 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 de tableau dynamique (vrai) ou une formule de tableau héritée (faux). |
| is_array_formula | Indique si la formule de cellule est une formule matricielle. |
| is_in_array | Indique si la formule de cellule est une formule matricielle. |
| is_shared_formula | Indique si la formule de la cellule fait partie d’une formule partagée. |
| is_table_formula | Indique si cette cellule fait partie d’une formule de tableau. |
| is_in_table | Indique si cette cellule fait partie d’une formule de tableau. |
| value | Obtient/définit la valeur contenue dans cette cellule. |
| is_style_set | Indique si le style de la cellule est défini. Si la valeur est « false », cela signifie que la cellule possède un format 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. |
| is_check_box_style | Indique si cette cellule doit être définie comme une case à cocher. |
| embedded_image | Obtient et définit l’image intégrée dans la cellule. |
Méthodes
| Méthode | Description |
|---|---|
put_value(self, bool_value) | Place une valeur booléenne dans la cellule. |
put_value(self, int_value) | Met une valeur entière dans la cellule. |
put_value(self, double_value) | Met une valeur double dans la cellule. |
put_value(self, string_value, is_converted, set_style) | Place une valeur dans la cellule, si nécessaire, la valeur sera convertie en un autre type de données et le format numérique de la cellule sera réinitialisé. |
put_value(self, string_value, is_converted) | Place une valeur de chaîne dans la cellule et convertit la valeur en un autre type de données si approprié. |
put_value(self, string_value) | Place une valeur de chaîne dans la cellule. |
put_value(self, date_time) | Place une valeur DateTime dans la cellule. |
put_value(self, object_value) | Place une valeur d’objet dans la cellule. |
get_display_style(self) | Obtient le style d’affichage de cette cellule. |
get_display_style(self, include_merged_borders) | Obtient le style d’affichage de cette cellule. |
get_display_style(self, adjacent_borders) | Obtient le style d’affichage de cette cellule. |
get_style(self) | Obtient le style de cellule. |
get_style(self, check_borders) | Si checkBorders est vrai, vérifiez si les bordures des autres cellules affecteront le style de cette cellule. |
set_style(self, style) | Définit le style de cellule. |
set_style(self, style, explicit_flag) | Appliquez la propriété modifiée du style à la cellule. |
set_style(self, style, flag) | Appliquer le style de cellule en fonction des indicateurs. |
set_formula(self, formula, value) | Définissez la formule et la valeur (résultat calculé) de la formule. |
set_formula(self, formula, options) | Définissez la formule et la valeur (résultat calculé) de la formule. |
set_formula(self, formula, is_r1c1, is_local, value) | Définissez la formule et la valeur de la formule. |
set_formula(self, formula, options, value) | Définissez la formule et la valeur (résultat calculé) de la formule. |
set_array_formula(self, array_formula, row_number, column_number, is_r1c1, is_local) | Définit une formule matricielle sur une plage de cellules. |
set_array_formula(self, array_formula, row_number, column_number) | Définit une formule de tableau (formule de tableau héritée saisie via CTRL+MAJ+ENTRÉE dans MS Excel) sur une plage de cellules. |
set_array_formula(self, array_formula, row_number, column_number, options) | Définit une formule matricielle sur une plage de cellules. |
set_array_formula(self, array_formula, row_number, column_number, options, values) | Définit une formule matricielle sur une plage de cellules. |
set_shared_formula(self, shared_formula, row_number, column_number, is_r1c1, is_local) | Définit une formule sur une plage de cellules. |
set_shared_formula(self, shared_formula, row_number, column_number) | Définit des formules partagées sur une plage de cellules. |
set_shared_formula(self, shared_formula, row_number, column_number, options) | Définit des formules partagées sur une plage de cellules. |
set_shared_formula(self, shared_formula, row_number, column_number, options, values) | Définit des formules partagées sur une plage de cellules. |
get_leafs(self) | 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(self, recursive) | Obtenez toutes les cellules qui seront mises à jour lorsque cette cellule est modifiée. |
set_dynamic_array_formula(self, array_formula, options, calculate_value) | Définit une formule de tableau dynamique et fait en sorte que la formule se répande dans les cellules voisines si possible. |
set_dynamic_array_formula(self, array_formula, options, values, calculate_range, calculate_value) | Définit une formule de tableau dynamique et fait en sorte que la formule se répande dans les cellules voisines si possible. |
set_dynamic_array_formula(self, array_formula, options, values, calculate_range, calculate_value, copts) | Définit une formule de tableau dynamique et fait en sorte que la formule se répande dans les cellules voisines si possible. |
set_table_formula(self, row_number, column_number, row_input_cell, column_input_cell, values) | Créez un tableau de données à deux variables pour une plage donnée à partir de cette cellule. |
set_table_formula(self, row_number, column_number, input_cell, is_row_input, values) | Créez un tableau de données à une variable pour une plage donnée à partir de cette cellule. |
set_table_formula(self, 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 un tableau de données à deux variables pour une plage donnée à partir de cette cellule. |
set_table_formula(self, row_number, column_number, row_index_of_input_cell, column_index_of_input_cell, is_row_input, values) | Créez un tableau de données à une variable pour une plage donnée à partir de cette cellule. |
get_characters(self) | Renvoie tous les objets Characters qui représente une plage de caractères dans le texte de la cellule. |
get_characters(self, flag) | Renvoie tous les objets Characters qui représente une plage de caractères dans le texte de la cellule. |
calculate(self, options) | Calcule la formule de la cellule. |
get_string_value(self, format_strategy) | Obtient la valeur de la chaîne par une stratégie formatée spécifique. |
get_width_of_value(self) | Obtient la largeur de la valeur en unité de pixels. |
get_height_of_value(self) | Obtient la hauteur de la valeur en unité de pixels. |
get_format_conditions(self) | Obtient les conditions de format qui s’appliquent à cette cellule. |
get_formula(self, is_r1c1, is_local) | Obtenez la formule de cette cellule. |
get_precedents(self) | Obtient toutes les références apparaissant dans la formule de cette cellule. |
get_dependents(self, is_all) | Obtenez toutes les cellules dont la formule fait directement référence à cette cellule. |
get_precedents_in_calculation(self) | Obtient tous les précédents (référence aux cellules du classeur actuel) utilisés par la formule de cette cellule lors de son calcul. |
get_dependents_in_calculation(self, recursive) | Obtient toutes les cellules dont le résultat calculé dépend de cette cellule. |
get_array_range(self) | Obtient la plage du tableau si la formule de la cellule est une formule de tableau. |
remove_array_formula(self, leave_normal_formula) | Supprimer la formule matricielle. |
copy(self, cell) | Copie les données d’une cellule source. |
characters(self, start_index, length) | Renvoie un objet Characters qui représente une plage de caractères dans le texte de la cellule. |
replace(self, place_holder, new_value, options) | Remplacer le texte de la cellule par des options. |
insert_text(self, index, text) | Insérez quelques caractères dans la cellule. Si la cellule est au format riche, cette méthode peut conserver le formatage d’origine. |
is_rich_text(self) | Indique si la valeur de chaîne de cette cellule est un texte au format enrichi. |
set_characters(self, characters) | Définit le format de texte enrichi de la cellule. |
get_merged_range(self) | Renvoie un objet Range qui représente une plage fusionnée. |
get_html_string(self, html5) | Obtient la chaîne HTML qui contient les données et certains formats dans cette cellule. |
to_json(self) | Convertissez les données de structure Cell en JSON. |
equals(self, cell) | Vérifie si cet objet fait référence à la même cellule qu’un autre objet cellule. |
get_conditional_formatting_result(self) | Obtenez le résultat de la mise en forme conditionnelle. |
get_validation(self) | Obtient la validation appliquée à cette cellule. |
get_validation_value(self) | Obtient la valeur de validation appliquée à cette cellule. |
get_table(self) | Obtient le tableau qui contient cette cellule. |
get_rich_value(self) | Obtient la valeur riche de la 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
