PivotField Interface
Définition
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
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 :
- CubeFields property
- DataFields[Object] property
- HiddenFields[Object] property
- PageFields[Object] property
- RowFields[Object] property
- VisibleFields[Object] property
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. |