PivotTable classe

PivotTable classe

Description sommaire pour PivotTable.

Le type PivotTable expose les membres suivants :

Propriétés

PropriétéDescription
is_excel_2003_compatibleSpécifie si le tableau croisé dynamique est compatible avec Excel2003 lors de l’actualisation du tableau croisé dynamique,
si vrai, une chaîne doit être inférieure ou égale à 255 caractères, donc si la chaîne est supérieure à 255 caractères,
il sera tronqué. si elle est fausse, une chaîne n’aura pas la restriction susmentionnée.
La valeur par défaut est vraie.
refreshed_by_whoObtient le nom de l’utilisateur qui a actualisé le tableau croisé dynamique pour la dernière fois
refresh_dateObtient la date à laquelle le tableau croisé dynamique a été actualisé pour la dernière fois.
pivot_table_style_nameObtient et définit le nom du style pivotant.
pivot_table_style_typeObtient et définit le style de tableau croisé dynamique intégré.
column_fieldsRenvoie un objet PivotFields actuellement affiché sous forme de champs de colonne.
row_fieldsRenvoie un objet PivotFields actuellement affiché sous forme de champs de ligne.
page_fieldsRenvoie un objet PivotFields actuellement affiché sous forme de champs de page.
data_fieldsObtient un objet PivotField qui représente tous les champs de données d’un tableau croisé dynamique.
En lecture seule. Il ne s’agirait que d’un init lorsqu’il y a deux champs de données ou plus dans DataPiovtFiels.
Il sert uniquement à ajouter DataPivotField à la zone de ligne/colonne du tableau croisé dynamique. La valeur par défaut est dans la zone de ligne.
data_fieldObtient un objet PivotField qui représente tous les champs de données d’un tableau croisé dynamique.
En lecture seule. Il ne s’agirait que d’un init lorsqu’il y a deux champs de données ou plus dans DataPiovtFiels.
Il sert uniquement à ajouter DataPivotField à la zone de ligne/colonne du tableau croisé dynamique. La valeur par défaut est dans la zone de ligne.
base_fieldsRenvoie un objet PivotFields qui inclut tous les champs du rapport de tableau croisé dynamique
pivot_filtersRenvoie un objet PivotFilterCollection.
column_rangeRenvoie un objet CellArea qui représente la plage
qui contient la zone de colonnes dans le rapport de tableau croisé dynamique. Lecture seulement.
row_rangeRenvoie un objet CellArea qui représente la plage
qui contient la zone de ligne dans le rapport de tableau croisé dynamique. Lecture seulement.
data_body_rangeRenvoie un objet CellArea qui représente la plage contenant la zone de données
dans la liste entre la ligne d’en-tête et la ligne d’insertion. Lecture seulement.
table_range1Renvoie un objet CellArea qui représente la plage contenant l’intégralité du rapport de tableau croisé dynamique,
mais n’inclut pas les champs de page. Lecture seulement.
table_range2Renvoie un objet CellArea qui représente la plage contenant l’intégralité du rapport de tableau croisé dynamique,
inclut les champs de page. Lecture seulement.
column_grandIndique si le rapport de tableau croisé dynamique affiche les totaux généraux des colonnes.
is_grid_drop_zonesIndique si le rapport de tableau croisé dynamique affiche une disposition de tableau croisé dynamique classique.
(permet de faire glisser les champs dans la grille)
row_grandIndique si le rapport de tableau croisé dynamique affiche les totaux généraux des lignes.
display_null_stringIndique si le rapport de tableau croisé dynamique affiche une chaîne personnalisée
dans les cellules contenant des valeurs nulles.
null_stringObtient la chaîne affichée dans les cellules contenant des valeurs nulles
lorsque la propriété DisplayNullString est vraie. La valeur par défaut est une chaîne vide.
display_error_stringIndique si le rapport de tableau croisé dynamique affiche une chaîne personnalisée dans les cellules contenant des erreurs.
data_field_header_nameObtient et définit le nom de l’en-tête du champ de zone de valeurs dans le tableau croisé dynamique.
error_stringObtient la chaîne affichée dans les cellules contenant des erreurs
lorsque la propriété DisplayErrorString est vraie. La valeur par défaut est une chaîne vide.
is_auto_formatIndique si le rapport de tableau croisé dynamique est automatiquement formaté.
Case à cocher “tableau de formatage automatique” qui est en option de tableau croisé dynamique pour Excel 2003
autofit_column_width_on_updateIndique si l’ajustement automatique de la largeur des colonnes lors de la mise à jour
auto_format_typeObtient le type de formatage automatique du tableau croisé dynamique.
has_blank_rowsIndique s’il faut ajouter des lignes vides.
Cette propriété s’applique uniquement aux types de formatage automatique de tableau croisé dynamique qui doivent ajouter des lignes vides.
merge_labelsIndique si l’élément de ligne externe, l’élément de colonne, le sous-total, le rapport de tableau croisé dynamique spécifié.
et les étiquettes de total général utilisent des cellules fusionnées.
preserve_formattingIndique si la mise en forme est conservée lorsque le tableau croisé dynamique est actualisé ou recalculé.
show_drillObtient si les boutons développer/réduire sont affichés.
enable_drilldownObtient si l’exploration en profondeur est activée.
enable_field_dialogIndique si la boîte de dialogue Champ de tableau croisé dynamique est disponible
lorsque l’utilisateur double-clique sur le champ du tableau croisé dynamique.
enable_field_listObtient si la liste de champs est activée pour le tableau croisé dynamique.
enable_wizardIndique si l’Assistant Tableau croisé dynamique est disponible.
subtotal_hidden_page_itemsIndique si les éléments de champ de page masqués dans le rapport de tableau croisé dynamique
sont inclus dans les sous-totaux de ligne et de colonne, les totaux de bloc et les totaux généraux.
La valeur par défaut est Faux.
grand_total_nameRenvoie l’étiquette de chaîne de texte affichée dans l’en-tête de colonne ou de ligne du total général.
La valeur par défaut est la chaîne « Grand Total ».
manual_updateIndique si le rapport de tableau croisé dynamique est recalculé uniquement à la demande de l’utilisateur.
is_multiple_field_filtersSpécifie une valeur booléenne qui indique si les champs d’un tableau croisé dynamique peuvent avoir plusieurs filtres définis.
missing_items_limitSpécifie une valeur booléenne qui indique si les champs d’un tableau croisé dynamique peuvent avoir plusieurs filtres définis.
enable_data_value_editingSpécifie une valeur booléenne qui indique si l’utilisateur est autorisé à modifier les cellules de la zone de données du tableau croisé dynamique.
Activer la modification des cellules dans la zone des valeurs
show_data_tipsSpécifie une valeur booléenne qui indique si les info-bulles doivent être affichées pour les cellules de données de tableau croisé dynamique.
show_member_property_tipsSpécifie une valeur booléenne qui indique si les informations sur les propriétés des membres doivent être omises des info-bulles du tableau croisé dynamique.
show_values_rowSpécifie une valeur booléenne qui indique si la ligne des valeurs est affichée.
afficher la ligne des valeurs
show_empty_colSpécifie une valeur booléenne qui indique s’il faut inclure des colonnes vides dans le tableau
show_empty_rowSpécifie une valeur booléenne qui indique s’il faut inclure des lignes vides dans le tableau.
field_list_sort_ascendingSpécifie une valeur booléenne qui indique si les champs du tableau croisé dynamique sont triés dans un ordre différent de celui par défaut dans la liste des champs.
print_drillSpécifie une valeur booléenne qui indique si les indicateurs d’exploration doivent être imprimés.
imprimer les boutons d’agrandissement/réduction lorsqu’ils sont affichés sur la table pivotante.
alt_text_titleObtient le titre de l’altertext
alt_text_descriptionObtient la description du texte alternatif
nameObtient le nom du tableau croisé dynamique
column_header_captionObtient la légende de l’en-tête de colonne du tableau croisé dynamique.
indentSpécifie l’incrément d’indentation pour l’axe compact et peut être utilisé pour définir la présentation du rapport sur Forme compacte.
row_header_captionObtient la légende de l’en-tête de ligne du tableau croisé dynamique.
show_row_header_captionIndique si la légende de l’en-tête de ligne est affichée dans le rapport de tableau croisé dynamique
Indique si Afficher les légendes des champs et les listes déroulantes des filtres
custom_list_sortIndique s’il faut prendre en compte la liste personnalisée intégrée lors du tri des données
pivot_format_conditionsObtient les conditions de format du tableau croisé dynamique.
page_field_orderObtient l’ordre dans lequel les champs de page sont ajoutés à la présentation du rapport de tableau croisé dynamique.
page_field_wrap_countObtient le nombre de champs de page dans chaque colonne ou ligne du rapport de tableau croisé dynamique.
tagObtient une chaîne enregistrée avec le rapport de tableau croisé dynamique.
save_dataIndique si les données du rapport de tableau croisé dynamique sont enregistrées avec le classeur.
refresh_data_on_opening_fileIndique si Actualiser les données lors de l’ouverture du fichier.
refresh_data_flagIndique si les données sont actualisées ou non.
external_connection_data_sourceObtient la source de données de connexion externe.
data_sourceObtient et définit la source de données du tableau croisé dynamique.
pivot_formatsObtient la collection de formats appliqués au tableau croisé dynamique.
item_print_titlesUn bit qui spécifie si les légendes des éléments pivots sur l’axe des lignes
sont répétés sur chaque page imprimée pour les champs pivots sous forme de tableau.
print_titlesIndique si les titres à imprimer de la feuille de calcul sont définis en fonction
sur le rapport de tableau croisé dynamique. La valeur par défaut est fausse.
display_immediate_itemsIndique si les éléments des zones de ligne et de colonne sont visibles
lorsque la zone de données du tableau croisé dynamique est vide. La valeur par défaut est vraie.
is_selectedIndique si le tableau croisé dynamique est sélectionné.
show_pivot_style_row_headerIndique si le style doit être appliqué à l’en-tête de ligne du tableau croisé dynamique.
show_pivot_style_column_headerIndique si l’en-tête de colonne du tableau croisé dynamique doit avoir le style appliqué.
show_pivot_style_row_stripesIndique si le formatage des bandes de lignes est appliqué.
show_pivot_style_column_stripesIndique si la mise en forme des bandes de colonnes est appliquée.
show_pivot_style_last_columnIndique si la mise en forme des bandes de colonnes est appliquée.

Méthodes

MéthodeDescription
remove_fieldSupprime un champ d’une zone de champ spécifique
remove_fieldSupprime un champ d’une zone de champ spécifique
remove_fieldSupprimer le champ d’une zone de champ spécifique
add_field_to_areaAjoute le champ à la zone spécifique.
add_field_to_areaAjoute le champ à la zone spécifique.
add_field_to_areaAjoute le champ à la zone spécifique.
add_calculated_fieldAjoute un champ calculé au champ pivot.
add_calculated_fieldAjoute un champ calculé au champ pivot et faites-le glisser vers la zone de données.
moveDéplace le tableau croisé dynamique vers un autre emplacement dans la feuille de calcul.
moveDéplace le tableau croisé dynamique vers un autre emplacement dans la feuille de calcul.
formatFormate la zone sélectionnée du tableau croisé dynamique.
formatFormater la cellule dans la zone pivotante
set_auto_group_fieldDéfinit le groupe de champs automatique par le tableau croisé dynamique.
set_auto_group_fieldDéfinit le groupe de champs automatique par le tableau croisé dynamique.
set_manual_group_fieldDéfinit le groupe de champs manuel par le tableau croisé dynamique.
set_manual_group_fieldDéfinit le groupe de champs manuel par le tableau croisé dynamique.
set_manual_group_fieldDéfinit le groupe de champs manuel par le tableau croisé dynamique.
set_manual_group_fieldDéfinit le groupe de champs manuel par le tableau croisé dynamique.
set_ungroupDéfinit le dissociation par le tableau croisé dynamique
set_ungroupDéfinit le dissociation par le tableau croisé dynamique
copy_styleCopie le style nommé à partir d’un autre tableau croisé dynamique.
show_report_filter_pageAfficher toutes les pages de filtre du rapport selon PivotField, le PivotField doit être situé dans les PageFields.
show_report_filter_page_by_nameAfficher toutes les pages de filtre du rapport en fonction du nom de PivotField, le PivotField doit être situé dans les PageFields.
show_report_filter_page_by_indexAfficher toutes les pages de filtre du rapport en fonction de l’index de position dans les PageFields
fieldsObtient les champs spécifiques par type de champ.
change_data_sourceDéfinissez les données sources du tableau croisé dynamique.
Feuille 1 ! $A$1 : $C$3
get_sourceObtenez les données sources du tableau croisé dynamique.
refresh_dataActualise les données et les paramètres du tableau croisé dynamique à partir de sa source de données.
calculate_dataCalcule les données du tableau croisé dynamique en cellules.
clear_dataEffacer les données et le formatage du tableau croisé dynamique
calculate_rangeCalcule la plage du tableau croisé dynamique.
format_allFormater toutes les cellules de la zone pivotante
format_rowFormatez les données de la ligne dans la zone du tableau croisé dynamique
get_horizontal_breaksobtenir la liste d’index des lignes du tableau croisé dynamique des sauts de page horizontaux
show_in_compact_formPrésente le tableau croisé dynamique sous forme compacte.
show_in_outline_formPrésente le tableau croisé dynamique sous forme de plan.
show_in_tabular_formPrésente le tableau croisé dynamique sous forme de tableau.
get_cell_by_display_nameObtient l’objet Cell sous le nom d’affichage PivotField.
get_childrenObtient les tableaux croisés dynamiques enfants qui utilisent ces données de tableau croisé dynamique comme source de données.

Exemple

from aspose.cells import FormatConditionType, OperatorType, Workbook
from aspose.cells.pivot import PivotFieldType, PivotFilterType, PivotTableStyleType
from aspose.pydrawing import Color

book = Workbook()
sheet = book.worksheets[0]
cells = sheet.cells
cells.get(0, 0).value = "fruit"
cells.get(1, 0).value = "grape"
cells.get(2, 0).value = "blueberry"
cells.get(3, 0).value = "kiwi"
cells.get(4, 0).value = "cherry"
cells.get(5, 0).value = "grape"
cells.get(6, 0).value = "blueberry"
cells.get(7, 0).value = "kiwi"
cells.get(8, 0).value = "cherry"
cells.get(0, 1).value = "year"
cells.get(1, 1).value = 2020
cells.get(2, 1).value = 2020
cells.get(3, 1).value = 2020
cells.get(4, 1).value = 2020
cells.get(5, 1).value = 2021
cells.get(6, 1).value = 2021
cells.get(7, 1).value = 2021
cells.get(8, 1).value = 2021
cells.get(0, 2).value = "amount"
cells.get(1, 2).value = 50
cells.get(2, 2).value = 60
cells.get(3, 2).value = 70
cells.get(4, 2).value = 80
cells.get(5, 2).value = 90
cells.get(6, 2).value = 100
cells.get(7, 2).value = 110
cells.get(8, 2).value = 120
pivots = sheet.pivot_tables
pivotIndex = pivots.add("=Sheet1!A1:C9", "A12", "TestPivotTable")
pivot = pivots[pivotIndex]
pivot.add_field_to_area(PivotFieldType.ROW, "fruit")
pivot.add_field_to_area(PivotFieldType.COLUMN, "year")
pivot.add_field_to_area(PivotFieldType.DATA, "amount")
pivot.pivot_table_style_type = PivotTableStyleType.PIVOT_TABLE_STYLE_MEDIUM10
# Change PivotField's attributes
rowField = pivot.row_fields[0]
rowField.display_name = "custom display name"
# Add PivotFilter
index = pivot.pivot_filters.add(0, PivotFilterType.COUNT)
filter = pivot.pivot_filters[index]
filter.auto_filter.filter_top10(0, False, False, 2)
# Add PivotFormatCondition
formatIndex = pivot.pivot_format_conditions.add()
pfc = pivot.pivot_format_conditions[formatIndex]
fcc = pfc.format_conditions
fcc.add_area(pivot.data_body_range)
idx = fcc.add_condition(FormatConditionType.CELL_VALUE)
fc = fcc[idx]
fc.formula1 = "100"
fc.operator = OperatorType.GREATER_OR_EQUAL
fc.style.background_color = Color.red
pivot.refresh_data()
pivot.calculate_data()
# do your business
book.save("out.xlsx")

Voir également