Classe PivotField - un champ dans un rapport de tableau croisé dynamique (Excel VBA)

Cet objet représente un champ dans un rapport de tableau croisé dynamique.

Les classes suivantes donnent accès à la classe PivotField

Pour utiliser une variable de classe PivotField, elle doit d'abord être instanciée, par exemple

Dim pvtf as PivotField
Set pvtf = ActiveCell.PivotField
Les procédures suivantes peuvent être utilisés pour définir des variables de la classe PivotField : CalculatedFields.Add, CalculatedFields.Item, PivotCell.DataField, PivotCell.PivotField, ChildField, ParentField, PropertyParentField, PivotFields.Item, PivotFilter.DataField, PivotFilter.MemberPropertyField, PivotFilter.PivotField, PivotItem.Parent, PivotItems.Parent, PivotTable.AddDataField ...PivotTable.ColumnFields, PivotTable.DataFields, PivotTable.DataPivotField, PivotTable.HiddenFields, PivotTable.PageFields, PivotTable.RowFields, PivotTable.VisibleFields, Range.PivotField.

For Each

Voici un exemple de traitement des éléments PivotField dans une collection

Dim pvtfCalculatedField As PivotField
For Each pvtfCalculatedField In Application.CalculatedFields()
	
Next pvtfCalculatedField

Méthodes

AddPageItem - Cette méthode ajoute un élément supplémentaire à un champ de page à plusieurs éléments.

AutoGroup - Regroupe automatiquement les champs croisés dynamiques dans un tableau croisé dynamique.

AutoShow - Cette méthode affiche le nombre d'éléments du haut ou du bas d'une ligne, page ou champ de colonne dans le rapport de tableau croisé dynamique spécifié.

AutoSort - Etablit des règles automatiques de tri de champ pour les rapports de tableau croisé dynamique.

CalculatedItems - Renvoie une collection CalculatedItems qui représente tous les éléments calculés du rapport de tableau croisé dynamique spécifié. En lecture seule.

ClearAllFilters - L’appel de cette méthode supprime tous les filtres actuellement appliqués au champ de tableau croisé dynamique. Cela inclut la suppression de tous les filtres de la collection PivotFilters du champ de tableau croisé dynamique et la suppression de tout filtrage manuel appliqué au champ de tableau croisé dynamique. Si le champ de tableau croisé dynamique se trouve dans la zone de filtre de rapport, l’élément sélectionné sera défini sur l’élément par défaut.

ClearLabelFilters - Cette méthode supprime tous les filtres d’étiquette ou tous les filtres de date de la collection PivotFilters du champ de tableau croisé dynamique.

ClearManualFilter - Permet de définir facilement la propriété visible sur true pour tous les éléments d’un champ PivotField dans les tableaux croisés dynamiques et de vider les collections HiddenItemsList et VISIBLEITEMSLIST dans les tableaux croisés dynamiques OLAP.

ClearValueFilters - L’appel de cette méthode supprime tous les filtres de valeur dans la collection PivotFilters du champ de tableau croisé dynamique.

Delete - Cette méthode supprime l'objet.

DrillTo - La méthode DrillTo prend en charge l'extraction d'un champ PivotField spécifié à partir d'un autre champ PivotField.

PivotItems - Renvoie un objet qui représente soit un seul élément de tableau croisé dynamique (un objet PivotItem ), soit une collection de tous les éléments visibles et masqués (un objet PivotItems ) dans le champ spécifié. En lecture seule.

Propriétés

Value (Default member) - Cette propriété renvoie ou définit une valeur String qui représente le nom du champ spécifié dans le rapport de tableau croisé dynamique.

AllItemsVisible Permet de récupérer une valeur booléenne qui indique si un filtrage manuel est appliqué au champ de tableau croisé dynamique. En lecture seule.

AutoShowCount Cette propriété renvoie le nombre d'éléments du haut ou du bas de la liste de champ automatiquement affichés dans le champ de tableau croisé dynamique spécifié. Type de données Long en lecture seule.

AutoShowField Cette propriété renvoie le nom du champ de données utilisé pour déterminer les éléments du haut ou du bas de la liste de champ automatiquement affichés dans le champ de tableau croisé dynamique spécifié. Type de données String en lecture seule.

AutoShowRange Renvoie la constante xlTop si les éléments les plus hauts sont affichés automatiquement dans le champ de tableau croisé dynamique spécifié; renvoie xlBottom si les éléments les plus bas sont affichés. Type de données Long en lecture seule.

AutoShowType Renvoie la constante xlAutomatic si l' affichage automatique est activé pour le champ de tableau croisé dynamique spécifié; renvoie xlManual si l' affichage automatique est désactivé. Type de données Long en lecture seule.

AutoSortCustomSubtotal Cette propriété renvoie le nom du sous-total personnalisé utilisé pour trier automatiquement le champ de tableau croisé dynamique spécifié. En lecture seule.

AutoSortField Cette propriété renvoie le nom du champ de données utilisé pour trier automatiquement le champ de tableau croisé dynamique spécifié. Type de données String en lecture seule.

AutoSortOrder Cette propriété renvoie l'ordre utilisé pour trier automatiquement le champ de tableau croisé dynamique spécifié. Il peut s’agir de l’une des constantes XlSortOrder . Type de données Long en lecture seule.

AutoSortPivotLine Renvoie le nom de l’objet PivotLine utilisé pour trier automatiquement le champ de tableau croisé dynamique spécifié. En lecture seule.

BaseField Cette propriété renvoie ou définit le champ de base d'un mode de calcul personnalisé. Cette propriété n'est valable que pour les champs de données. Variant en lecture/écriture.

BaseItem Cette propriété renvoie ou définit l'élément du champ de base d'un mode de calcul personnalisé. Cette propriété n'est valable que pour les champs de données. Variant en lecture/écriture.

Calculation Cette propriété renvoie ou définit une valeur XlPivotFieldCalculation qui représente le type de calcul effectué par le champ spécifié. Cette propriété n'est valide que pour les champs de données.

Caption Cette propriété renvoie une valeur de type String qui représente le texte de l'étiquette pour le champ dynamique.

ChildField Cette propriété renvoie un objet PivotField qui représente le champ enfant du champ spécifié (si le champ est groupé et possède un champ enfant). En lecture seule.

ChildItems Renvoie un objet qui représente soit un seul élément de tableau croisé dynamique (un objet PivotItem ), soit une collection de tous les éléments (un objet PivotItems ) qui sont des enfants de groupe dans le champ spécifié ou des enfants de l’élément spécifié. En lecture seule.

CubeField Renvoie l’objet CubeField dont est dérivé le champ de tableau croisé dynamique spécifié. En lecture seule.

CurrentPage Cette propriété renvoie ou définit la page actuelle en indiquant le champ de page (valable uniquement pour les champs de page). En lecture/écriture PivotItem.

CurrentPageList Cette propriété renvoie ou définit un tableau de chaînes correspondant à la liste d'éléments inclus dans un champ de page à plusieurs éléments d'un rapport de tableau croisé dynamique. Variant en lecture/écriture.

CurrentPageName Cette propriété renvoie ou définit la page actuellement affichée du rapport de tableau croisé dynamique spécifié. Le nom de la page s'affiche dans le champ de page. Notez que cette propriété fonctionne uniquement si la page actuellement affichée existe déjà. String en lecture/écriture.

DatabaseSort Lorsque cette propriété a la valeur True, le repositionnement manuel des éléments dans un champ de tableau croisé dynamique est autorisé. Renvoie la valeur true si le champ n’a pas d’éléments positionnés manuellement. Boolean (en lecture/écriture).

DataRange Renvoie un objet Range comme indiqué dans le tableau suivant. En lecture seule.

DataType Renvoie une valeur XlPivotFieldDataType qui représente le type de données dans le champ de tableau croisé dynamique.

DisplayAsCaption Permet d'afficher les propriétés de membre de champs de tableau croisé dynamique en tant que légendes. En lecture seule.

DisplayAsTooltip Cette propriété est utilisée pour spécifier si un champ de tableau croisé dynamique de propriété de membre spécifique est affiché dans les info-bulles. Boolean (en lecture/écriture).

DisplayInReport Cette propriété est utilisée pour spécifier si le champ PivotField de la propriété de membre spécifié est affiché dans le tableau croisé dynamique ou non. Boolean (en lecture/écriture).

DragToColumn True si le champ spécifié peut être déplacé par glissement vers la position de la colonne. La valeur par défaut est True. Boolean (en lecture/écriture).

DragToData Cette propriété renvoie la valeur True si le champ spécifié peut être déplacé par glissement vers la position des données. La valeur par défaut est True. Boolean (en lecture/écriture).

DragToHide True si le champ peut être masqué en le glissant hors du rapport de tableau croisé dynamique. La valeur par défaut est True. Boolean (en lecture/écriture).

DragToPage Cette propriété renvoie la valeur True si le champ peut être déplacé par glissement vers la position de la page. La valeur par défaut est True. Boolean (en lecture/écriture).

DragToRow True si le champ peut être déplacé par glissement vers la position de la ligne. La valeur par défaut est True. Boolean (en lecture/écriture).

DrilledDown True si l’indicateur du champ de tableau croisé dynamique ou de l’élément de tableau croisé dynamique spécifié présente un état développé (ou visible). Boolean (en lecture/écriture).

EnableItemSelection Lorsque cette propriété a la valeur False, elle désactive la possibilité d'utiliser la liste déroulante de champs dans l'interface utilisateur. La valeur par défaut est True. Boolean (en lecture/écriture).

EnableMultiplePageItems Permet de spécifier si les cases à cocher sont présentes dans la liste déroulante de filtrage pour les champs de la zone de page. Boolean (en lecture/écriture).

Formula Cette propriété renvoie ou définit une valeur de type String qui représente la formule de l'objet dans une notation de style A1 et dans la langue de la macro.

Function Cette propriété renvoie ou définit la fonction utilisée pour synthétiser le champ du tableau croisé dynamique (champs de données uniquement). En lecture/écriture XlConsolidationFunction.

GroupLevel Cette propriété renvoie la position du champ spécifié dans un groupe de champs (si le champ est membre d'un ensemble groupé de champs). En lecture seule.

Hidden Cette propriété permet de masquer les niveaux individuels d'une hiérarchie OLAP. Boolean (en lecture/écriture).

HiddenItems Renvoie un objet qui représente soit un seul élément de tableau croisé dynamique masqué (un objet PivotItem ), soit une collection de tous les éléments masqués (un objet PivotItems ) dans le champ spécifié. En lecture seule.

HiddenItemsList Cette propriété renvoie ou définit un objet de type Variant désignant un tableau de chaînes qui sont des éléments masqués pour un champ de tableau croisé dynamique. Lecture-écriture.

IncludeNewItemsInFilter Cette propriété permet aux développeurs de spécifier si les éléments exclus ou inclus doivent être suivis lorsque le filtrage manuel est appliqué au champ PivotField. Boolean (en lecture/écriture).

IsCalculated Cette propriété a la valeur True si le champ de tableau croisé dynamique est un champ ou un élément calculé. Boolean (en lecture seule).

IsMemberProperty Cette propriété renvoie la valeur True lorsqu'un champ du tableau croisé dynamique contient des propriétés membre. Boolean (en lecture seule).

LabelRange Renvoie un objet Range qui représente la cellule (ou les cellules) contenant l’étiquette de champ. En lecture seule.

LayoutBlankLine Cette propriété a la valeur True si une ligne vide est insérée après le champ de ligne spécifié du rapport de tableau croisé dynamique. La valeur par défaut est False. Boolean (en lecture/écriture).

LayoutCompactRow Spécifie si un champ PivotField est compressé ou non (les articles contenus dans plusieurs champs PivotField sont affichés dans une colonne) lorsque des lignes sont sélectionnées. Boolean (en lecture/écriture).

LayoutForm Renvoie ou définit la manière dont les éléments du tableau croisé dynamique spécifiés s’affichent (sous la forme d’un tableau ou d’un plan). En lecture/écriture XlLayoutFormType.

LayoutPageBreak Cette propriété a la valeur True si un saut de page est inséré après chaque champ. La valeur par défaut est False. Boolean (en lecture/écriture).

LayoutSubtotalLocation Renvoie ou définit la position des sous-totaux d’un champ de tableau croisé dynamique par rapport au champ spécifié (au-dessus ou au-dessous). En lecture/écriture XlSubtotalLocationType.

MemberPropertyCaption La définition de la propriété MemberPropertyCaption, détermine quelle propriété de membre est utilisée comme légende pour un niveau donné. Boolean (en lecture/écriture).

MemoryUsed Cette propriété renvoie la mémoire (en octets) actuellement utilisée par l'objet. Type de données Long en lecture seule.

Name Cette propriété renvoie ou définit une valeur de type String qui représente le nom de l'objet.

NumberFormat Cette propriété renvoie ou définit une valeur de type String qui représente le code du format de l'objet.

Orientation Cette propriété renvoie ou définit une valeur XlPivotFieldOrientation qui représente l’emplacement du champ dans le rapport de tableau croisé dynamique spécifié.

ParentField Renvoie un objet PivotField qui représente le champ de tableau croisé dynamique qui est le groupe parent de l’objet spécifié. Le champ doit être groupé et posséder un champ parent. En lecture seule.

ParentItems Renvoie un objet qui représente soit un seul élément de tableau croisé dynamique (un objet PivotItem ), soit une collection de tous les éléments (un objet PivotItems ) qui sont des groupes parents dans le champ spécifié. Le champ spécifié doit être le groupe parent d'un autre champ. En lecture seule.

PivotFilters Cette propriété renvoie ou définit les filtres de tableau croisé dynamique de l'objet PivotField spécifié. En lecture seule.

Position Cette propriété renvoie ou définit une valeur de type Variant qui représente la position du champ (premier, deuxième, troisième, etc.) parmi tous les champs dans son orientation (lignes, colonnes, pages, données).

PropertyOrder Valable uniquement pour les champs de tableau croisé dynamique membres des champs de propriété. Cette propriété renvoie un objet de type Long indiquant la position d'affichage de la propriété du membre dans le champ de cube auquel il appartient. Lecture-écriture.

PropertyParentField Cette propriété renvoie un objet PivotField représentant le champ que les propriétés de ce champ concernent.

RepeatLabels Renvoie ou définit une valeur qui indique si les étiquettes d’éléments sont répétées pour le champ PivotField spécifié. Lecture-écriture.

ServerBased Cette propriété a la valeur True si la source de données du rapport de tableau croisé dynamique spécifié est externe et si seuls les éléments correspondant à la sélection du champ de page sont récupérés. Boolean (en lecture/écriture).

ShowAllItems True si tous les éléments du rapport de tableau croisé dynamique sont affichés, même s’ils ne contiennent pas de données de synthèse. La valeur par défaut est False. Boolean (en lecture/écriture).

ShowDetail Obtient ou définit si l’objet PivotField spécifié affiche les détails. Boolean (en lecture/écriture).

ShowingInAxis Cette propriété indique si le champ de tableau croisé dynamique est actuellement visible ou non dans le tableau croisé dynamique. En lecture seule.

SourceCaption La propriété SourceCaption ne s'applique qu'aux tableaux croisés dynamiques OLAP et elle renvoie la légende originale à partir du serveur OLAP pour un champ de tableau croisé dynamique. En lecture seule.

SourceName Renvoie une valeur de type String qui représente le nom de l’objet spécifié, tel qu’il s’affiche dans les données sources d’origine pour le rapport de tableau croisé dynamique spécifié.

StandardFormula Renvoie ou définit une valeur de type String qui spécifie des formules avec une mise en forme Anglais standard (États-Unis). Lecture-écriture.

SubtotalName Cette propriété renvoie ou définit l'étiquette de chaîne de texte affichée dans l'en-tête de colonne ou de ligne des sous-totaux issus du rapport de tableau croisé dynamique spécifié. La valeur par défaut est le sous-total de la chaîne. String en lecture/écriture.

Subtotals Cette propriété renvoie ou définit les sous-totaux affichés avec le champ spécifié. Cette propriété n'est valable que pour les champs qui ne sont pas des champs de données. Variant en lecture/écriture.

TotalLevels Cette propriété renvoie le nombre total de champs dans le groupe de champs actif. Si le champ n’est pas groupé ou si la source de données est basée sur OLAP, TotalLevels renvoie la valeur 1. Type de données Long en lecture seule.

UseMemberPropertyAsCaption Cette propriété permet de déterminer si les légendes des propriétés de membre sont utilisées pour les légendes des éléments de tableau croisé dynamique du champ de tableau croisé dynamique. Boolean (en lecture/écriture).

VisibleItems Renvoie un objet qui représente soit un seul élément de tableau croisé dynamique visible (un objet PivotItem ), soit une collection de tous les éléments visibles (un objet PivotItems ) dans le champ spécifié. En lecture seule.

VisibleItemsList Cette propriété renvoie ou définit une valeur de type Variant désignant un groupe de chaînes qui représentent les éléments inclus dans un filtre manuel appliqué à un champ de tableau croisé dynamique. Lecture-écriture.

CalculatedItems - Collection d'objets PivotItem qui représente tous les éléments calculés du rapport de tableau croisé dynamique spécifié.

CubeField - Représente un champ de hiérarchie ou de mesure d'un cube OLAP.

PivotFilters - L'objet PivotFilters est une collection d'objets PivotFilter .

PivotItem - Cet objet représente un élément dans un champ de tableau croisé dynamique.

PivotItems - Collection de tous les objets PivotItem d'un champ de tableau croisé dynamique.

PivotLine - Un objet PivotLine est une ligne de lignes ou de colonnes d'un tableau croisé dynamique Excel.

Range - Cette collection représente une cellule, une ligne, une colonne ou une sélection de cellules contenant un ou plusieurs blocs contigus de cellules ou une plage 3D.