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 (base zéro) de la cellule.
column	Obtient le numéro de colonne (base zéro) de la cellule.
is_formula	Représente 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 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 la 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 lors de la copie d’une cellule sous forme de texte (comme copier la cellule dans un éditeur de texte ou exporter 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 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 celui par défaut hérité à 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 au format local 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 matricielle dynamique (true) ou une formule matricielle héritée (false).
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 cellule fait partie d’une 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/définit la valeur contenue dans cette cellule.
is_style_set	Indique si le style de la cellule est défini. Si 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	Récupère 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.
embedded_image	Obtient et définit l’image intégrée dans la cellule.

Méthodes

Méthode	Description
put_value	Met une valeur booléenne dans la cellule.
put_value	Met une valeur entière dans la cellule.
put_value	Met une valeur double dans la cellule.
put_value	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	Place 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	Place une valeur de chaîne dans la cellule.
put_value	Place une valeur DateTime dans la cellule.
put_value	Place 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	Obtient le style d’affichage de la cellule. Si la cellule est mise en forme conditionnellement, le style d’affichage n’est pas le même que celui de cell.GetStyle().
get_style	Obtient le style de cellule.
get_style	Si checkBorders est vrai, vérifiez si les bordures des autres cellules affecteront le style de cette cellule.
set_style	Définit le style de cellule.
set_style	Appliquez la propriété modifiée de style à la cellule.
set_style	Appliquez le style de cellule en fonction des indicateurs.
set_formula	Définissez la formule et la valeur (résultat calculé) de la formule.
set_formula	Définissez la formule et la valeur de la formule.
set_formula	Définissez la formule et la valeur (résultat calculé) de la formule.
set_array_formula	Définit une formule matricielle sur une plage de cellules.
set_array_formula	Définit une formule matricielle (ancienne formule matricielle saisie via CTRL+SHIFT+ENTER dans ms Excel) sur une plage de cellules.
set_array_formula	Définit une formule matricielle sur une plage de cellules.
set_array_formula	Définit une formule matricielle sur une plage de cellules.
set_shared_formula	Définit une formule sur une plage de cellules.
set_shared_formula	Définit les formules partagées sur une plage de cellules.
set_shared_formula	Définit les formules partagées sur une plage de cellules.
set_shared_formula	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	Obtenez toutes les cellules qui seront mises à jour lorsque cette cellule sera modifiée.
set_dynamic_array_formula	Définit la formule matricielle dynamique et fait en sorte que la formule se répande dans les cellules voisines si possible.
set_dynamic_array_formula	Définit la formule matricielle dynamique et fait en sorte que la formule se répande dans les cellules voisines si possible.
set_dynamic_array_formula	Définit la formule matricielle dynamique et fait en sorte que la formule se répande dans les cellules voisines si possible.
set_table_formula	Créez un tableau de données à deux variables pour une plage donnée à partir de cette cellule.
set_table_formula	Créez un tableau de données à une variable pour une plage donnée à partir de cette cellule.
set_table_formula	Créez un tableau de données à deux variables pour une plage donnée à partir de cette cellule.
set_table_formula	Créez un tableau de données à une variable pour une plage donnée à partir de cette cellule.
get_characters	Renvoie tous les objets Personnages qui représente une plage de caractères dans le texte de la cellule.
get_characters	Renvoie tous les objets Personnages qui représente une plage de caractères dans le texte de la cellule.
calculate	Calcule la formule de la cellule.
get_string_value	Obtient la valeur de chaîne par 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	Obtenez la formule de cette cellule.
get_precedents	Obtient toutes les références apparaissant dans la formule de cette cellule.
get_dependents	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 actuel) utilisés par la formule de cette cellule lors de son calcul.
get_dependents_in_calculation	Obtient toutes les cellules dont le résultat calculé dépend de cette cellule.
get_array_range	Obtient la plage du tableau si la formule de la cellule est une formule matricielle.
remove_array_formula	Supprimez la formule matricielle.
copy	Copie les données d’une cellule source.
characters	Renvoie un objet Characters qui représente une plage de caractères dans le texte de la cellule.
replace	Remplacez le texte de la cellule par des options.
insert_text	Insérez quelques caractères dans la cellule. Si la cellule est richement formatée, cette méthode peut conserver la mise en forme d’origine.
is_rich_text	Indique si la valeur de chaîne de cette cellule est un texte au format enrichi.
set_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	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	Vérifie si cet objet fait référence à la même cellule avec un autre objet 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 le tableau 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