Propriété PivotField.IncludeNewItemsInFilter (Excel)

Cette propriété permet aux développeurs de spécifier si les éléments exclus ou inclus doivent être suivis lorsque le filtrage manuel est appliqué au champ PivotField. Boolean (en lecture/écriture).

Syntaxe

expression. IncludeNewItemsInFilter

expression Variable qui représente un objet PivotField .

Remarques

La valeur par défaut de cette propriété est False.

Lorsque le filtrage manuel est appliqué, les développeurs peuvent définir la propriété IncludeNewItemsInFilter sur True pour suivre les éléments exclus. Ils peuvent définir la propriété sur False pour suivre les éléments inclus. Si de nouveaux éléments sont ajoutés aux données source après que la propriété IncludeNewItemsInFilter ait été définie sur True, ils apparaissent dans le tableau croisé dynamique après la dernière opération d'actualisation car ils ne font pas partie de la collection d'éléments dont Excel conserve la trace.

Pour les hiérarchies OLAP, ce paramètre est définie sur l’objet CubeField et si vous essayez de le définir sur des champs de tableau croisé dynamique faisant partie d’une hiérarchie, il échouera (avec une erreur d’utilisation). Vous pouvez obtenir ce paramètre à partir des champs de tableau croisé dynamique qui font partie d’une hiérarchie et il retourne la même valeur que la propriété CubeField.IncludeNewItemsInFilter correspondante.

Le basculement de ce paramètre efface les collections suivantes : HiddenItemsList, HiddenItems, VisibleItemsList et VisibleItems. Lorsque IncludeNewItemsInFilter est défini sur False, les collections HiddenItemsList et HiddenItems sont vides et il est impossible d'y ajouter des éléments. Une erreur d'exécution est renvoyée lorsque vous tentez d'ajouter des éléments. Lorsque IncludeNewItemsInFilter est défini sur True, les collections VisibleItemsList et VisibleItems sont vides et il est impossible d'y ajouter des éléments. Une erreur d'exécution est renvoyée lorsque vous tentez d'ajouter des éléments.

Dans les tableaux croisés dynamiques, ce paramètre est définie sur l’objet PivotField . Le basculement de ce paramètre ne modifie pas l'état du filtre.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.