PivotField インターフェイス

定義

ピボットテーブル レポートのフィールドを表します。 PivotField オブジェクトは、PivotFields コレクションのメンバーです。 PivotFields コレクションには、非表示のフィールドも含めて、ピボットテーブル レポートにあるすべてのフィールドが含まれています。

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

注釈

1 つの PivotField オブジェクトを返すには、PivotFields(indexindex はフィールド名またはインデックス番号) を使用します。

ピボットテーブル フィールドのサブセットを取得するプロパティを使うと便利な場合があります。 使用できるプロパティを次に示します。

プロパティ

名前 説明
_Default

内部使用のため予約済みです。

AllItemsVisible

手動フィルターが Microsoft.Office.Interop.Excel.Pivotfieldに適用されているかどうかを示す値を取得します。 読み取り専用です。

Application

Microsoft Excel アプリケーションを表す _Application オブジェクトを返します。 読み取り専用です。

AutoShowCount

指定されたピボットテーブル フィールドに自動的に表示される上位または下位のアイテムの数を返します。 読み取り専用の Integer です。

AutoShowField

指定したピボットテーブル フィールドに自動表示される上位または下位の項目を決定するために使用されるデータ フィールドの名前を返します。 読み取りのみ可能な String 値です。

AutoShowRange

指定されたピボットテーブル フィールドに上位の項目が自動的に表示される場合は xlTop を返します。下部の項目が表示されている場合は xlBottom を返します。 読み取り専用の Integer です。

AutoShowType

指定したピボットテーブル フィールドで AutoShow(Int32, Int32, Int32, String) が有効になっている場合は xlAutomatic を返します。[自動表示] が無効になっている場合は xlManual を返します。 読み取り専用の Integer です。

AutoSortCustomSubtotal

指定した PivotTable フィールドを自動的に並べ替えるために使用されるカスタム小計に対応する整数を返します。 読み取り専用です。

AutoSortField

指定したピボットテーブル フィールドを自動的に並べ替えるために使用するデータ フィールドの名前を返します。 読み取りのみ可能な String 値です。

AutoSortOrder

指定したピボットテーブル フィールドを自動的に並べ替えるために使用する順序を返します。 XlSortOrder定数の 1 つを指定できます。 読み取り専用の Integer です。

AutoSortPivotLine

指定したPivotTableフィールドを自動的に並べ替えるのに使用されるPivotLineを返します。 読み取り専用です。

BaseField

カスタム計算の基準フィールドを返すか設定します。 このプロパティは、データ フィールドに対してのみ有効です。 オブジェクトの読み取り/書き込み。

BaseItem

ユーザー設定の計算の基準フィールドの項目を返すか設定します。 データ フィールドに対してのみ有効です。 オブジェクトの読み取り/書き込み。

Calculation

指定したフィールドによって実行される計算の種類を返すか設定します。 このプロパティは、データ フィールドに対してのみ有効です。 読み取り/書き込み XlPivotFieldCalculation

Caption

ピボット フィールドのラベル テキスト。 読み取りのみ可能な String 値です。

ChildField

指定したフィールドの子フィールドを表す PivotField オブジェクトを返します (フィールドがグループ化されていて子フィールドがある場合)。 読み取り専用です。

ChildItems[Object]

1 つのピボットテーブル アイテム ( PivotItem オブジェクト)、または指定したフィールド内のグループの子または指定した項目の子であるすべてのアイテムのコレクション ( PivotItems オブジェクト) のいずれかを表すオブジェクトを返します。 読み取り専用です。

Creator

このオブジェクトを作成したアプリケーションを示す、32 ビットの整数値を返します。 Excel で作成されたオブジェクトの場合は、文字列 XCEL を表す 16 進数の 5843454C を返します。 読み取り専用 XlCreator

CubeField

指定したピボットテーブル フィールドの子の順である CubeField オブジェクトを返します。 読み取り専用です。

CurrentPage

ページ フィールドに現在表示しているページを設定します (ページ フィールドに対してのみ有効)。 オブジェクトの読み取り/書き込み。

CurrentPageList

ピボットテーブル レポートの複数アイテムのページ フィールドに含まれるアイテムのリストに対応する文字列の配列を返すか設定します。 オブジェクトの読み取り/書き込み。

CurrentPageName

指定したピボットテーブル レポートの現在表示されているページを返すか設定します。 ページの名前が [ページ] フィールドに表示されます。 このプロパティは、現在表示されているページが既に存在する場合にのみ機能することに注意してください。 読み取り/書き込みが可能な String です。

DatabaseSort

True に設定すると、ピボットテーブル フィールド内のアイテムの位置を手動で変更できます。 フィールドに手動配置されたアイテムがない場合は True を返します。 値の取得と設定が可能なブール型 (Boolean) の値です。

DataRange

Range オブジェクトを返します。 読み取り専用です。

DataType

[ピボットテーブル] フィールドのデータ型を示す定数を返します。 読み取り専用 XlPivotFieldDataType

DisplayAsCaption

このプロパティは、 PivotField のメンバー プロパティをキャプションとして表示するために使用されます。 読み取り専用です。

DisplayAsTooltip

このプロパティは、特定のメンバー プロパティ PivotField をヒントに表示するかどうかを指定するために使用されます。 値の取得と設定が可能です。

DisplayInReport

このプロパティは、指定したメンバー プロパティ PivotFieldPivotTable に表示するかどうかを指定するために使用されます。 値の取得と設定が可能です。

DragToColumn

指定されたフィールドを列の位置にドラッグできる場合は True を指定します。 既定値は True です。 値の取得と設定が可能なブール型 (Boolean) の値です。

DragToData

指定されたフィールドをデータの位置にドラッグできる場合は True です。 既定値は True です。 値の取得と設定が可能なブール型 (Boolean) の値です。

DragToHide

ピボットテーブル レポートからドラッグすることにより、フィールドを非表示にする場合は True です。 既定値は True です。 値の取得と設定が可能なブール型 (Boolean) の値です。

DragToPage

フィールドをページ位置にドラッグできる場合は True を指定します。 既定値は True です。 値の取得と設定が可能なブール型 (Boolean) の値です。

DragToRow

フィールドを行の位置にドラッグできる場合は True です。 既定値は True です。 値の取得と設定が可能なブール型 (Boolean) の値です。

DrilledDown

指定したピボットテーブル フィールドまたはピボットテーブル アイテムのフラグが "ドリル" (展開済み、または表示可能) に設定されている場合は true。 値の取得と設定が可能なブール型 (Boolean) の値です。

EnableItemSelection

False に設定すると、ユーザー インターフェイスでフィールド ドロップダウンを使用する機能を無効にします。 既定値は True です。 値の取得と設定が可能なブール型 (Boolean) の値です。

EnableMultiplePageItems

ページ領域のフィールドのフィルタドロップダウンリストにチェックボックスが存在するかどうかを指定するために使用します。 値の取得と設定が可能です。

Formula

A1 スタイル表記の読み取り /書き込み文字列でオブジェクトの数式を返すか設定します。

Function

ピボットテーブル フィールド (データ フィールドのみ) を集計するために使用する関数を返または設定します。 読み取り/書き込み XlConsolidationFunction

GroupLevel

フィールドのグループ内での指定されたフィールドの配置を返します (フィールドがグループ化された一連のフィールドのメンバーである場合)。 読み取り専用です。

Hidden

このプロパティは、OLAP 階層の個々のレベルを非表示にするために使用します。 値の取得と設定が可能です。

HiddenItems[Object]

指定したフィールド内の 1 つの非表示ピボットテーブル アイテム ( PivotItem オブジェクト)、または非表示のすべてのアイテムのコレクション ( PivotItems オブジェクト) を表すオブジェクトを返します。 読み取り専用です。

HiddenItemsList

ピボットテーブル フィールドの非表示項目である文字列の配 列を指定するオブジェクト を返すか設定します。 値の取得と設定が可能です。

IncludeNewItemsInFilter

手動フィルター処理を PivotFieldに適用するときに、除外または含まれる項目のどちらを追跡するかをデベロッパーが指定できるようにします。 値の取得と設定が可能です。

IsCalculated

ピボットテーブルのフィールドまたはピボットテーブル アイテムが集計フィールドまたはアイテムの場合は true。 読み取り専用の Boolean です。

IsMemberProperty

ピボットフィールドにメンバー プロパティが含まれている場合は True を返します。 読み取り専用の Boolean です。

LabelRange

PivotField オブジェクトの場合は、フィールド ラベルを含む 1 つ以上のセルを表すRange オブジェクトを返します。 PivotItem オブジェクトの場合は、アイテムを含むピボットテーブル レポートのすべてのセルを表す Range オブジェクトを返します。 読み取り専用です。

LayoutBlankLine

ピボットテーブル レポートの指定された行フィールドの後に空白行が挿入されると true。 既定値は False です。 値の取得と設定が可能なブール型 (Boolean) の値です。

LayoutCompactRow

行が選択されている場合に、 PivotField を圧縮する (複数の PivotFieldのアイテムを 1 つの列に表示する) かどうかを指定します。 値の取得と設定が可能です。

LayoutForm

指定したピボットテーブル アイテムの表示方法 (表形式またはアウトライン形式) を返します。 読み取り/書き込み XlLayoutFormType

LayoutPageBreak

各フィールドの後に改ページが挿入される場合は true。 既定値は False です。 値の取得と設定が可能なブール型 (Boolean) の値です。

LayoutSubtotalLocation

指定したフィールド (上または下) を基準にして、ピボットテーブル フィールドの小計の位置を返すか設定します。 読み取り/書き込み XlSubtototalLocationType

MemberPropertyCaption

MemberPropertyCaption プロパティを設定すると、特定のレベルのキャプションとして使用されるメンバー プロパティが制御されます。 値の取得と設定が可能です。

MemoryUsed

オブジェクトによって現在使用されているメモリ量 (バイト単位) を返します。 読み取り専用の Integer です。

Name

オブジェクトの名前を返すか設定します。 読み取り/書き込みが可能な String です。

NumberFormat

オブジェクトの書式設定コードを設定または返します。 読み取り/書き込みが可能な String です。

Orientation

指定したピボットテーブル レポート内のフィールドの位置。 読み取り/書き込み XlPivotFieldOrientation

Parent

指定されたオブジェクトの親オブジェクトを返します。 読み取り専用です。

ParentField

指定したオブジェクトのグループ親であるピボットテーブル フィールドを表す PivotField オブジェクトを返します。 フィールドはグループ化する必要があり、親フィールドが必要です。 読み取り専用です。

ParentItems[Object]

指定されたフィールド内のグループの親である 1 つのピボットテーブル アイテム ( PivotItem オブジェクト)、またはすべてのアイテムのコレクション ( PivotItems オブジェクト) を表すオブジェクトを返します。 指定するフィールドは、別のフィールドのグループの親である必要があります。 読み取り専用です。

PivotFilters

指定された PivotField オブジェクトのPivotFiltersを返すか設定します。 読み取り専用です。

Position

方向 (行、列、ページ、データ) のうちのフィールドの位置 (1 番目、2 番目、3 番目など)。 オブジェクトの読み取り/書き込み。

PropertyOrder

メンバー プロパティ フィールドであるピボットテーブル フィールドにのみ有効です。 所属するキューブ フィールド内でのメンバー プロパティの表示位置を示す 整数 を返します。 値の取得と設定が可能です。

PropertyParentField

このフィールドのプロパティが関連するフィールドを表す PivotField オブジェクトを返します。

RepeatLabels

指定したピボットフィールドのピボットテーブルでアイテム ラベルが繰り返されるかどうかを取得または設定します。

ServerBased

指定したピボットテーブル レポートのデータ ソースが外部であり、ページ フィールドの選択に一致するアイテムのみが取得される場合は true。 値の取得と設定が可能なブール型 (Boolean) の値です。

ShowAllItems

集計データが含まれていない場合でも、ピボットテーブル レポートのすべてのアイテムが表示されている場合は true。 既定値は False です。 値の取得と設定が可能なブール型 (Boolean) の値です。

ShowDetail

指定した PivotField に詳細が表示されているかどうかを取得または設定します。 値の取得と設定が可能です。

ShowingInAxis

PivotFieldが現在PivotTableに表示されているかどうかを示します。 読み取り専用です。

SourceCaption

SourceCaption プロパティは OLAP PivotTableにのみ適用され、PivotFieldの元のキャプションを OLAP サーバーから返します。 読み取り専用です。

SourceName

指定したピボットテーブル レポートの元のソース データに表示されているオブジェクトの名前を返します。 ユーザーがピボットテーブル レポートの作成後にアイテムの名前を変更した場合、これは現在のアイテム名と異なる場合があります。 読み取りのみ可能な String 値です。

StandardFormula

標準の英語 (U.S.) 書式で数式を指定する文字列型 (String) の値を設定します。 値の取得と設定が可能です。

SubtotalName

指定したピボットテーブル レポートの小計列または行見出しに表示される文字列ラベルを返すか設定します。 既定値は文字列 "Subtotal" です。 読み取り/書き込みが可能な String です。

Subtotals[Object]

指定したフィールドで表示される小計を返すか、または設定します。 非データ フィールドに対してのみ有効です。 オブジェクトの読み取り/書き込み。

TotalLevels

現在のフィールド グループ内のフィールドの総数を返します。 フィールドがグループ化されていない場合、またはデータ ソースが OLAP ベースである場合、 TotalLevels は値 1 を返します。 読み取り専用の Integer です。

UseMemberPropertyAsCaption

このプロパティは、PivotFieldPivotItem キャプションにメンバー プロパティ キャプションを使用するかどうかを制御するために使用されます。 値の取得と設定が可能です。

Value

ピボットテーブル レポート内の指定されたフィールドの名前。 読み取り/書き込みが可能な String です。

VisibleItems[Object]

表示されている 1 つのピボットテーブル アイテム ( PivotItem オブジェクト)、または指定したフィールドに表示されているすべてのアイテムのコレクション ( PivotItems オブジェクト) のいずれかを表すオブジェクトを返します。 読み取り専用です。

VisibleItemsList

PivotFieldに適用される手動フィルターに含まれる項目を表す文字列の配列を指定するオブジェクトを返すか設定します。 値の取得と設定が可能です。

メソッド

名前 説明
AddPageItem(String, Object)

複数のアイテムを持つページ フィールドにアイテムを追加します。

AutoShow(Int32, Int32, Int32, String)

指定されたピボットテーブル レポートの行フィールド、ページ フィールド、および列フィールドで最初または最後のアイテムの番号を表示します。

AutoSort(Int32, String)

ピボットテーブル レポートのフィールドが自動的に並べ替えられるときの規則を確立します。

AutoSortEx(Int32, String, Object, Object)

ピボットテーブル レポートのフィールドを表します。 PivotField オブジェクトは、PivotFields コレクションのメンバーです。 PivotFields コレクションには、非表示のフィールドも含めて、ピボットテーブル レポートにあるすべてのフィールドが含まれています。

CalculatedItems()

指定されたピボットテーブル レポート内のすべての集計アイテムを表す CalculatedItems コレクションを返します。 読み取り専用です。

ClearAllFilters()

このメソッドを呼び出すと、 PivotFieldに現在適用されているすべてのフィルターが削除されます。 これには、PivotFieldPivotFiltersコレクションからすべてのフィルターを削除し、PivotFieldに適用されている手動フィルターも削除することが含まれます。 PivotFieldが [レポート フィルター] 領域にある場合、選択したアイテムは既定のアイテムに設定されます。

ClearLabelFilters()

このメソッドは、PivotFieldPivotFiltersコレクション内のすべてのラベル フィルターまたはすべての日付フィルターを削除します。

ClearManualFilter()

PivotTablesPivotFieldのすべてのアイテムに対して Visible プロパティを True に設定し、OLAP PivotTablesHiddenItemsList コレクションと VisibleItemsList コレクションを空にする簡単な方法を提供します。

ClearValueFilters()

このメソッドを呼び出すと、PivotFieldPivotFiltersコレクション内のすべての値フィルターが削除されます。

Delete()

オブジェクトを削除します。

DrillTo(String)

DrillTo メソッドでは、別のPivotFieldから指定されたPivotFieldへのドリルダウンがサポートされています。

PivotItems(Object)

指定したフィールドに 1 つのピボットテーブル アイテム ( PivotItem オブジェクト)、表示されている項目と非表示のすべての項目のコレクション ( PivotItems オブジェクト) を表すオブジェクトを返します。 読み取り専用です。

適用対象