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( ), où est le nom du champ ou le numéro d’index, pour index index 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

Extrait une valeur qui indique si un filtrage manuel est appliqué au Microsoft.Office.Interop.Excel.Pivotfield . En lecture seule.

Application

Renvoie un _Application objet qui représente l’application Microsoft Excel’application. 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é. Type de données 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 est activé pour le champ de tableau croisé dynamique spécifié ; renvoie AutoShow(Int32, Int32, Int32, String) xlManual si autoShow est désactivé. Entier en lecture seule.

AutoSortCustomSubtotal

Renvoie un nombre entière correspondant au sous-totaux personnalisé utilisé pour trier automatiquement le champ PivotTable 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’y trouver XlSortOrder l’une des constantes. Entier en lecture seule.

AutoSortPivotLine

Renvoie le PivotLine champ utilisé pour trier automatiquement le champ PivotTable 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. 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 XlPivotFieldCalculation lecture/écriture.

Caption

Texte d’étiquette pour le champ de tableau croisé dynamique. String en lecture seule.

ChildField

Renvoie un objet qui représente le champ enfant pour le champ spécifié (si le champ est groupé et PivotField a un champ enfant). En lecture seule.

ChildItems[Object]

Renvoie un objet qui représente soit un seul élément de tableau croisé dynamique (un objet), soit une collection de tous les éléments (un objet) qui sont des enfants de groupe dans le champ spécifié, ou des enfants de l’élément PivotItem PivotItems 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 XlCreator seule.

CubeField

Renvoie l’objet à partir duquel le champ de tableau croisé dynamique CubeField spécifié est décroit. 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à. Type de données 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 Range objet. En lecture seule.

DataType

Renvoie une constante décrivant le type de données dans le champ de tableau croisé dynamique. En lecture XlPivotFieldDataType seule.

DisplayAsCaption

Cette propriété est utilisée pour afficher les propriétés de PivotField membre de s sous la mesure de légendes. En lecture seule.

DisplayAsTooltip

Cette propriété permet de spécifier si une propriété de membre spécifique est affichée dans PivotField les bulles. En lecture/écriture

DisplayInReport

Cette propriété est utilisée pour spécifier si la propriété membre spécifiée est affichée ou PivotField PivotTable non. 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. Type de données 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. En lecture/écriture booléen.

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. Type de données 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. Type de données 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. Type de données 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). Type de données 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. Propriété de type 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. En lecture/écriture

Formula

Renvoie ou définit la formule de l’objet dans une notation de style A1 En lecture/écriture, chaîne.

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 XlConsolidationFunction lecture/écriture.

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. En lecture/écriture

HiddenItems[Object]

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

HiddenItemsList

Renvoie ou définit un Object spécifiant un tableau de chaînes qui sont des éléments masqués pour un champ de tableau croisé dynamique. En lecture/écriture

IncludeNewItemsInFilter

Permet aux développeurs de spécifier si les éléments exclus ou inclus doivent être suivis lorsque le filtrage manuel est appliqué au PivotField . En 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. Type de données Boolean en lecture seule.

LabelRange

Pour un objet, renvoie un objet qui représente la ou les cellules qui PivotField Range contiennent l’étiquette de champ. Pour un objet, renvoie un objet Range qui représente toutes les cellules du rapport de tableau croisé dynamique PivotItem 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. Type de données Boolean en lecture-écriture.

LayoutCompactRow

Spécifie si un objet est compacté (les éléments de plusieurs s sont affichés dans une seule colonne) lorsque des lignes PivotField PivotField sont sélectionnées. En lecture/écriture

LayoutForm

Renvoie ou définit la façon dont les éléments de tableau croisé dynamique spécifiés apparaissent au format tableau ou plan. En XlLayoutFormType lecture/écriture.

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. Type de données 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 XlSubtototalLocationType lecture/écriture.

MemberPropertyCaption

La définition de MemberPropertyCaption la propriété contrôle la propriété de membre utilisée comme légende pour un niveau donné. En 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. Type de données String en lecture-écriture.

NumberFormat

Cette propriété renvoie ou définit le code du format de l'objet. En lecture/écriture, chaîne.

Orientation

Emplacement du champ dans le rapport de tableau croisé dynamique spécifié. En XlPivotFieldOrientation lecture/écriture.

Parent

Renvoie l'objet parent de l'objet spécifié. En lecture seule.

ParentField

Renvoie un objet qui représente le champ de tableau croisé dynamique qui est le parent de groupe PivotField 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 soit un seul élément de tableau croisé dynamique (un objet), soit une collection de tous les éléments (un objet) qui sont des parents de groupe dans le PivotItem PivotItems champ spécifié. Le champ spécifié doit être le groupe parent d'un autre champ. En lecture seule.

PivotFilters

Renvoie ou définit PivotFilters l’objet PivotField spécifié. En lecture seule.

Position

Position du champ (premier, deuxième, troisième, et ainsi de suite) parmi tous les champs de 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 entière indiquant la position d’affichage de la propriété membre dans le champ de cube auquel elle appartient. En lecture/écriture

PropertyParentField

Renvoie un objet représentant le champ auquel se rapportent PivotField les propriétés de ce champ.

RepeatLabels

Obtient ou définit si les étiquettes d’éléments 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. Type de données 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. Type de données Boolean en lecture-écriture.

ShowDetail

Obtient ou définit si le spécifié PivotField affiche les détails. En lecture/écriture

ShowingInAxis

Indique si PivotField l’objet est actuellement visible ou PivotTable non. En lecture seule.

SourceCaption

La propriété s’applique uniquement aux S OLAP et renvoie la légende d’origine à partir du serveur SourceCaption PivotTable 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 du 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). En 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 ». Type de données 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é permet de contrôler si les légendes de propriété de membre sont utilisées pour PivotItem les légendes de PivotField l'. En 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 soit un seul élément de tableau croisé dynamique visible (un objet), soit une collection de tous les éléments PivotItem visibles (un objet) dans PivotItems le champ spécifié. En lecture seule.

VisibleItemsList

Renvoie ou définit un Object 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)
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 collection des filtres et la suppression de tout filtrage manuel appliqué PivotFilters PivotField à PivotField l’ensemble. Si l’élément se trouve dans la zone Filtre de rapport, l’élément sélectionné est PivotField définie sur l’élément par défaut.

ClearLabelFilters()

Cette méthode supprime tous les filtres d’étiquette ou tous les filtres de date dans PivotFilters la collection de PivotField .

ClearManualFilter()

Fournit un moyen simple pour définir la propriété Visible sur True pour tous les éléments d’un in et pour vider les PivotField collections PivotTables HiddenItemsList et VisibleItemsList dans OLAP PivotTables .

ClearValueFilters()

L’appel de cette méthode supprime tous les filtres de valeurs dans PivotFilters la collection de PivotField .

Delete()

Supprime l'objet.

DrillTo(String)

La méthode DrillTo prend en charge l’exploration vers un point spécifié à partir PivotField d’un autre PivotField .

PivotItems(Object)

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

S’applique à