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_itemsObtient les éléments pivots du champ pivot
rangeObtient la plage de groupe du champ pivot
group_settingsObtient les paramètres de groupe du champ pivot.
is_calculated_fieldIndique si le champ de tableau croisé dynamique spécifié est un champ calculé.
base_indexReprésente l’index PivotField dans les PivotFields de base.
positionReprésente l’indice de PivotField dans la région.
nameReprésente le nom de PivotField.
display_nameReprésente le nom complet de PivotField.
is_auto_subtotalsIndique si le champ spécifié affiche des sous-totaux automatiques. La valeur par défaut est vraie.
drag_to_columnIndique si le champ spécifié peut être glissé vers la position de la colonne.
La valeur par défaut est vraie.
drag_to_hideIndique si le champ spécifié peut être glissé vers la position masquée.
La valeur par défaut est vraie.
drag_to_rowIndique si le champ spécifié peut être glissé vers la position de la ligne.
La valeur par défaut est vraie.
drag_to_pageIndique si le champ spécifié peut être glissé vers la position de la page.
La valeur par défaut est vraie.
drag_to_dataIndique 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_allowedindique 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_labelsindique si le champ peut répéter les étiquettes des éléments
La valeur par défaut est fausse.
is_include_new_items_in_filterindique 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_itemsindique 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_itemsIndique 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_defaultIndique 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_sortIndique si le champ de tableau croisé dynamique spécifié est automatiquement trié.
is_ascend_sortIndique si le champ de tableau croisé dynamique spécifié est trié automatiquement par ordre croissant.
auto_sort_fieldRepré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_showIndique si le champ de tableau croisé dynamique spécifié est automatiquement affiché, valable uniquement pour Excel 2003.
is_ascend_showIndique si le champ de tableau croisé dynamique spécifié est automatiquement affiché par ordre croissant.
auto_show_countRepré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_fieldReprésente l’index du champ d’affichage automatique. -1 signifie PivotField lui-même.
Ce devrait être l’index des champs de données.
functionReprésente la fonction utilisée pour résumer le champ de données du tableau croisé dynamique.
data_display_formatReprésente comment afficher les valeurs contenues dans un champ de données.
base_field_indexReprésente le champ de base pour un calcul personnalisé.
base_item_positionRepré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_indexReprésente l’élément dans le champ de base pour un calcul personnalisé.
Valable uniquement pour les champs de données.
current_page_itemReprésente l’élément de page actuel affiché pour le champ de page (valable uniquement pour les champs de page).
numberReprésente le format d’affichage intégré des nombres et des dates.
insert_blank_rowIndique s’il faut insérer une ligne vide après chaque élément.
show_subtotal_at_toplorsque ShowInOutlineForm est vrai, affichez les sous-totaux en haut de la liste des éléments plutôt qu’en bas
show_in_outline_formIndique si ce champ est disposé sous forme de plan dans la vue Tableau croisé dynamique.
number_formatReprésente le format d’affichage personnalisé des nombres et des dates.
itemsObtenez tous les éléments de base ;
original_itemsObtenez les éléments de base originaux ;
item_countObtient le nombre d’éléments de base de ce champ pivot.
show_compactIndique si les étiquettes du champ suivant sont affichées dans la même colonne de la vue Tableau croisé dynamique.

Méthodes

MéthodeDescription
group_byRegrouper automatiquement le champ avec les informations internes
group_byRegroupez le fichier par types de groupes de dates.
group_byRegroupez le fichier par numéro.
group_byGroupe personnalisé le champ.
hide_itemDéfinit si le PivotItem spécifique dans un champ de données est masqué.
hide_itemDéfinit si le PivotItem spécifique dans un champ de données est masqué.
get_pivot_filter_by_typeObtient le filtre pivot du champ pivot par type
get_pivot_filtersObtient les filtres pivot du champ pivot
get_filtersObtient tous les filtres pivot de ce champ pivot.
init_pivot_itemsInitier les éléments pivot du champ pivot
ungroupDissociez le champ pivot.
get_calculated_field_formulaObtenez la chaîne de formule du champ calculé spécifié .
set_subtotalsDéfinit si le champ spécifié affiche ces sous-totaux.
get_subtotalsIndique si le sous-total spécifié est affiché.
is_hidden_itemIndique si le PivotItem spécifique est masqué.
is_hidden_item_detailIndique si le PivotItem spécifique est un détail masqué.
hide_item_detailDéfinit si le PivotItem spécifique dans un champ pivot est un détail masqué.
hide_detailDé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_itemAjoutez 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