Excel.PivotLayout class
ピボットテーブルの視覚的なレイアウトを表します。
- Extends
注釈
[API セット: ExcelApi 1.8]
プロパティ
| alt |
ピボットテーブルの代替テキストの説明。 代替テキストは、ピボットテーブルに含まれる情報の代替テキスト ベースの表現を提供します。 この情報は、表を見たり理解したりできない視覚または認知障碍のあるユーザーに役立ちます。 タイトルは障碍のある人に読み上げることができ、コンテンツの説明を聞くかどうかを判断するために使用されます。 |
| alt |
ピボットテーブルの代替テキスト タイトル。 代替テキストは、ピボットテーブルに含まれる情報の代替テキスト ベースの表現を提供します。 この情報は、表を見たり理解したりできない視覚または認知障碍のあるユーザーに役立ちます。 タイトルは障碍のある人に読み上げることができ、コンテンツの説明を聞くかどうかを判断するために使用されます。 |
| auto |
更新時またはフィールドを移動したときに、書式設定が自動的に書式設定されるかどうかを指定します。 |
| context | オブジェクトに関連付けられている要求コンテキスト。 これにより、アドインのプロセスが Office ホスト アプリケーションのプロセスに接続されます。 |
| empty |
|
| enable |
フィールド リストを UI に表示できるかどうかを指定します。 |
| fill |
ピボットテーブルの空のセルに |
| layout |
このプロパティは、ピボットテーブルのすべてのフィールドの PivotLayoutType を示します。 フィールドによって状態が異なる場合は null 値になります。 |
| preserve |
ページ フィールド項目のピボット、並べ替え、変更などの操作によってレポートを更新または再計算するときに、書式設定が保持されるかどうかを指定します。 |
| show |
ピボットテーブル レポートに列の総計を表示するかどうかを指定します。 |
| show |
ピボットテーブルでフィールド ヘッダー (フィールドの標題とフィルターのドロップダウン) を表示するかどうかを指定します。 |
| show |
ピボットテーブル レポートに行の総計を表示するかどうかを指定します。 |
| subtotal |
このプロパティは、ピボットテーブルのすべてのフィールドの |
メソッド
| display |
各項目の後に空白行を表示するかどうかを設定します。 これは、ピボットテーブルのグローバル レベルで設定され、個々のピボットフィールドに適用されます。 この関数は、ピボットテーブルのすべてのフィールドの設定を |
| get |
ピボットテーブルの列ラベルが存在する範囲を返します。 |
| get |
ピボットテーブルのデータ値が存在する範囲を返します。 |
| get |
PivotTable 内で指定された範囲の値を計算するために使用される DataHierarchy を取得します。 |
| get |
ピボットテーブルのフィルター エリアの範囲を返します。 |
| get |
PivotTable 内で指定された範囲の値を構成する PivotItems を軸から取得します。 |
| get |
PivotTable 内で指定された範囲の値を構成する PivotItems を軸から取得します。 |
| get |
フィルター エリアを除く、ピボットテーブルが存在する範囲を返します。 |
| get |
ピボットテーブルの行ラベルが存在する範囲を返します。 |
| load(options) | オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、 |
| load(property |
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、 |
| load(property |
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、 |
| repeat |
ピボットテーブルのすべてのフィールドで [すべてのアイテムのラベルを繰り返す] 設定を設定します。 |
| set(properties, options) | オブジェクトの複数のプロパティを同時に設定します。 適切なプロパティを持つプレーン オブジェクト、または同じ型の別の API オブジェクトを渡すことができます。 |
| set(properties) | 既存の読み込まれたオブジェクトに基づいて、オブジェクトに複数のプロパティを同時に設定します。 |
| set |
必要なすべての条件とコンテキストを自動的に選択するため、指定したセルを使用して自動的に並べ替えを実行するようピボットテーブルを設定します。 これは、UI から自動並べ替えを適用するのと同じ動作です。 |
| set |
必要なすべての条件とコンテキストを自動的に選択するため、指定したセルを使用して自動的に並べ替えを実行するようピボットテーブルを設定します。 これは、UI から自動並べ替えを適用するのと同じ動作です。 |
| toJSON() | API オブジェクトが |
プロパティの詳細
altTextDescription
ピボットテーブルの代替テキストの説明。
代替テキストは、ピボットテーブルに含まれる情報の代替テキスト ベースの表現を提供します。 この情報は、表を見たり理解したりできない視覚または認知障碍のあるユーザーに役立ちます。 タイトルは障碍のある人に読み上げることができ、コンテンツの説明を聞くかどうかを判断するために使用されます。
altTextDescription: string;
プロパティ値
string
注釈
[API セット: ExcelApi 1.13]
altTextTitle
ピボットテーブルの代替テキスト タイトル。
代替テキストは、ピボットテーブルに含まれる情報の代替テキスト ベースの表現を提供します。 この情報は、表を見たり理解したりできない視覚または認知障碍のあるユーザーに役立ちます。 タイトルは障碍のある人に読み上げることができ、コンテンツの説明を聞くかどうかを判断するために使用されます。
altTextTitle: string;
プロパティ値
string
注釈
[API セット: ExcelApi 1.13]
autoFormat
更新時またはフィールドを移動したときに、書式設定が自動的に書式設定されるかどうかを指定します。
autoFormat: boolean;
プロパティ値
boolean
注釈
[API セット: ExcelApi 1.9]
context
オブジェクトに関連付けられている要求コンテキスト。 これにより、アドインのプロセスが Office ホスト アプリケーションのプロセスに接続されます。
context: RequestContext;
プロパティ値
emptyCellText
fillEmptyCells == true
する場合に、ピボットテーブルの空のセルに自動的に入力されるテキスト。
fillEmptyCells が false に設定されている場合、この値は保持されます。この値を設定してもそのプロパティは true に設定されないことに注意してください。 既定では、これは空の文字列です。
emptyCellText: string;
プロパティ値
string
注釈
[API セット: ExcelApi 1.13]
enableFieldList
フィールド リストを UI に表示できるかどうかを指定します。
enableFieldList: boolean;
プロパティ値
boolean
注釈
[API セット: ExcelApi 1.10]
fillEmptyCells
ピボットテーブルの空のセルに emptyCellTextを設定するかどうかを指定します。 既定値は false です。 このプロパティが false に設定されている場合、emptyCellText の値は保持されることに注意してください。
fillEmptyCells: boolean;
プロパティ値
boolean
注釈
[API セット: ExcelApi 1.13]
layoutType
このプロパティは、ピボットテーブルのすべてのフィールドの PivotLayoutType を示します。 フィールドによって状態が異なる場合は null 値になります。
layoutType: Excel.PivotLayoutType | "Compact" | "Tabular" | "Outline";
プロパティ値
Excel.PivotLayoutType | "Compact" | "Tabular" | "Outline"
注釈
[API セット: ExcelApi 1.8]
preserveFormatting
ページ フィールド項目のピボット、並べ替え、変更などの操作によってレポートを更新または再計算するときに、書式設定が保持されるかどうかを指定します。
preserveFormatting: boolean;
プロパティ値
boolean
注釈
[API セット: ExcelApi 1.9]
showColumnGrandTotals
ピボットテーブル レポートに列の総計を表示するかどうかを指定します。
showColumnGrandTotals: boolean;
プロパティ値
boolean
注釈
[API セット: ExcelApi 1.8]
showFieldHeaders
ピボットテーブルでフィールド ヘッダー (フィールドの標題とフィルターのドロップダウン) を表示するかどうかを指定します。
showFieldHeaders: boolean;
プロパティ値
boolean
注釈
[API セット: ExcelApi 1.13]
showRowGrandTotals
ピボットテーブル レポートに行の総計を表示するかどうかを指定します。
showRowGrandTotals: boolean;
プロパティ値
boolean
注釈
[API セット: ExcelApi 1.8]
subtotalLocation
このプロパティは、ピボットテーブルのすべてのフィールドの SubtotalLocationType を示します。 フィールドの状態が異なる場合、これは nullになります。
subtotalLocation: Excel.SubtotalLocationType | "AtTop" | "AtBottom" | "Off";
プロパティ値
Excel.SubtotalLocationType | "AtTop" | "AtBottom" | "Off"
注釈
[API セット: ExcelApi 1.8]
メソッドの詳細
displayBlankLineAfterEachItem(display)
各項目の後に空白行を表示するかどうかを設定します。 これは、ピボットテーブルのグローバル レベルで設定され、個々のピボットフィールドに適用されます。 この関数は、ピボットテーブルのすべてのフィールドの設定を display パラメーターの値に上書きします。
displayBlankLineAfterEachItem(display: boolean): void;
パラメーター
- display
-
boolean
True を指定すると、空白行の表示設定がオンになります。 False はオフにします。
返品
void
注釈
[API セット: ExcelApi 1.13]
getColumnLabelRange()
ピボットテーブルの列ラベルが存在する範囲を返します。
getColumnLabelRange(): Excel.Range;
返品
注釈
[API セット: ExcelApi 1.8]
getDataBodyRange()
ピボットテーブルのデータ値が存在する範囲を返します。
getDataBodyRange(): Excel.Range;
返品
注釈
[API セット: ExcelApi 1.8]
getDataHierarchy(cell)
PivotTable 内で指定された範囲の値を計算するために使用される DataHierarchy を取得します。
getDataHierarchy(cell: Range | string): Excel.DataPivotHierarchy;
パラメーター
- cell
-
Excel.Range | string
ピボットテーブルのデータ本文内の 1 つのセル。
返品
指定したセルの値を計算するために使用される DataPivotHierarchy オブジェクト。
注釈
[API セット: ExcelApi 1.9]
getFilterAxisRange()
ピボットテーブルのフィルター エリアの範囲を返します。
getFilterAxisRange(): Excel.Range;
返品
注釈
[API セット: ExcelApi 1.8]
getPivotItems(axis, cell)
PivotTable 内で指定された範囲の値を構成する PivotItems を軸から取得します。
getPivotItems(axis: Excel.PivotAxis, cell: Range | string): Excel.PivotItemCollection;
パラメーター
- axis
- Excel.PivotAxis
PivotItems を取得する軸。 "row" または "column" である必要があります。
- cell
-
Excel.Range | string
ピボットテーブルのデータ本文内の 1 つのセル。
返品
指定した行の値を計算するために使用される PivotItems の PivotItemCollection。
注釈
[API セット: ExcelApi 1.9]
getPivotItems(axis, cell)
PivotTable 内で指定された範囲の値を構成する PivotItems を軸から取得します。
getPivotItems(axis: "Unknown" | "Row" | "Column" | "Data" | "Filter", cell: Range | string): Excel.PivotItemCollection;
パラメーター
- axis
-
"Unknown" | "Row" | "Column" | "Data" | "Filter"
PivotItems を取得する軸。 "row" または "column" である必要があります。
- cell
-
Excel.Range | string
ピボットテーブルのデータ本文内の 1 つのセル。
返品
指定した行の値を計算するために使用される PivotItems の PivotItemCollection。
注釈
[API セット: ExcelApi 1.9]
getRange()
フィルター エリアを除く、ピボットテーブルが存在する範囲を返します。
getRange(): Excel.Range;
返品
注釈
[API セット: ExcelApi 1.8]
getRowLabelRange()
ピボットテーブルの行ラベルが存在する範囲を返します。
getRowLabelRange(): Excel.Range;
返品
注釈
[API セット: ExcelApi 1.8]
load(options)
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。
load(options?: Excel.Interfaces.PivotLayoutLoadOptions): Excel.PivotLayout;
パラメーター
読み込むオブジェクトのプロパティのオプションを指定します。
返品
load(propertyNames)
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。
load(propertyNames?: string | string[]): Excel.PivotLayout;
パラメーター
- propertyNames
-
string | string[]
読み込むプロパティを指定するコンマ区切りの文字列または文字列の配列。
返品
load(propertyNamesAndPaths)
オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。
load(propertyNamesAndPaths?: {
select?: string;
expand?: string;
}): Excel.PivotLayout;
パラメーター
- propertyNamesAndPaths
-
{ select?: string; expand?: string; }
propertyNamesAndPaths.select は読み込むプロパティを指定するコンマ区切りの文字列であり、 propertyNamesAndPaths.expand は読み込むナビゲーションのプロパティを指定するコンマ区切りの文字列です。
返品
repeatAllItemLabels(repeatLabels)
ピボットテーブルのすべてのフィールドで [すべてのアイテムのラベルを繰り返す] 設定を設定します。
repeatAllItemLabels(repeatLabels: boolean): void;
パラメーター
- repeatLabels
-
boolean
True は、ラベルの繰り返し表示設定をオンにします。 False はオフにします。
返品
void
注釈
[API セット: ExcelApi 1.13]
set(properties, options)
オブジェクトの複数のプロパティを同時に設定します。 適切なプロパティを持つプレーン オブジェクト、または同じ型の別の API オブジェクトを渡すことができます。
set(properties: Interfaces.PivotLayoutUpdateData, options?: OfficeExtension.UpdateOptions): void;
パラメーター
- properties
- Excel.Interfaces.PivotLayoutUpdateData
メソッドが呼び出されたオブジェクトのプロパティと同型構造のプロパティを持つ JavaScript オブジェクト。
- options
- OfficeExtension.UpdateOptions
プロパティ オブジェクトが読み取り専用プロパティを設定しようとした場合にエラーを抑制するオプションを提供します。
返品
void
set(properties)
既存の読み込まれたオブジェクトに基づいて、オブジェクトに複数のプロパティを同時に設定します。
set(properties: Excel.PivotLayout): void;
パラメーター
- properties
- Excel.PivotLayout
返品
void
setAutoSortOnCell(cell, sortBy)
必要なすべての条件とコンテキストを自動的に選択するため、指定したセルを使用して自動的に並べ替えを実行するようピボットテーブルを設定します。 これは、UI から自動並べ替えを適用するのと同じ動作です。
setAutoSortOnCell(cell: Range | string, sortBy: Excel.SortBy): void;
パラメーター
- cell
-
Excel.Range | string
オートソートを適用するための条件の取得に使用する 1 つのセル。
- sortBy
- Excel.SortBy
並べ替えの方向。
返品
void
注釈
[API セット: ExcelApi 1.9]
setAutoSortOnCell(cell, sortBy)
必要なすべての条件とコンテキストを自動的に選択するため、指定したセルを使用して自動的に並べ替えを実行するようピボットテーブルを設定します。 これは、UI から自動並べ替えを適用するのと同じ動作です。
setAutoSortOnCell(cell: Range | string, sortBy: "Ascending" | "Descending"): void;
パラメーター
- cell
-
Excel.Range | string
オートソートを適用するための条件の取得に使用する 1 つのセル。
- sortBy
-
"Ascending" | "Descending"
並べ替えの方向。
返品
void
注釈
[API セット: ExcelApi 1.9]
toJSON()
API オブジェクトが JSON.stringify() に渡されるときに、より有用な出力を提供するために、JavaScript toJSON() メソッドをオーバーライドします。 (次に、JSON.stringify渡されたオブジェクトの toJSON メソッドを呼び出します)。元の Excel.PivotLayout オブジェクトが API オブジェクトであるのに対し、 toJSON メソッドは、元のオブジェクトから読み込まれた子プロパティの浅いコピーを含むプレーンな JavaScript オブジェクト ( Excel.Interfaces.PivotLayoutData と型指定) を返します。
toJSON(): Excel.Interfaces.PivotLayoutData;