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
group_settings	Obtient les paramètres 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’indice de PivotField dans la région.
name	Représente le nom de PivotField.
display_name	Représente le nom complet de PivotField.
is_auto_subtotals	Indique si le champ spécifié affiche des sous-totaux automatiques. La valeur par défaut est vraie.
drag_to_column	Indique si le champ spécifié peut être glissé vers la position de la colonne. La valeur par défaut est vraie.
drag_to_hide	Indique si le champ spécifié peut être glissé vers la position masquée. La valeur par défaut est vraie.
drag_to_row	Indique si le champ spécifié peut être glissé vers la position de la ligne. La valeur par défaut est vraie.
drag_to_page	Indique si le champ spécifié peut être glissé vers la position de la page. La valeur par défaut est vraie.
drag_to_data	Indique si le champ spécifié peut être glissé vers la position des données. La valeur par défaut est vraie.
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 fausse.
is_repeat_item_labels	indique si le champ peut répéter les étiquettes des éléments La valeur par défaut est fausse.
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 fausse.
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 fausse.
show_all_items	Indique si tous les éléments s’affichent dans le rapport de tableau croisé dynamique, 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 fausse.
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 automatiquement trié.
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 du champ de tri automatique. -1 signifie PivotField lui-même, d’autres signifie la position des champs de données.
is_auto_show	Indique si le champ de tableau croisé dynamique spécifié est automatiquement affiché, valable uniquement pour Excel 2003.
is_ascend_show	Indique si le champ de tableau croisé dynamique spécifié est automatiquement affiché par 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 du champ d’affichage automatique. -1 signifie PivotField lui-même. Ce devrait être l’index des champs de données.
function	Représente la fonction utilisée pour résumer le champ de données du 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 destiné à la 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 vide après chaque élément.
show_subtotal_at_top	lorsque ShowInOutlineForm est vrai, affichez les sous-totaux en haut de la liste des éléments plutôt qu’en bas
show_in_outline_form	Indique si ce champ est disposé sous forme de plan dans la vue Tableau croisé dynamique.
number_format	Représente le format d’affichage personnalisé des nombres et des dates.
items	Obtenez tous les éléments de base ;
original_items	Obtenez les éléments de base originaux ;
item_count	Obtient le nombre d’éléments de base de ce champ pivot.
show_compact	Indique si les étiquettes du champ suivant sont affichées dans la même colonne de la vue Tableau croisé dynamique.

Méthodes

Méthode	Description
group_by	Regrouper automatiquement le champ avec les informations internes
group_by	Regroupez le fichier par types de groupes de dates.
group_by	Regroupez le fichier par numéro.
group_by	Groupe personnalisé le champ.
hide_item	Définit si le PivotItem spécifique dans un champ de données est masqué.
hide_item	Définit si le PivotItem spécifique dans un champ de données est masqué.
get_pivot_filter_by_type	Obtient le filtre pivot du champ pivot par type
get_pivot_filters	Obtient les filtres pivot du champ pivot
get_filters	Obtient tous les filtres pivot de ce champ pivot.
init_pivot_items	Initier les éléments pivot du champ pivot
ungroup	Dissociez le champ pivot.
get_calculated_field_formula	Obtenez la chaîne de formule du champ calculé spécifié .
set_subtotals	Définit si le champ spécifié affiche ces sous-totaux.
get_subtotals	Indique si le sous-total spécifié est affiché.
is_hidden_item	Indique si le PivotItem spécifique est masqué.
is_hidden_item_detail	Indique si le PivotItem spécifique est un détail masqué.
hide_item_detail	Définit si le PivotItem spécifique dans un champ pivot est un détail masqué.
hide_detail	Définit si les PivotItems dans un champ pivot sont des détails masqués. C’est-à-dire réduire/développer ce champ.
add_calculated_item	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
• classe PivotField