OOoBasic/Calc/DataPilotTable

Search

total: 4821
today: 2
yesterday: 1
online: 1

recent(15)

OOoBasic/Calc/chart2/RegressionCurve

OOoBasic/Dialog/GridControl33

OOoBasic/Dialog/GridControl

Top > OOoBasic > Calc > DataPilotTable

データパイロット

データパイロット

データパイロットテーブルコンテナ

データパイロットはシート単位で設定を行います。getDataPilotTables メソッドを使用してコンテナオブジェクトを取得します。

Sub datapilottable_1
  oSheet = ThisComponent.getSheets().getByIndex(0)
  oDataPilotTables = oSheet.getDataPilotTables()
End Sub

このコンテナオブジェクトは次のインターフェースをサポートしています。

データパイロットディスクリプタ

データパイロットを設定するディスクリプタをコンテナから作成します。

Sub datapilottable_2
  oSheet = ThisComponent.getSheets().getByIndex(0)
  oDataPilotTables = oSheet.getDataPilotTables()
  oDesc = oDataPilotTables.createDataPilotDescriptor()
End Sub

プロパティ	型	説明
ColumnFields	.container.XIndexAccess	列フィールド
ColumnGrand	boolean	合計列
DataFields	.container.XIndexAccess	データフィールド
DataPilotFields	.container.XIndexAccess	全てのフィールド
DrillDownOnDoubleClick	boolean	ドリルダウンを可能にする
FilterDescriptor	.sheet.XSheetFilterDescriptor	フィルタ設定 (フィルタディスクリプタ参照)
HiddenFields	.container.XIndexAccess	隠しフィールド
IgnoreEmptyRows	boolean	空白行を無視する
Name	string	データパイロット名
PageFields	.container.XIndexAccess	ページフィールド
RepeatIfEmpty	boolean
RowFields	.container.XIndexAccess	行フィールド
RowGrand	boolean	行の総数
ShowFilterButton	boolean	フィルタの追加
SourceRange	.table.CellRangeAddress	ソースセル範囲
Tag	string	追加文字列

フィールド

ページ、行、列、データ、隠しフィールドは同じプロパティ値で設定しますが、フィールドの種類により使用されるプロパティが異なります。

プロパティ	型	説明
AutoShowInfo	.sheet.DataPilotFieldAutoShowInfo	自動的に表示オプション。下記参照
Function	.sheet.GeneralFunction	関数 (Function参照)
GroupInfo	.sheet.DataPilotFieldGroupInfo
HasAutoShowInfo	boolean	AutoShowInfo を使用する
HasLayoutInfo	boolean	HasLayoutInfo を使用する
HasReference	boolean	SelectedPage を使用する
HasSortInfo	boolean	SortInfo を使用する
IsGroupField	boolean
Items	.container.XIndexAccess	各フィールドの項目。下記参照
LayoutInfo	.sheet.DataPilotFieldLayoutInfo	フィールド表示オプション。下記参照
Name	string	フィールド名
Orientation	.sheet.DataPilotFieldOrientation	フィールドの種類
Reference	.sheet.DataPilotFieldReference
SelectedPage	string	フィルタするページ指定
ShowEmpty	boolean
SortInfo	.sheet.DataPilotFieldSortInfo	並べ替え基準 (下記参照)
UseSelectedPage	boolean	フィルタするページ指定を使用する

DataPilotFieldAutoShowInfo は .sheet.DataPilotFieldAutoShowInfo で指定します。

.sheet.DataPilotFieldAutoShowInfo
フィールド	型	説明
IsEnabled	boolean	自動表示を有効にする
ShowItemsMode	long	項目表示モード .sheet.DataPilotFieldShowItemsMode
ItemCount	long	表示項目数
DataField	string	使用するフィールド指定

ShowItemsMode の指定。.sheet.DataPilotFieldShowItemsMode

.sheet.DataPilotFieldShowItemsMode
値	数値	説明
FROM_TOP	0	上から下
FROM_BOTTOM	1	下から上

並べ替え指定の SortInfo は .sheet.DataPilotFieldSortInfo で指定します。

.sheet.DataPilotFieldSortInfo
フィールド	型	説明
Field	string
IsAscending	boolean
Mode	long	.sheet.DataPilotFieldSortMode

Mode の指定は .sheet.DataPilotFieldSortMode で行います。

.sheet.DataPilotFieldSortMode
値	数値	説明
NONE	0
MANUAL	1
NAME	2
DATA	3

LayoutInfo の指定は .sheet.DataPilotFieldLayoutInfo で行います。

.sheet.DataPilotFieldLayoutInfo
フィールド	型	説明
LayoutMode	long	.sheet.DataPilotFieldLayoutMode
AddEmptyLines	boolean	各項目の後に空白行を追加する

LayoutMode は .sheet.DataPilotFieldLayoutMode で指定します。

.sheet.DataPilotFieldLayoutMode
フィールド	説明
TABULAR_LAYOUT	表形式のレイアウト
OUTLINE_SUBTOTALS_TOP	小計が最上部にあるアウトラインレイアウト
OUTLINE_SUBTOTALS_BOTTOM	小計が最下部にあるアウトラインレイアウト

Orientation は .sheet.DataPilotFieldOrientation で指定します。

.sheet.DataPilotFieldOrientation
HIDDEN	隠し
COLUMN	列
ROW	行
PAGE	ページ
DATA	データ

フィールドの項目

getItems メソッドで取得できる各フィールドの項目は項目の表示などを切り替えられます。メソッドの返り値はコンテナオブジェクトで、次のインターフェースをサポートしています。

com.sun.star.container.XEnumerationAccess
com.sun.star.container.XIndexAccess
com.sun.star.container.XNameAccess

プロパティ	型	説明
IsHidden	boolean	非表示にする
Name	string	項目名
Position	long	項目の位置
ShowDetail	boolean	詳細を表示する

データパイロットテーブルの追加

コンテナオブジェクトにディスクリプタを insertNewByName メソッドで挿入して新しいデータパイロットテーブルを作成します。

void
insertNewByName( [in] string aName,
                   [in] .table.CellAddress aOutputAddress,
                   [in] .sheet.XDataPilotDescriptor xDescriptor )
declared in: .sheet.XDataPilotTables

新しいデータパイロットテーブルを挿入します

aName: データパイロットテーブル名
aOutputAddress: 出力先左上セル指定
xDescriptor: データパイロットテーブル指定ディスクリプタ

フィールドを作成、Orientation を設定してフィールドの種類を指定します
ディスクリプタの DataPilotFields に全てのフィールドを追加
insertNewByName メソッドでコンテナに挿入します

データパイロットテーブルの削除

既存のデータパイロットテーブルはコンテナから removeByName メソッドで削除します。

データパイロットテーブル

既存のデータパイロットテーブルはインデックスや名前、列挙型を使用して取得できます。

Sub datapilottable_10
  oSheet = ThisComponent.getSheets().getByIndex(0)
  
  oDataPilotTables = oSheet.getDataPilotTables()
  oDataPilottable = oDataPilotTables.getByIndex(0)
End Sub

更新

reflesh メソッドを呼ぶことでテーブルを更新できます。

oDataPilottable.reflesh()

テーブルの範囲

結果のテーブルの範囲は getOutputRange メソッドで取得できます。返り値は com.sun.star.table.CellRangeAddress です。

aCellRangeAddress = oDataPilottable.getOutputRange()