Freigeben über


PivotField Schnittstelle

Definition

Stellt ein Feld in einem PivotTable-Bericht dar. Das PivotField-Objekt ist ein Element der PivotFields Auflistung. Die PivotFields -Auflistung enthält alle Felder eines PivotTable-Berichts, einschließlich ausgeblendeter Felder.

public interface class PivotField
[System.Runtime.InteropServices.Guid("00020874-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface PivotField
Public Interface PivotField
Attribute

Hinweise

Verwenden Sie PivotFields(index), wobei index der Feldname oder die Indexnummer ist, um ein einzelnes PivotField-Objekt zurückzugeben.

Gelegentlich ist es einfacher, eine Eigenschaft zu verwenden, die eine Untermenge der PivotTable-Felder zurückgibt. Folgende Eigenschaften stehen zur Verfügung:

Eigenschaften

_Default

Für die interne Verwendung reserviert.

AllItemsVisible

Ruft einen Wert ab, der angibt, ob eine manuelle Filterung auf den Microsoft.Office.Interop.Excel.Pivotfieldangewendet wird. Schreibgeschützt.

Application

Gibt ein _Application Objekt zurück, das die Microsoft Excel-Anwendung darstellt. Schreibgeschützt.

AutoShowCount

Gibt die Anzahl der obersten oder untersten Elemente zurück, die im angegebenen PivotTable-Feld automatisch angezeigt werden. Schreibgeschützte ganze Zahl.

AutoShowField

Gibt den Namen des Datenfelds zurück, mit dem festgelegt wird, welche Kopf- oder Fußelemente automatisch in dem angegebenen PivotTable-Feld dargestellt werden. Schreibgeschützte Zeichenfolge.

AutoShowRange

Gibt xlTop zurück, falls die obersten Elemente automatisch im angegebenen PivotTable-Feld dargestellt werden; gibt xlBottom zurück, falls die untersten Elemente dargestellt werden. Schreibgeschützte ganze Zahl.

AutoShowType

Gibt xlAutomatic zurück, wenn AutoShow(Int32, Int32, Int32, String) für das angegebene PivotTable-Feld aktiviert ist; gibt xlManual zurück, wenn AutoShow deaktiviert ist. Schreibgeschützte ganze Zahl.

AutoSortCustomSubtotal

Gibt eine ganze Zahl zurück, die dem benutzerdefinierten Teilergebnis entspricht, das zum automatischen Sortieren des angegebenen PivotTable Felds verwendet wird. Schreibgeschützt.

AutoSortField

Gibt den Namen des Datenfelds zurück, nach dem das angegebene PivotTable-Feld automatisch sortiert wird. Schreibgeschützte Zeichenfolge.

AutoSortOrder

Gibt die Reihenfolge zurück, nach der das angegebene PivotTable-Feld automatisch sortiert wird. Dies kann eine der XlSortOrder Konstanten sein. Schreibgeschützte ganze Zahl.

AutoSortPivotLine

Gibt den zurück, der PivotLine zum automatischen Sortieren des angegebenen PivotTable Felds verwendet wird. Schreibgeschützt.

BaseField

Gibt das Basisfeld für eine benutzerdefinierte Berechnung zurück oder legt es fest. Diese Eigenschaft ist nur für Datenfelder gültig. Object -Wert mit Lese-/Schreibzugriff.

BaseItem

Gibt das Element im Basisfeld für eine benutzerdefinierte Berechnung zurück oder legt es fest. Nur für Datenfelder gültig. Object -Wert mit Lese-/Schreibzugriff.

Calculation

Gibt den Typ der Berechnung zurück, die vom angegebenen Feld ausgeführt wird, oder legt diese fest. Diese Eigenschaft ist nur für Datenfelder gültig. Lese-/Schreibzugriff XlPivotFieldCalculation.

Caption

Der Bezeichnungstext für das Pivotfeld. Schreibgeschützte Zeichenfolge.

ChildField

Gibt ein PivotField -Objekt zurück, das das untergeordnete Feld für das angegebene Feld darstellt (wenn das Feld gruppiert ist und über ein untergeordnetes Feld verfügt). Schreibgeschützt.

ChildItems[Object]

Gibt ein Objekt zurück, das entweder ein einzelnes PivotTable-Element (ein PivotItem -Objekt) oder eine Auflistung aller Elemente (ein PivotItems -Objekt) darstellt, die untergeordnete Gruppenelemente im angegebenen Feld sind, oder untergeordnete Elemente des angegebenen Elements. Schreibgeschützt.

Creator

Gibt einen ganzzahligen 32-Bit-Wert zurück, der die Anwendung angibt, in der dieses Objekt erstellt wurde. Wenn das Objekt in Microsoft Excel erstellt wurde, gibt die Eigenschaft die Zeichenfolge XCEL zurück, die der Hexadezimalzahl 5843454C entspricht. Schreibgeschützt XlCreator.

CubeField

Gibt das CubeField Objekt zurück, von dem das angegebene PivotTable-Feld abstammt. Schreibgeschützt.

CurrentPage

Gibt die aktuelle Seite zurück, die im Seitenfeld angezeigt wird (nur gültig für Seitenfelder), oder legt diese Seite fest. Object -Wert mit Lese-/Schreibzugriff.

CurrentPageList

Gibt ein Array aus Zeichenfolgen zurück, das der Liste der Elemente entspricht, die in einem aus mehreren Elementen bestehenden Seitenfeld für einen PivotTable-Bericht enthalten sind, oder legt dieses fest. Object -Wert mit Lese-/Schreibzugriff.

CurrentPageName

Gibt die aktuell angezeigte Seite des angegebenen PivotTable-Berichts zurück oder legt sie fest. Der Name der Seite wird im Seitenfeld angezeigt. Beachten Sie, dass diese Eigenschaft nur funktioniert, wenn die aktuell angezeigte Seite bereits vorhanden ist. Zeichenfolge mit Lese-/Schreibzugriff.

DatabaseSort

Bei Festlegung auf True ist die manuelle Neupositionierung von Elementen in einem PivotTable-Feld zulässig. Gibt True zurück, wenn das Feld keine manuell positionierten Elemente enthält. Boolescher Wert mit Lese-/Schreibzugriff.

DataRange

Gibt ein -Objekt zurück Range . Schreibgeschützt.

DataType

Gibt eine Konstante zurück, die den Datentyp im PivotTable-Feld beschreibt. Schreibgeschützt XlPivotFieldDataType.

DisplayAsCaption

Diese Eigenschaft wird verwendet, um Membereigenschaften von PivotFields als Beschriftungen anzuzeigen. Schreibgeschützt.

DisplayAsTooltip

Diese Eigenschaft wird verwendet, um anzugeben, ob eine bestimmte Membereigenschaft PivotField in QuickInfos angezeigt wird. Lese-/Schreibzugriff.

DisplayInReport

Diese Eigenschaft wird verwendet, um anzugeben, ob die angegebene Membereigenschaft PivotField im PivotTable angezeigt wird oder nicht. Lese-/Schreibzugriff.

DragToColumn

True, wenn das angegebene Feld auf die Spaltenposition gezogen werden kann. Der Standardwert ist True. Boolescher Wert mit Lese-/Schreibzugriff.

DragToData

True, wenn das angegebene Feld an die Datenposition gezogen werden kann. Der Standardwert ist True. Boolescher Wert mit Lese-/Schreibzugriff.

DragToHide

True, wenn das Feld ausgeblendet werden kann, indem es aus dem PivotTable-Bericht gezogen wird. Der Standardwert ist True. Boolescher Wert mit Lese-/Schreibzugriff.

DragToPage

True, wenn das Feld auf die Seitenposition gezogen werden kann. Der Standardwert ist True. Boolescher Wert mit Lese-/Schreibzugriff.

DragToRow

True, wenn das Feld auf die Zeilenposition gezogen werden kann. Der Standardwert ist True. Boolescher Wert mit Lese-/Schreibzugriff.

DrilledDown

True, wenn das Kennzeichen für das angegebene PivotTable-Feld oder PivotTable-Element auf "Drilled" (eingeblendet oder sichtbar) festgelegt wurde. Boolescher Wert mit Lese-/Schreibzugriff.

EnableItemSelection

Wenn diese Eigenschaft auf False festgelegt ist, wird die Möglichkeit zur Verwendung der Dropdownliste für Felder der Benutzeroberfläche deaktiviert. Der Standardwert ist True. Boolescher Wert mit Lese-/Schreibzugriff.

EnableMultiplePageItems

Mit dieser Eigenschaft wird angegeben, ob die Filter-Dropdownliste Kontrollkästchen für Felder im Seitenbereich enthält. Lese-/Schreibzugriff.

Formula

Gibt die Formel des Objekts in der Schreibweise A1-Schreibweise String zurück oder legt diese fest.

Function

Gibt die Funktion zum Summieren des PivotTable-Felds (nur Datenfelder) zurück oder legt diese fest. Lese-/Schreibzugriff XlConsolidationFunction.

GroupLevel

Gibt die Position des angegebenen Felds innerhalb einer Gruppe von Feldern zurück (wenn das Feld zu einer aus Feldern bestehenden Gruppe gehört). Schreibgeschützt.

Hidden

Mit dieser Eigenschaft werden die einzelnen Ebenen einer OLAP-Hierararchie ausgeblendet. Lese-/Schreibzugriff.

HiddenItems[Object]

Gibt ein Objekt zurück, das entweder ein einzelnes ausgeblendetes PivotTable-Element (ein PivotItem -Objekt) oder eine Auflistung aller ausgeblendeten Elemente (ein PivotItems -Objekt) im angegebenen Feld darstellt. Schreibgeschützt.

HiddenItemsList

Gibt einen Wert vom Typ Object zurück, der ein Array von Zeichenfolgen angibt, die ausgeblendete Elemente für ein PivotTable-Feld sind, oder legt diesen Wert fest. Lese-/Schreibzugriff.

IncludeNewItemsInFilter

Ermöglicht Entwicklern anzugeben, ob ausgeschlossene oder eingeschlossene Elemente nachverfolgt werden sollen, wenn die manuelle Filterung auf angewendet PivotFieldwird. Lese-/Schreibzugriff.

IsCalculated

True , wenn das PivotTable-Feld oder PivotTable-Element ein berechnetes Feld oder Element ist. Schreibgeschützter boolescher Wert.

IsMemberProperty

Gibt True zurück, wenn pivotField Membereigenschaften enthält. Schreibgeschützter boolescher Wert.

LabelRange

Für ein PivotField -Objekt gibt ein Range -Objekt zurück, das die Zelle (oder Zellen) darstellt, die die Feldbeschriftung enthalten. Gibt für ein PivotItem -Objekt ein Range-Objekt zurück, das alle Zellen im PivotTable-Bericht darstellt, die das Element enthalten. Schreibgeschützt.

LayoutBlankLine

True, wenn hinter dem angegebenen Zeilenfeld in einem PivotTable-Bericht eine leere Zeile eingefügt wird. Der Standardwert ist False. Boolescher Wert mit Lese-/Schreibzugriff.

LayoutCompactRow

Gibt an, ob ein PivotField komprimiert wird (Elemente mit mehreren PivotFields werden in einer einzelnen Spalte angezeigt), wenn Zeilen ausgewählt werden. Lese-/Schreibzugriff.

LayoutForm

Gibt die Darstellung der angegebenen PivotTable-Elemente im Tabellenformat oder im Gliederungsformat zurück oder legt sie fest. Lese-/Schreibzugriff XlLayoutFormType.

LayoutPageBreak

True, wenn hinter jedem Feld ein Seitenumbruch eingefügt wird. Der Standardwert ist False. Boolescher Wert mit Lese-/Schreibzugriff.

LayoutSubtotalLocation

Gibt die Position der Teilergebnisse des PivotTable-Felds in Bezug auf das angegebene Feld (darüber oder darunter) zurück oder legt diese fest. Lese-/Schreibzugriff XlSubtototalLocationType.

MemberPropertyCaption

Durch festlegen der MemberPropertyCaption -Eigenschaft wird gesteuert, welche Membereigenschaft als Untertitel für eine bestimmte Ebene verwendet wird. Lese-/Schreibzugriff.

MemoryUsed

Gibt die Menge an Arbeitsspeicher in Bytes zurück, die derzeit vom -Objekt verwendet wird. Schreibgeschützte ganze Zahl.

Name

Gibt den Namen des Objekts zurück oder legt ihn fest. Zeichenfolge mit Lese-/Schreibzugriff.

NumberFormat

Zurückgeben oder festlegen den Formatierungscode für das Objekt. Zeichenfolge mit Lese-/Schreibzugriff.

Orientation

Die Position des Felds im angegebenen PivotTable-Bericht. Lese-/Schreibzugriff XlPivotFieldOrientation.

Parent

Gibt das übergeordnete Objekt für das angegebene Objekt zurück. Schreibgeschützt.

ParentField

Gibt ein PivotField -Objekt zurück, das das PivotTable-Feld darstellt, das das übergeordnete Element der Gruppe des angegebenen Objekts darstellt. Das Feld muss in einer Gruppe enthalten sein und ein übergeordnetes Feld besitzen. Schreibgeschützt.

ParentItems[Object]

Gibt ein Objekt zurück, das entweder ein einzelnes PivotTable-Element (ein PivotItem -Objekt) oder eine Auflistung aller Elemente (ein PivotItems -Objekt) darstellt, die übergeordnete Gruppenelemente im angegebenen Feld sind. Das angegebene Feld muss innerhalb einer Gruppe einem anderen Feld übergeordnet sein. Schreibgeschützt.

PivotFilters

Gibt den für das PivotFilters angegebene PivotField Objekt zurück oder legt es fest. Schreibgeschützt.

Position

Position des Felds (erster, zweiter, dritter usw.) unter allen Feldern in seiner Ausrichtung (Zeilen, Spalten, Seiten, Daten). Object -Wert mit Lese-/Schreibzugriff.

PropertyOrder

Nur für PivotTable-Felder gültig, bei denen es sich um Eigenschaftsfelder für ein Element handelt. Gibt einen Integer-Wert zurück, der die Anzeigeposition der Membereigenschaft innerhalb des Cubefelds angibt, zu dem sie gehört. Lese-/Schreibzugriff.

PropertyParentField

Gibt ein PivotField -Objekt zurück, das das Feld darstellt, zu dem die Eigenschaften in diesem Feld gehören.

RepeatLabels

Ruft ab oder legt fest, ob Elementbeschriftungen in der PivotTable für das angegebene PivotField wiederholt werden.

ServerBased

True, wenn es sich bei der Datenquelle des angegebenen PivotTable-Berichts um eine externe Datenquelle handelt und nur die Elemente abgerufen werden, die dem markierten Seitenfeld entsprechen. Boolescher Wert mit Lese-/Schreibzugriff.

ShowAllItems

True, falls alle Elemente in einem PivotTable-Bericht angezeigt werden, auch wenn sie keine Zusammenfassungsdaten enthalten. Der Standardwert ist False. Boolescher Wert mit Lese-/Schreibzugriff.

ShowDetail

Ruft ab oder legt fest, ob das angegebene PivotField Detail anzeigt. Lese-/Schreibzugriff.

ShowingInAxis

Gibt an, ob derzeit PivotField im PivotTable sichtbar ist oder nicht. Schreibgeschützt.

SourceCaption

Die SourceCaption -Eigenschaft gilt nur für OLAP-Dateien PivotTableund gibt den ursprünglichen Untertitel vom OLAP-Server für zurückPivotField. Schreibgeschützt.

SourceName

Gibt den Namen des angegebenen Objekts so zurück, wie er in den ursprünglichen Quelldaten für den angegebenen PivotTable-Bericht angezeigt wird. Dies kann sich vom aktuellen Elementnamen unterscheiden, wenn der Benutzer das Element nach dem Erstellen des PivotTable-Berichts umbenannt hat. Schreibgeschützte Zeichenfolge.

StandardFormula

Gibt einen String-Wert zurück oder legt diesen fest, der für Formeln das Standardformat "Englisch (USA)" angibt. Lese-/Schreibzugriff.

SubtotalName

Gibt die Textzeichenfolge der Beschriftung zurück oder legt sie fest, die in der Teilergebnisspalte oder Zeilenüberschrift des angegebenen PivotTable-Berichts angezeigt wird. Der Standardwert ist die Zeichenfolge "Teilergebnis". Zeichenfolge mit Lese-/Schreibzugriff.

Subtotals[Object]

Gibt die mit dem angegebenen Feld angezeigten Teilergebnisse zurück oder legt diese fest. Nur für Nicht-Datenfelder gültig. Object -Wert mit Lese-/Schreibzugriff.

TotalLevels

Gibt die Gesamtanzahl der Felder in der aktuellen Feldgruppierung zurück. Wenn das Feld nicht gruppiert oder die Datenquelle OLAP-basiert ist, gibt TotalLevels den Wert 1 zurück. Schreibgeschützte ganze Zahl.

UseMemberPropertyAsCaption

Diese Eigenschaft wird verwendet, um zu steuern, ob Membereigenschaftenbeschriftungen für PivotItem Beschriftungen von PivotFieldverwendet werden. Lese-/Schreibzugriff.

Value

Der Name des angegebenen Felds im PivotTable-Bericht. Zeichenfolge mit Lese-/Schreibzugriff.

VisibleItems[Object]

Gibt ein Objekt zurück, das entweder ein einzelnes sichtbares PivotTable-Element (ein PivotItem -Objekt) oder eine Auflistung aller sichtbaren Elemente (ein PivotItems -Objekt) im angegebenen Feld darstellt. Schreibgeschützt.

VisibleItemsList

Gibt einen Wert vom Typ Object zurück, der ein Array von Zeichenfolgen angibt, die eingeschlossene Elemente in einem manuellen Filter darstellen, der auf einen PivotFieldangewendet wird, oder legt diesen Wert fest. Lese-/Schreibzugriff.

Methoden

AddPageItem(String, Object)

Fügt einem Seitenfeld mit mehreren Elementen ein zusätzliches Element hinzu.

AutoShow(Int32, Int32, Int32, String)

Zeigt die Anzahl der oberen oder unteren Elemente für eine Zeile, eine Seite oder ein Spaltenfeld in dem angegebenen PivotTable-Bericht an.

AutoSort(Int32, String)

Legt automatische Regeln für die Sortierung von Feldern in PivotTable-Berichten fest.

AutoSortEx(Int32, String, Object, Object)

Stellt ein Feld in einem PivotTable-Bericht dar. Das PivotField-Objekt ist ein Element der PivotFields Auflistung. Die PivotFields -Auflistung enthält alle Felder eines PivotTable-Berichts, einschließlich ausgeblendeter Felder.

CalculatedItems()

Gibt eine CalculatedItems Auflistung zurück, die alle berechneten Elemente im angegebenen PivotTable-Bericht darstellt. Schreibgeschützt.

ClearAllFilters()

Durch Aufrufen dieser Methode werden alle Filter gelöscht, die derzeit auf angewendet PivotFieldwerden. Dies umfasst das Löschen aller Filter aus der PivotFilters Sammlung von PivotField und das Entfernen aller manuellen Filter, die ebenfalls auf angewendet PivotField werden. Wenn sich im PivotField Bereich Berichtsfilter befindet, wird das ausgewählte Element auf das Standardelement festgelegt.

ClearLabelFilters()

Diese Methode löscht alle Bezeichnungsfilter oder alle Datumsfilter in der PivotFilters Auflistung von PivotField.

ClearManualFilter()

Bietet eine einfache Möglichkeit, die Visible-Eigenschaft für alle Elemente eines PivotField in PivotTablesauf True festzulegen und die HiddenItemsList- und VisibleItemsList-Auflistungen in OLAP PivotTableszu leeren.

ClearValueFilters()

Durch Aufrufen dieser Methode werden alle Wertfilter in der PivotFilters Auflistung von PivotFieldgelöscht.

Delete()

Löscht das Objekt.

DrillTo(String)

Die DrillTo-Methode unterstützt das Drillen in ein angegebenes PivotField aus einem anderen PivotField.

PivotItems(Object)

Gibt ein Objekt zurück, das entweder ein einzelnes PivotTable-Element (ein PivotItem -Objekt) oder eine Auflistung aller sichtbaren und ausgeblendeten Elemente (ein PivotItems Objekt) im angegebenen Feld darstellt. Schreibgeschützt.

Gilt für: