Partager via


PivotField Interface

Définition

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

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 :

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 à