PivotField Interface

Référence

Définition

Espace de noms:: Microsoft.Office.Interop.Excel

Assembly:: Microsoft.Office.Interop.Excel.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Cet objet représente un champ dans un rapport de tableau croisé dynamique. L’objet PivotField est membre de la PivotFields collection. La collection PivotFields contient tous les champs d'un rapport de tableau croisé dynamique, y compris les champs masqués.

public interface class PivotField

[System.Runtime.InteropServices.Guid("00020874-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface PivotField

Public Interface PivotField

Attributs: GuidAttribute InterfaceTypeAttribute

Remarques

Utilisez PivotFields(index), où index est le nom du champ ou le numéro d’index, pour renvoyer un seul objet PivotField .

Dans certains cas, il peut être plus pratique d'utiliser l'une des propriétés renvoyant un sous-ensemble des champs du tableau croisé dynamique. Les propriétés suivantes sont disponibles :

CubeFields Propriété
DataFields[Object] Propriété
HiddenFields[Object] Propriété
PageFields[Object] Propriété
RowFields[Object] Propriété
VisibleFields[Object] Propriété

Propriétés

_Default	Réservé à une utilisation interne.
AllItemsVisible	Récupère une valeur qui indique si un filtrage manuel est appliqué ou non au Microsoft.Office.Interop.Excel.Pivotfield. En lecture seule.
Application	Renvoie un _Application objet qui représente l’application Microsoft Excel. 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é. Entier 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é. String en lecture seule.
AutoShowRange	Cette propriété renvoie la valeur xlTop si les éléments du haut de la liste de champ sont automatiquement affichés dans le champ de tableau croisé dynamique spécifié ; elle renvoie la valeur xlBottom si les éléments du bas de la liste de champ sont automatiquement affichés. Entier en lecture seule.
AutoShowType	Renvoie xlAutomatic si AutoShow(Int32, Int32, Int32, String) est activé pour le champ de tableau croisé dynamique spécifié ; renvoie xlManual si autoShow est désactivé. Entier en lecture seule.
AutoSortCustomSubtotal	Retourne un entier correspondant au sous-total personnalisé utilisé pour trier automatiquement le champ spécifié PivotTable . 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é. 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 XlSortOrder constantes. Entier en lecture seule.
AutoSortPivotLine	Retourne le PivotLine utilisé pour trier automatiquement le champ spécifié PivotTable . 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. Objet 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. Objet en lecture/écriture.
Calculation	Renvoie ou définit le type de calcul effectué par le champ spécifié. Cette propriété n'est valable que pour les champs de données. En lecture/écriture XlPivotFieldCalculation.
Caption	Texte d’étiquette du champ de tableau croisé dynamique. String en lecture seule.
ChildField	Renvoie un PivotField objet qui représente le champ enfant pour le champ spécifié (si le champ est groupé et a un champ enfant). En lecture seule.
ChildItems[Object]	Renvoie un objet qui représente un seul élément de tableau croisé dynamique (un PivotItem objet) ou une collection de tous les éléments (un PivotItems objet) qui sont des enfants de groupe dans le champ spécifié, ou des enfants de l’élément spécifié. En lecture seule.
Creator	Renvoie un nombre entier de 32 bits qui indique l’application dans laquelle cet objet a été créé. Si l'objet a été créé dans Microsoft Excel, cette propriété renvoie la chaîne XCEL, qui équivaut au nombre hexadécimal 5843454C. En lecture seule XlCreator.
CubeField	Renvoie l’objet CubeField à partir duquel le champ de tableau croisé dynamique spécifié est descendu. 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). Objet en lecture/écriture.
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. Objet 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 aucun élément positionné manuellement. Boolean (en lecture/écriture).
DataRange	Retourne un Range objet . En lecture seule.
DataType	Retourne une constante décrivant le type de données dans le champ tableau croisé dynamique. En lecture seule XlPivotFieldDataType.
DisplayAsCaption	Cette propriété est utilisée pour afficher les propriétés des membres de PivotFields en tant que légendes. En lecture seule.
DisplayAsTooltip	Cette propriété est utilisée pour spécifier si une propriété PivotField de membre spécifique est affichée ou non dans les info-bulles. Lecture-écriture.
DisplayInReport	Cette propriété est utilisée pour spécifier si la propriété PivotField de membre spécifiée est affichée dans ou PivotTable non. 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 dans la zone de page. Lecture-écriture.
Formula	Renvoie ou définit la formule de l’objet en notation de style A1 Type String en lecture-écriture.
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. Lecture-écriture.
HiddenItems[Object]	Renvoie un objet qui représente un seul élément de tableau croisé dynamique masqué (un PivotItem objet) ou une collection de tous les éléments masqués (un PivotItems objet) dans le champ spécifié. En lecture seule.
HiddenItemsList	Renvoie ou définit un Objet spécifiant un tableau de chaînes qui sont des éléments masqués pour un champ de tableau croisé dynamique. Lecture-écriture.
IncludeNewItemsInFilter	Permet aux développeurs de spécifier si les éléments exclus ou inclus doivent être suivis lorsque le PivotFieldfiltrage manuel est appliqué au . Lecture-écriture.
IsCalculated	True si le champ de tableau croisé dynamique ou l’élément 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	Pour un PivotField objet , renvoie un Range objet qui représente la ou les cellules qui contiennent l’étiquette de champ. Pour un PivotItem objet , renvoie un objet Range qui représente toutes les cellules du rapport de tableau croisé dynamique qui contiennent l’élément. 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 PivotField est compacté ou non (les éléments de plusieurs PivotFields sont affichés dans une seule colonne) lorsque des lignes sont sélectionnées. Lecture-écriture.
LayoutForm	Cette propriété renvoie ou définit la façon dont les éléments de tableau croisé dynamique spécifiés s’affichent au format tableau ou 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 XlSubtototalLocationType.
MemberPropertyCaption	La définition de la MemberPropertyCaption propriété contrôle quelle propriété membre est utilisée comme légende pour un niveau donné. En lecture/écriture
MemoryUsed	Retourne la quantité de mémoire en octets actuellement utilisée par l’objet . Entier en lecture seule.
Name	Cette propriété renvoie ou définit le nom de l'objet. String en lecture/écriture.
NumberFormat	Cette propriété renvoie ou définit le code du format de l'objet. String en lecture/écriture.
Orientation	Emplacement du champ dans le rapport de tableau croisé dynamique spécifié. En lecture/écriture XlPivotFieldOrientation.
Parent	Renvoie l’objet parent pour l’objet spécifié. En lecture seule.
ParentField	Renvoie un PivotField objet qui représente le champ de tableau croisé dynamique qui est le parent de groupe de l’objet spécifié. Le champ doit être groupé et posséder un champ parent. En lecture seule.
ParentItems[Object]	Renvoie un objet qui représente un seul élément de tableau croisé dynamique (un PivotItem objet) ou une collection de tous les éléments (un PivotItems objet) qui sont des parents de groupe dans le champ spécifié. Le champ spécifié doit être le groupe parent d'un autre champ. En lecture seule.
PivotFilters	Renvoie ou définit le PivotFilters pour l’objet spécifié PivotField . En lecture seule.
Position	Position du champ (premier, deuxième, troisième, etc.) parmi tous les champs dans son orientation (lignes, colonnes, pages, données). Objet en lecture/écriture.
PropertyOrder	Valable uniquement pour les champs de tableau croisé dynamique membres des champs de propriété. Renvoie une valeur integer indiquant la position d’affichage de la propriété membre dans le champ de cube auquel elle appartient. Lecture-écriture.
PropertyParentField	Retourne un PivotField objet représentant le champ auquel se rapportent les propriétés de ce champ.
RepeatLabels	Obtient ou définit si les étiquettes d’élément sont répétées dans le tableau croisé dynamique pour le champ de tableau croisé dynamique spécifié.
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	Cette propriété a la valeur True si tous les éléments du rapport de tableau croisé dynamique sont affichés (même ceux sans données de synthèse). La valeur par défaut est False. Boolean (en lecture/écriture).
ShowDetail	Obtient ou définit si le spécifié PivotField affiche des détails. En lecture/écriture
ShowingInAxis	Indique si est PivotField actuellement visible dans ou PivotTable non. En lecture seule.
SourceCaption	La SourceCaption propriété s’applique uniquement aux olap PivotTableet retourne le légende d’origine à partir du serveur OLAP pour un PivotField. En lecture seule.
SourceName	Retourne le nom de l’objet spécifié tel qu’il apparaît dans les données sources d’origine pour le rapport de tableau croisé dynamique spécifié. Cela peut être différent du nom de l’élément actuel si l’utilisateur a renommé l’élément après avoir créé le rapport de tableau croisé dynamique. String en lecture seule.
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 correspond à la chaîne « Sous-total ». String en lecture/écriture.
Subtotals[Object]	Cette propriété renvoie ou définit les sous-totaux affichés avec le champ spécifié. Valide uniquement pour les champs autres que les données. Objet 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 s'il s'agit d'une source de données OLAP, TotalLevels renvoie la valeur 1. Entier en lecture seule.
UseMemberPropertyAsCaption	Cette propriété est utilisée pour contrôler si les légendes de propriété de membre sont utilisées pour PivotItem les légendes du PivotField. Lecture-écriture.
Value	Nom du champ spécifié dans le rapport de tableau croisé dynamique. String en lecture/écriture.
VisibleItems[Object]	Renvoie un objet qui représente un seul élément de tableau croisé dynamique visible (un PivotItem objet) ou une collection de tous les éléments visibles (un PivotItems objet) dans le champ spécifié. En lecture seule.
VisibleItemsList	Renvoie ou définit un Objet spécifiant un tableau de chaînes qui représentent les éléments inclus dans un filtre manuel appliqué à un PivotField. En lecture/écriture

Méthodes

AddPageItem(String, Object)	Cette méthode ajoute un élément supplémentaire à un champ de page à plusieurs éléments.
AutoShow(Int32, Int32, Int32, String)	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(Int32, String)	Etablit des règles automatiques de tri de champ pour les rapports de tableau croisé dynamique.
AutoSortEx(Int32, String, Object, Object)	Cet objet représente un champ dans un rapport de tableau croisé dynamique. L’objet PivotField est membre de la PivotFields collection. La collection PivotFields contient tous les champs d'un rapport de tableau croisé dynamique, y compris les champs masqués.
CalculatedItems()	Retourne une CalculatedItems collection qui représente tous les éléments calculés dans le 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 PivotField. Cela inclut la suppression de tous les filtres de la PivotFilters collection du et la PivotField suppression de tout filtrage manuel appliqué à .PivotField Si se PivotField trouve dans la zone Filtre de rapport, l’élément sélectionné est défini sur l’élément par défaut.
ClearLabelFilters()	Cette méthode supprime tous les filtres d’étiquettes ou tous les filtres de date de la PivotFilters collection de PivotField.
ClearManualFilter()	Fournit un moyen simple de définir la propriété Visible sur True pour tous les éléments d’un PivotField dans PivotTableset de vider les collections HiddenItemsList et VisibleItemsList dans OLAP PivotTables.
ClearValueFilters()	L’appel de cette méthode supprime tous les filtres de valeur dans la PivotFilters collection de .PivotField
Delete()	Supprime l'objet.
DrillTo(String)	La méthode DrillTo prend en charge l’exploration d’un spécifié PivotField à partir d’un autre PivotField.
PivotItems(Object)	Renvoie un objet qui représente un seul élément de tableau croisé dynamique (un PivotItem objet) ou une collection de tous les éléments visibles et masqués (un PivotItems objet) dans le champ spécifié. En lecture seule.

S’applique à