PivotField Interface

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 retourner 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 de propriété
DataFields[Object] de propriété
HiddenFields[Object] de propriété
PageFields[Object] de propriété
RowFields[Object] de propriété
VisibleFields[Object] de propriété

Propriétés

Nom	Description
_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.Pivotfieldfichier . 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) ce champ est activé pour le champ de tableau croisé dynamique spécifié ; renvoie xlManual si l’option Afficher automatiquement est désactivée. Entier en lecture seule.
AutoSortCustomSubtotal	Renvoie 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é. Peut être l’une XlSortOrder des constantes. Entier en lecture seule.
AutoSortPivotLine	Renvoie celui 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. Lire/écrire XlPivotFieldCalculation.
Caption	Texte de l’étiquette pour le champ de tableau croisé dynamique. String en lecture seule.
ChildField	Renvoie un PivotField objet 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[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 du 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. Lecture seule XlCreator.
CubeField	Renvoie l’objet CubeField dont descend 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). 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 True si le champ ne comporte aucun élément positionné manuellement. Boolean (en lecture/écriture).
DataRange	Renvoie un Range objet. En lecture seule.
DataType	Renvoie une constante décrivant le type de données dans le champ Tableau croisé dynamique. Lecture seule XlPivotFieldDataType.
DisplayAsCaption	Cette propriété est utilisée pour afficher les propriétés de membre de s sous forme de PivotFieldlé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 le PivotTable ou 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 Chaîne de 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). Lire/écrire 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 en 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 faire l’objet d’un suivi lorsqu’un PivotFieldfiltrage manuel est appliqué au fichier . 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 cellule (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 a PivotField est compacté (les éléments de plusieurs PivotFields sont affichés dans une seule colonne) lorsque des lignes sont sélectionnées. Lecture-écriture.
LayoutForm	Renvoie ou définit la façon dont les éléments de tableau croisé dynamique spécifiés apparaissent (sous forme de tableau ou de plan). Lire/écrire 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). Lire/écrire XlSubtototalLocationType.
MemberPropertyCaption	La définition de la MemberPropertyCaption propriété détermine quelle propriété de membre est utilisée comme légende pour un niveau donné. Lecture-écriture.
MemoryUsed	Renvoie 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é. Lire/écrire 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	Retourne ou définit la 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 un nombre entier indiquant la position d’affichage de la propriété du membre dans le champ de cube auquel elle appartient. Lecture-écriture.
PropertyParentField	Renvoie 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 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. Lecture-écriture.
ShowingInAxis	Indique si elle PivotField est actuellement visible dans ou PivotTable non. En lecture seule.
SourceCaption	La SourceCaption propriété ne s’applique qu’aux modules OLAP PivotTableet renvoie la légende d’origine du serveur OLAP pour un PivotField. En lecture seule.
SourceName	Renvoie 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é. Celui-ci peut être différent du nom actuel de l’élément si l’utilisateur a renommé l’élément après la création du 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 des 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 représentant les éléments inclus dans un filtre manuel appliqué à un PivotField. Lecture-écriture.

Méthodes

Nom	Description
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()	Renvoie 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 des et PivotField la suppression de tout filtrage manuel appliqué à .PivotField Si le PivotField se trouve dans la zone de filtre du 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’étiquette ou tous les filtres de date de la PivotFilters collection du PivotField.
ClearManualFilter()	Fournit un moyen simple de définir la propriété Visible sur True pour tous les éléments d’un PivotField et PivotTablesde vider les collections HiddenItemsList et VisibleItemsList dans OLAP PivotTables.
ClearValueFilters()	L’appel de cette méthode supprime tous les filtres de valeurs 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 à

Commentaires

Cette page a-t-elle été utile ?