Freigeben über


PivotField.IncludeNewItemsInFilter-Eigenschaft (Excel)

Entwickler können angeben, ob aus- oder eingeschlossene Elemente überwacht werden sollen, wenn das PivotField manuell gefiltert wird. Boolescher Wert mit Lese-/Schreibzugriff.

Syntax

Ausdruck. IncludeNewItemsInFilter

Ausdruck Eine Variable, die ein PivotField-Objekt darstellt.

Hinweise

Der Standardwert für diese Eigenschaft ist False.

Wenn die manuelle Filterung angewendet wird, können Entwickler die IncludeNewItemsInFilter-Eigenschaft auf True festlegen, um ausgeschlossene Elemente nachzuverfolgen. Sie können die -Eigenschaft auf False festlegen, um eingeschlossene Elemente nachzuverfolgen. Wenn der Datenquelle neue Elemente hinzugefügt werden, nachdem die IncludeNewItemsInFilter-Eigenschaft auf True festgelegt wurde, werden die neuen Elemente in der PivotTable nach der nächsten Aktualisierung angezeigt, weil sie sich nicht in der von Excel überwachten Auflistung von Elementen befinden.

Bei OLAP-Hierarchien wird diese Einstellung für das CubeField-Objekt festgelegt, und der Versuch, sie für PivotFields festzulegen, die Teil einer Hierarchie sind, schlägt fehl (mit einem Laufzeitfehler). Sie können diese Einstellung aus den PivotFields abrufen, die Teil einer Hierarchie sind, und sie gibt das gleiche zurück wie die entsprechende CubeField.IncludeNewItemsInFilter-Eigenschaft .

Beim Umschalten dieser Einstellung werden die folgenden Auflistungen gelöscht: HiddenItemsList, HiddenItems, VisibleItemsList und VisibleItems. Wenn IncludeNewItemsInFilter auf False festgelegt ist, sind die Auflistungen HiddenItemsList und HiddenItems leer, und es können ihnen keine Elemente hinzugefügt werden. Bei dem Versuch, Elemente hinzuzufügen, wird ein Laufzeitfehler zurückgegeben. Wenn IncludeNewItemsInFilter auf True festgelegt ist, sind die Auflistungen VisibleItemsList und VisibleItems leer, und es können ihnen keine Elemente hinzugefügt werden. Bei dem Versuch, Elemente hinzuzufügen, wird ein Laufzeitfehler zurückgegeben.

In PivotTables wird diese Einstellung für das PivotField-Objekt festgelegt. Das Umschalten dieser Einstellung hat keinen Einfluss auf den Zustand des Filters.

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.