PivotField classe
PivotField classe
Représente un champ dans un rapport de tableau croisé dynamique.
Le type PivotField expose les membres suivants :
Propriétés
| Propriété | Description |
|---|---|
| pivot_items | Obtient les éléments pivots du champ pivot |
| range | Obtient la plage de groupe du champ pivot |
| is_calculated_field | Indique si le champ de tableau croisé dynamique spécifié est un champ calculé. |
| base_index | Représente l’index PivotField dans les PivotFields de base. |
| position | Représente l’index PivotField dans PivotFields. |
| name | Représente le nom PivotField. |
| display_name | Représente le nom d’affichage PivotField. |
| is_auto_subtotals | Indique si le champ spécifié affiche des sous-totaux automatiques. La valeur par défaut est true. |
| drag_to_column | Indique si le champ spécifié peut être déplacé vers la position de la colonne.
La valeur par défaut est true. |
| drag_to_hide | Indique si le champ spécifié peut être déplacé vers la position masquée.
La valeur par défaut est true. |
| drag_to_row | Indique si le champ spécifié peut être déplacé vers la position de ligne.
La valeur par défaut est true. |
| drag_to_page | Indique si le champ spécifié peut être déplacé vers la position de la page.
La valeur par défaut est true. |
| drag_to_data | Indique si le champ spécifié peut être déplacé vers la position des données.
La valeur par défaut est true. |
| is_multiple_item_selection_allowed | indique si le champ peut avoir plusieurs éléments
sélectionné dans le champ de la page La valeur par défaut est faux. |
| is_repeat_item_labels | indique si le champ peut répéter les étiquettes des éléments
La valeur par défaut est faux. |
| is_include_new_items_in_filter | indique si le champ peut inclure de nouveaux éléments dans le filtre manuel
La valeur par défaut est faux. |
| is_insert_page_breaks_between_items | indique si le champ peut insérer des sauts de page entre les éléments
insérer un saut de page après chaque élément La valeur par défaut est faux. |
| show_all_items | Indique si tous les éléments du rapport de tableau croisé dynamique sont affichés,
même s’ils ne contiennent pas de données récapitulatives. afficher les éléments sans données La valeur par défaut est faux. |
| non_auto_sort_default | Indique si une opération de tri qui sera appliquée à ce champ pivot est une opération de tri automatique ou un simple tri de données. |
| is_auto_sort | Indique si le champ de tableau croisé dynamique spécifié est trié automatiquement. |
| is_ascend_sort | Indique si le champ de tableau croisé dynamique spécifié est trié automatiquement par ordre croissant. |
| auto_sort_field | Représente l’index de champ de tri automatique.
-1 signifie PivotField lui-même, les autres signifient la position des champs de données. |
| is_auto_show | Indique si le champ de tableau croisé dynamique spécifié est automatiquement affiché, uniquement valable pour Excel 2003. |
| is_ascend_show | Indique si le champ de tableau croisé dynamique spécifié s’affiche automatiquement en ordre croissant. |
| auto_show_count | Représente le nombre d’éléments du haut ou du bas
qui sont automatiquement affichés dans le champ de tableau croisé dynamique spécifié. |
| auto_show_field | Représente l’index de champ d’affichage automatique. -1 signifie PivotField lui-même.
Il doit s’agir de l’index des champs de données. |
| function | Représente la fonction utilisée pour résumer le champ de données de tableau croisé dynamique. |
| data_display_format | Représente comment afficher les valeurs contenues dans un champ de données. |
| base_field_index | Représente le champ de base pour un calcul personnalisé. |
| base_item_position | Représente l’élément dans le champ de base pour un calcul personnalisé.
Valable uniquement pour les champs de données. Étant donné que PivotItemPosition.Custom est uniquement en lecture, si vous devez définir PivotItemPosition.Custom, veuillez définir l’attribut PivotField.BaseItemIndex. |
| base_item_index | Représente l’élément dans le champ de base pour un calcul personnalisé.
Valable uniquement pour les champs de données. |
| current_page_item | Représente l’élément de page actuel affiché pour le champ de page (valable uniquement pour les champs de page). |
| number | Représente le format d’affichage intégré des nombres et des dates. |
| insert_blank_row | Indique s’il faut insérer une ligne vierge après chaque élément. |
| show_subtotal_at_top | lorsque ShowInOutlineForm est vrai, affiche les sous-totaux en haut de la liste des éléments au lieu d’en bas |
| show_in_outline_form | Indique si la disposition de ce champ sous forme de plan sur la vue Tableau croisé dynamique |
| number_format | Représente le format d’affichage personnalisé des nombres et des dates. |
| items | Obtenez tous les objets de base ; |
| original_items | Obtenez les éléments de base d’origine ; |
| item_count | Obtient le nombre d’éléments de base de ce champ pivot. |
| show_compact | Indique si afficher les étiquettes du champ suivant dans la même colonne sur la vue Tableau croisé dynamique |
Méthodes
| Méthode | Description |
|---|---|
| hide_item(index, is_hidden) | Définit si le PivotItem spécifique dans un champ de données est masqué. |
| hide_item(item_value, is_hidden) | Définit si le PivotItem spécifique dans un champ de données est masqué. |
| get_pivot_filter_by_type(type) | Obtient le filtre pivot du champ pivot par type |
| get_pivot_filters() | Obtient les filtres de pivot du champ pivot |
| init_pivot_items() | Init les éléments pivot du champ pivot |
| get_calculated_field_formula() | Récupère la chaîne de formule du champ calculé spécifié . |
| set_subtotals(subtotal_type, shown) | Définit si le champ spécifié affiche ces sous-totaux. |
| get_subtotals(subtotal_type) | Obtient si le champ spécifié affiche ces sous-totaux. |
| is_hidden_item(index) | Indique si le PivotItem spécifique est masqué. |
| is_hidden_item_detail(index) | Indique si le PivotItem spécifique est un détail masqué. |
| hide_item_detail(index, is_hidden_detail) | Définit si le PivotItem spécifique dans un champ pivot est un détail masqué. |
| hide_detail(is_hidden_detail) | Définit si les PivotItems d’un champ pivot sont des détails masqués. C’est-à-dire réduire/développer ce champ. |
| add_calculated_item(name, formula) | Ajoutez un élément calculé au champ pivot. |
Exemple
from aspose.cells import Workbook
from aspose.cells.pivot import PivotFieldType, PivotTableStyleType
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"
pivot.refresh_data()
pivot.calculate_data()
# do your business
book.save("out.xlsx")
Voir également
- module aspose.cells.pivot
