PivotTable classe
PivotTable classe
Description sommaire pour PivotTable.
Le type PivotTable expose les membres suivants :
Propriétés
| Propriété | Description |
|---|---|
| is_excel_2003_compatible | Spécifie si le tableau croisé dynamique est compatible avec Excel 2003 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 faux, une chaîne n’aura pas la restriction susmentionnée. La valeur par défaut est vrai. |
| refreshed_by_who | Obtient le nom du dernier utilisateur qui a actualisé ce tableau croisé dynamique |
| refresh_date | Obtient la dernière date et heure à laquelle le tableau croisé dynamique a été actualisé. |
| pivot_table_style_name | Obtient et définit le nom du style du tableau croisé dynamique. |
| pivot_table_style_type | Obtient et définit le style de tableau croisé dynamique intégré. |
| column_fields | Renvoie un objet PivotFields qui sont actuellement affichés sous forme de champs de colonne. |
| row_fields | Renvoie un objet PivotFields qui sont actuellement affichés sous forme de champs de ligne. |
| page_fields | Renvoie un objet PivotFields qui sont actuellement affichés comme champs de page. |
| data_fields | Obtient un objet PivotField qui représente tous les champs de données d’un tableau croisé dynamique. Lecture seule. Il ne sera initialisé que lorsqu’il y a deux champs de données ou plus dans les DataPiovtFiels. Il sert uniquement à ajouter un champ DataPivotField à la zone de ligne/colonne du tableau croisé dynamique. La valeur par défaut est dans la zone de ligne. |
| data_field | Obtient un objet PivotField qui représente tous les champs de données dans un tableau croisé dynamique.Lecture seule. Il ne sera créé que lorsqu’il y a deux champs de données ou plus dans la région Données. Par défaut, il se trouve dans la zone de ligne. Vous pouvez le faire glisser vers la zone de ligne/colonne avec la méthode PivotTable.AddFieldToArea(). |
| base_fields | Renvoie tous les champs de pivot de base dans le tableau croisé dynamique. |
| pivot_filters | Renvoie tous les filtres des champs croisés dynamiques dans le tableau croisé dynamique. |
| column_range | Renvoie un objet CellArea qui représente la plage qui contient la zone de colonne dans le rapport de tableau croisé dynamique. Lecture seule. |
| row_range | Renvoie un objet CellArea qui représente la plage qui contient la zone de ligne dans le rapport de tableau croisé dynamique. Lecture seule. |
| data_body_range | Renvoie un objet CellArea qui représente la plage qui contient la zone de donnéesdans la liste entre la ligne d’en-tête et la ligne d’insertion. Lecture seule. |
| table_range1 | Renvoie 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 seule. |
| table_range2 | Renvoie un objet CellArea qui représente la plage contenant l’intégralité du rapport de tableau croisé dynamique, inclut les champs de page. Lecture seule. |
| is_grid_drop_zones | Indique si le rapport de tableau croisé dynamique affiche une disposition de tableau croisé dynamique classique. (permet de faire glisser les champs dans la grille) |
| show_column_grand_totals | Indique s’il faut afficher les totaux généraux pour les colonnes de ce tableau croisé dynamique. |
| show_row_grand_totals | Indique s’il faut afficher les totaux généraux pour les lignes du tableau croisé dynamique. |
| column_grand | Indique si le rapport de tableau croisé dynamique affiche les totaux généraux des colonnes. |
| row_grand | Indique s’il faut afficher les totaux généraux pour les lignes de ce tableau croisé dynamique. |
| display_null_string | Indique si le rapport de tableau croisé dynamique affiche une chaîne personnalisée si la valeur est nulle. |
| null_string | Obtient 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_string | Indique si le rapport de tableau croisé dynamique affiche une chaîne personnalisée dans les cellules contenant des erreurs. |
| data_field_header_name | Obtient et définit le nom de l’en-tête du champ de zone de valeur dans le tableau croisé dynamique. |
| error_string | Obtient 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_format | Indique si le rapport de tableau croisé dynamique est automatiquement formaté. Case à cocher « Mise en forme automatique du tableau » qui se trouve dans l’option de tableau croisé dynamique pour Excel 2003 |
| autofit_column_width_on_update | Indique si la largeur de colonne est ajustée automatiquement lors de la mise à jour |
| auto_format_type | Obtient et définit le type de format automatique du tableau croisé dynamique. |
| has_blank_rows | Indique s’il faut ajouter des lignes vides. Cette propriété s’applique uniquement aux types de format automatique de tableau croisé dynamique qui doivent ajouter des lignes vides. |
| merge_labels | Vrai si les étiquettes d’élément de ligne externe, d’élément de colonne, de sous-total et de total général du rapport de tableau croisé dynamique spécifié utilisent des cellules fusionnées. |
| preserve_formatting | Indique si la mise en forme est conservée lorsque le tableau croisé dynamique est actualisé ou recalculé. |
| show_drill | Obtient et définit si les boutons de développement/réduction doivent être affichés. |
| enable_drilldown | Obtient si l’exploration en profondeur est activée. |
| enable_field_dialog | Indique 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_list | Indique si la liste des champs du tableau croisé dynamique est disponible dans la vue Excel. |
| enable_wizard | Indique si l’Assistant Tableau croisé dynamique est disponible. |
| subtotal_hidden_page_items | Indique 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 False. |
| grand_total_name | Renvoie l’étiquette qui s’affiche dans l’en-tête de la colonne ou de la ligne du total général. La valeur par défaut est la chaîne « Grand Total ». |
| manual_update | Indique si le rapport de tableau croisé dynamique est recalculé uniquement à la demande de l’utilisateur. |
| is_multiple_field_filters | Spécifie une valeur booléenne qui indique si les champs d’un tableau croisé dynamique peuvent avoir plusieurs filtres définis sur eux. |
| allow_multiple_filters_per_field | Spécifie une valeur booléenne qui indique si les champs d’un tableau croisé dynamique peuvent avoir plusieurs filtres définis sur eux. |
| missing_items_limit | Spécifie une valeur booléenne qui indique si les champs d’un tableau croisé dynamique peuvent avoir plusieurs filtres définis sur eux. |
| enable_data_value_editing | Spécifie une valeur booléenne qui indique si l’utilisateur est autorisé à modifier les cellules dans la zone de données du tableau croisé dynamique. Activer l’édition des cellules dans la zone des valeurs |
| show_data_tips | Spécifie une valeur booléenne qui indique si les info-bulles doivent être affichées pour les cellules de données du tableau croisé dynamique. |
| show_member_property_tips | Spé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_row | Indique si la ligne de valeurs est affichée. |
| show_empty_col | Indique s’il faut inclure des colonnes vides dans le tableau |
| show_empty_row | Indique s’il faut inclure des lignes vides dans le tableau. |
| field_list_sort_ascending | Indique si les champs du tableau croisé dynamique sont triés dans un ordre autre que celui par défaut dans la liste des champs. |
| print_drill | Spécifie une valeur booléenne qui indique si les indicateurs de forage doivent être imprimés. imprimer les boutons développer/réduire lorsqu’ils sont affichés sur un tableau croisé dynamique. |
| alt_text_title | Obtient et définit le titre du texte de modification. |
| alt_text_description | Obtient la description du texte alternatif. |
| name | Obtient le nom du tableau croisé dynamique |
| column_header_caption | Obtient la légende de l’en-tête de colonne du tableau croisé dynamique. |
| indent | Spécifie l’incrément d’indentation pour l’axe compact et peut être utilisé pour définir la mise en page du rapport sur Format compact. |
| row_header_caption | Obtient la légende de l’en-tête de ligne du tableau croisé dynamique. |
| show_row_header_caption | Indique si la légende de l’en-tête de ligne est affichée dans le rapport de tableau croisé dynamique Indique si les légendes des champs d’affichage et les listes déroulantes des filtres doivent être affichées |
| custom_list_sort | Indique si la liste personnalisée intégrée doit être prise en compte lors du tri des données |
| pivot_format_conditions | Obtient les conditions de format du tableau croisé dynamique. |
| conditional_formats | Obtient les formats conditionnels du tableau croisé dynamique. |
| page_field_order | Obtient et définit l’ordre dans lequel les champs de page sont ajoutés à la mise en page du rapport de tableau croisé dynamique. |
| page_field_wrap_count | Obtient le nombre de champs de page dans chaque colonne ou ligne du rapport de tableau croisé dynamique. |
| tag | Obtient une chaîne enregistrée avec le rapport de tableau croisé dynamique. |
| save_data | Indique si les données du rapport de tableau croisé dynamique sont enregistrées avec le classeur. |
| refresh_data_on_opening_file | Indique si les données doivent être actualisées lors de l’ouverture du fichier. |
| refresh_data_flag | Indique si les données sont actualisées ou non. |
| source_type | Obtient le type de source de données du tableau croisé dynamique. |
| external_connection_data_source | Obtient la source de données de connexion externe. |
| data_source | Obtient et définit la source de données du tableau croisé dynamique. |
| pivot_formats | Obtient la collection de formats appliqués au tableau croisé dynamique. |
| item_print_titles | Indique si les noms des éléments croisés dynamiques doivent être répétés en haut de chaque page imprimée. |
| repeat_items_on_each_printed_page | Indique si les légendes des éléments pivot sur la zone de ligne sont répétées sur chaque page imprimée pour les champs pivot sous forme de tableau. |
| print_titles | Indique si les titres d’impression de la feuille de calcul sont définis en fonction dans le rapport de tableau croisé dynamique. La valeur par défaut est false. |
| display_immediate_items | Indique si les éléments dans les 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 « true ». |
| is_selected | Indique si ce tableau croisé dynamique est sélectionné. |
| show_pivot_style_row_header | Indique si le style doit être appliqué à l’en-tête de ligne du tableau croisé dynamique. |
| show_pivot_style_column_header | Indique si l’en-tête de colonne du tableau croisé dynamique doit avoir le style appliqué. |
| show_pivot_style_row_stripes | Indique si le formatage des bandes de lignes est appliqué. |
| show_pivot_style_column_stripes | Indique si la mise en forme des bandes est appliquée à la colonne. |
| show_pivot_style_last_column | Indique si la mise en forme de la colonne est appliquée. |
Méthodes
| Méthode | Description |
|---|---|
remove_field(self, field_type, field_name) | Supprime un champ d’une zone de champ spécifique |
remove_field(self, field_type, base_field_index) | Supprime un champ d’une zone de champ spécifique |
remove_field(self, field_type, pivot_field) | Supprimer le champ d’une zone de champ spécifique |
add_field_to_area(self, field_type, field_name) | Ajoute le champ à la zone spécifique. |
add_field_to_area(self, field_type, base_field_index) | Ajoute le champ à la zone spécifique. |
add_field_to_area(self, field_type, pivot_field) | Ajoute le champ à la zone spécifique. |
add_calculated_field(self, name, formula, drag_to_data_area) | Ajoute un champ calculé au champ pivot. |
add_calculated_field(self, name, formula) | Ajoute un champ calculé au champ pivot et le fait glisser vers la zone de données. |
move(self, row, column) | Déplace le tableau croisé dynamique vers un autre emplacement dans la feuille de calcul. |
move(self, dest_cell_name) | Déplace le tableau croisé dynamique vers un autre emplacement dans la feuille de calcul. |
move_to(self, row, column) | Déplace le tableau croisé dynamique vers un autre emplacement dans la feuille de calcul. |
move_to(self, dest_cell_name) | Déplace le tableau croisé dynamique vers un autre emplacement dans la feuille de calcul. |
get_source(self) | Obtenez les données sources du tableau croisé dynamique. |
get_source(self, is_original) | Obtenez les données sources du tableau croisé dynamique. |
refresh_data(self) | Actualise les données et les paramètres du tableau croisé dynamique à partir de sa source de données. |
refresh_data(self, option) | Actualise les données et les paramètres du tableau croisé dynamique à partir de sa source de données avec des options. |
calculate_data(self) | Calcule les données du tableau croisé dynamique en cellules. |
calculate_data(self, option) | Calcul des tableaux croisés dynamiques avec options |
format(self, pivot_area, style) | Formate la zone sélectionnée du tableau croisé dynamique. |
format(self, ca, style) | Formate la zone sélectionnée du tableau croisé dynamique. |
format(self, row, column, style) | Formater la cellule dans la zone du tableau croisé dynamique |
set_auto_group_field(self, base_field_index) | Définit le groupe de champs automatique par le tableau croisé dynamique. |
set_auto_group_field(self, pivot_field) | Définit le groupe de champs automatique par le tableau croisé dynamique. |
set_manual_group_field(self, base_field_index, start_val, end_val, group_by_list, interval_num) | Définit le groupe de champs manuel par le tableau croisé dynamique. |
set_manual_group_field(self, pivot_field, start_val, end_val, group_by_list, interval_num) | Définit le groupe de champs manuel par le tableau croisé dynamique. |
set_manual_group_field(self, base_field_index, start_val, end_val, group_by_list, interval_num) | Définit le groupe de champs manuel par le tableau croisé dynamique. |
set_manual_group_field(self, pivot_field, start_val, end_val, group_by_list, interval_num) | Définit le groupe de champs manuel par le tableau croisé dynamique. |
set_ungroup(self, base_field_index) | Ensembles dégroupés par le tableau croisé dynamique |
set_ungroup(self, pivot_field) | Ensembles dégroupés par le tableau croisé dynamique |
copy_style(self, pivot_table) | Copie le style nommé à partir d’un autre tableau croisé dynamique. |
show_report_filter_page(self, page_field) | Afficher toutes les pages de filtre de rapport en fonction du champ croisé dynamique, le champ croisé dynamique doit être situé dans les champs de page. |
show_report_filter_page_by_name(self, field_name) | Afficher toutes les pages de filtre de rapport en fonction du nom du champ croisé dynamique, le champ croisé dynamique doit être situé dans les champs de page. |
show_report_filter_page_by_index(self, pos_index) | Afficher toutes les pages de filtre de rapport en fonction de l’index de position dans les champs de page |
get_fields(self, field_type) | Obtient la liste des champs pivot spécifiques par région. |
fields(self, field_type) | Obtient les champs spécifiques par type de champ. |
get_source_data_connections(self) | Obtient les sources de données de connexion externes. |
get_names_of_source_data_connections(self) | Obtient le nom des connexions de données sources externes. |
change_data_source(self, source) | Définir les données sources du tableau croisé dynamique. |
clear_data(self) | Effacer les données et la mise en forme du tableau croisé dynamique |
calculate_range(self) | Calcule la plage du tableau croisé dynamique. |
format_all(self, style) | Formater toutes les cellules de la zone du tableau croisé dynamique |
format_row(self, row, style) | Formater les données de ligne dans la zone de tableau croisé dynamique |
select_area(self, ca) | Sélectionnez une zone de la vue du tableau croisé dynamique. |
show_detail(self, row_offset, column_offset, new_sheet, dest_row, dest_column) | Afficher les détails d’un élément de la région de données dans une nouvelle table. |
get_horizontal_page_breaks(self) | Obtient les sauts de page horizontaux de ce tableau croisé dynamique. |
get_horizontal_breaks(self) | Obtient la liste d’index des lignes du tableau croisé dynamique des sauts de page horizontaux |
show_in_compact_form(self) | Présente le tableau croisé dynamique sous une forme compacte. |
show_in_outline_form(self) | Présente le tableau croisé dynamique sous forme de plan. |
show_in_tabular_form(self) | Présente le tableau croisé dynamique sous forme de tableau. |
get_cell_by_display_name(self, display_name) | Obtient l’objet Cell par le nom d’affichage de PivotField. |
get_children(self) | Obtient 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
- module
aspose.cells.pivot - classe
Cell - classe
CellArea - classe
PivotField
