class documentation
class Chart:
チャートを取り扱うクラスです。
Method | chart |
チャートを作成します。Excelマクロとメソッドの引数の順番が違うので、注意してください。 |
Method | clear |
すべてのカテゴリー軸のフィルターを解除します。 |
Method | clear |
すべてのシリーズ軸のフィルターを解除します。 |
Method | clear |
チャートの背面の画像を除去します。 |
Method | clear |
特定のカテゴリー軸のフィルターを解除します。 |
Method | clear |
特定のシリーズ軸のフィルターを解除します。 |
Method | delete |
チャートの軸を除去します。 |
Method | get |
チャートのオブジェクトが自動スケールするかどうかを取得します。 |
Method | get |
チャートの軸クラスを取得します。 |
Method | get |
チャートの背面クラスを取得します。 |
Method | get |
3D棒グラフまたは列グラフで使用するBar形状を取得します。 |
Method | get |
カテゴリラベルの表示行を取得します。 |
Method | get |
チャートの表示領域クラスを取得します。 |
Method | get |
チャート色番号列挙体の整数値を取得します。(チャート色番号は、Excel画面のグラフデザイン項目の色の変更項目を参照してください) |
Method | get |
チャートグループクラスを取得します。 |
Method | get |
チャートのグラフスタイルの内部番号を取得します。(チャート種類により異なります。Excel画面のグラフデザイン項目のグラフスタイル項目に該当します) |
Method | get |
チャートのタイトルクラスを取得します。 |
Method | get |
チャート種類を取得します。 |
Method | get |
チャートのデータソース(A1C1)領域を取得します。 |
Method | get |
チャートのデータテーブルクラスを取得します。 |
Method | get |
チャートの奥ゆき(パーセント)を取得します。 |
Method | get |
チャートの空白データの扱い方を取得します。 |
Method | get |
チャートの表示データのERRORデータを空白として扱うかどうかを示します。 |
Method | get |
チャートの表示角度を取得します。 |
Method | get |
チャートの床領域クラスを取得します。 |
Method | get |
非表示のシリーズを含めたシリーズ(系列)クラスを取得します。 |
Method | get |
3-Dグラフのデータ系列間の距離を取得します。 |
Method | get |
3-Dグラフの高さをグラフの幅に対するパーセント値 (%) で取得します。 |
Method | get |
チャートの凡例領域のクラスを取得します。 |
Method | get |
印刷設定オブジェクトを取得します。 |
Method | get |
3Dグラフの視点位置(パーセント)を取得します。 |
Method | get |
チャートの表示ベース領域クラスを取得します。 |
Method | get |
チャートのデータの向きを取得します。 |
Method | get |
チャートを非表示データを含めて描画するか取得します。 |
Method | get |
チャートのデータの保護状態を取得します。 |
Method | get |
チャートのグラフの保護状態を取得します。 |
Method | get |
チャートの書式の保護状態を取得します。 |
Method | get |
チャートの選択領域の保護状態を取得します。 |
Method | get |
グラフの軸を直角、グラフの回転角または仰角とは無関係かどうかを取得します。 |
Method | get |
3Dグラフの回転角(プロットエリアのz軸周りの回転角度)を取得します。 |
Method | get |
シリーズ(系列)クラスを取得します。 |
Method | get |
シリーズラベルの表示行を取得します。 |
Method | get |
チャートの側面領域クラスを取得します |
Method | has |
チャートが軸を持っているかどうかを取得します。 |
Method | has |
チャートのデータテーブル領域が表示されているかどうかを取得します。 |
Method | has |
チャートの凡例領域が表示されているかどうかを示します。 |
Method | has |
チャートのタイトル領域が表示されているかどうかを取得します。 |
Method | pivot |
ピボットチャートを作成します。 |
Method | set |
ピボットグラフのすべてのフィールド ボタンを表示するかどうかを取得します。 |
Method | set |
チャートのオブジェクトが自動スケールするかどうかを設定します。 |
Method | set |
チャートの軸を設定します。 |
Method | set |
ピボットグラフの軸フィールドボタンを表示するかどうかを設定します。 |
Method | set |
チャートの背面の画像を設定します。 |
Method | set |
3D棒グラフまたは列グラフで使用するBar形状を取得します。 |
Method | set |
特定のカテゴリー軸をフィルターします。 |
Method | set |
カテゴリラベルの表示行を設定します。 |
Method | set |
チャート種類を設定します。 |
Method | set |
データラベルの表示有無を設定します。チャート全体に適用されます。 |
Method | set |
値が値軸の最大値より大きい場合にデータラベルを表示するかどうかを設定します。 |
Method | set |
データソースを設定します。 |
Method | set |
チャートのデータテーブル領域が表示されているかどうかを設定します。 |
Method | set |
チャートの奥ゆき(パーセント)を設定します。 |
Method | set |
チャートの空白データの扱い方を設定します。 |
Method | set |
チャートの表示データのERRORデータを空白として扱うかどうかを設定します。 |
Method | set |
チャートの表示角度を設定します。 |
Method | set |
ピボットチャートにフィールド全体を展開およびフィールド全体を折りたたむボタンが表示するかどうかを設定します。 |
Method | set |
3-Dグラフのデータ系列間の距離を設定します。 |
Method | set |
3-Dグラフの高さをグラフの幅に対するパーセント値 (%) で設定します。 |
Method | set |
チャートの凡例領域が表示されているかどうかを設定します。 |
Method | set |
ピボットグラフの凡例フィールドボタンを表示するかどうかを設定します。 |
Method | set |
現在の印刷設定を設定します。 |
Method | set |
3Dグラフの視点位置(パーセント)を設定します。 |
Method | set |
チャートを非表示データを含めて描画するかどうかを設定します。 |
Method | set |
チャートのデータの保護状態を設定します。 |
Method | set |
チャートのグラフの保護状態を設定します。 |
Method | set |
チャートの書式の保護状態を設定します。 |
Method | set |
チャートの選択領域の保護状態を設定します。 |
Method | set |
ピボットグラフのレポートフィルターフィールドボタンを表示するかどうかを設定します。 |
Method | set |
グラフの軸を直角、グラフの回転角または仰角とは無関係かどうかを設定します。 |
Method | set |
特定のシリーズ軸をフィルターします。 |
Method | set |
シリーズラベルの表示行を設定します。 |
Method | set |
チャートのタイトル領域が表示されているかどうかを設定します。 |
Method | set |
ピボットグラフの値フィールドボタンを表示するかどうかを設定します。 |
Method | show |
ピボットグラフのすべてのフィールド ボタンを表示しているかどうかを取得します。 |
Method | show |
ピボットグラフの軸フィールドボタンを表示しているかどうかを取得します。 |
Method | show |
値が値軸の最大値より大きい場合にデータラベルを表示するかどうかを取得します。 |
Method | show |
ピボットチャートにフィールド全体を展開およびフィールド全体を折りたたむボタンが表示されているかどうかを取得します。 |
Method | show |
ピボットグラフの凡例フィールドボタンを表示するかどうかを取得します。 |
Method | show |
ピボットグラフのレポートフィルターフィールドボタンを表示するかどうかを取得します。 |
Method | show |
ピボットグラフの値フィールドボタンを表示するかどうかを取得します。 |
def chartWizard(self, source:
str
, chartType: enums.XlChartType
, plotBy: enums.XlRowCol
, seriesLabelLines: int
, categoryLabelLines: int
, chartStyleNo: int
= 1, chartColorNo: enums.XlChartColorPalette
= enums.XlChartColorPalette.XlPaletteColorful1, hasLegend: bool
= False, title: str
= '', categoryTitle: str
= '', valueTitle: str
= '', extraTitle: str
= ''):
¶
チャートを作成します。Excelマクロとメソッドの引数の順番が違うので、注意してください。
Parameters | |
source:str | チャートに用いるデータ領域(A1C1形式またはテーブル名) |
chartXlChartType | チャート種類 |
plotXlRowCol | チャートの向き (データ系列が行方向にある場合、XlRowCol.Columnsとなります) |
seriesint | シリーズ方向のヘッダ行数(ヘッダなしの場合は、0となります) |
categoryint | カテゴリ方向のヘッダ行数(ヘッダなしの場合は、0となります) |
chartint , optional | チャートのグラフスタイル(1 ~ 最大14: チャート種類により異なります。Excel画面のグラフデザイン項目のグラフスタイル項目に該当します) |
chartXlChartColorPalette , optional | チャート色番号列挙体(Excel画面のグラフデザイン項目の色の変更項目を参照してください) |
hasbool , optional | true:凡例を表示する false:凡例を表示しない |
title:str , optional | チャートのタイトル(空文字の場合は設定しない) |
categorystr , optional | カテゴリー軸方向タイトル(空文字の場合は設定しない) |
valuestr , optional | シリーズ軸方向タイトル(空文字の場合は設定しない) |
extrastr , optional | 3D軸方向タイトル(空文字の場合は設定しない) |
def deleteAxis(self, axisType:
enums.XlAxisType
, axisGroup: enums.XlAxisGroup
= enums.XlAxisGroup.Primary):
¶
チャートの軸を除去します。
Parameters | |
axisXlAxisType | 軸の種類 |
axisXlAxisGroup , optional | 軸のグループ |
def getAxes(self, axisType:
enums.XlAxisType
, axisGroup: enums.XlAxisGroup
= enums.XlAxisGroup.Primary) -> Axis
:
¶
チャートの軸クラスを取得します。
Parameters | |
axisXlAxisType | 軸の種類 |
axisXlAxisGroup , optional | 軸のグループ |
Returns | |
Axis | チャートの軸クラス |
チャートのグラフスタイルの内部番号を取得します。(チャート種類により異なります。Excel画面のグラフデザイン項目のグラフスタイル項目に該当します)
この番号は、Excel内部で保持しているグラフスタイルの番号となり、chartWizardメソッドで設定した1~14の値ではありません。
Returns | |
int | チャートのグラフスタイルの内部番号 |
グラフの軸を直角、グラフの回転角または仰角とは無関係かどうかを取得します。
3D線グラフ、列グラフ、および棒グラフにのみ適用されます。
Returns | |
bool | true: 無関係 false: 無関係でない |
def hasAxis(self, axisType:
enums.XlAxisType
, axisGroup: enums.XlAxisGroup
= enums.XlAxisGroup.Primary) -> bool
:
¶
チャートが軸を持っているかどうかを取得します。
Parameters | |
axisXlAxisType | 軸の種類 |
axisXlAxisGroup , optional | 軸のグループ |
Returns | |
bool | チャートが軸を持っているか |
チャートのデータテーブル領域が表示されているかどうかを取得します。
Returns | |
bool | true: チャートのデータテーブル領域が表示されている false: チャートのデータテーブル領域が表示されていない |
def pivotChartWizard(self, source:
str
, chartType: enums.XlChartType
, chartStyleNo: int
= 1, chartColorNo: enums.XlChartColorPalette
= enums.XlChartColorPalette.XlPaletteColorful1):
¶
ピボットチャートを作成します。
Parameters | |
source:str | チャートに用いるデータ領域(ピボットテーブル名となります) |
chartXlChartType | チャート種類 |
chartint , optional | チャートのグラフスタイル(1 ~ 最大14: チャート種類により異なります。Excel画面のグラフデザイン項目のグラフスタイル項目に該当します) |
chartXlChartColorPalette , optional | チャート色番号列挙体(Excel画面のグラフデザイン項目の色の変更項目を参照してください) |
def setAxis(self, axisType:
enums.XlAxisType
, axisGroup: enums.XlAxisGroup
= enums.XlAxisGroup.Primary):
¶
チャートの軸を設定します。
Parameters | |
axisXlAxisType | 軸の種類 |
axisXlAxisGroup , optional | 軸のグループ |
def setDataLabels(self, legendKey:
bool
, showLeaderLines: bool
, showSeriesName: bool
, showCategoryName: bool
, showValue: bool
, showPercentage: bool
, showBubbleSize: bool
, separator: str
= ','):
¶
データラベルの表示有無を設定します。チャート全体に適用されます。
Parameters | |
legendbool | true:凡例のデータラベルを表示 false:表示しない |
showbool | true:導線のデータラベルを表示 false:表示しない |
showbool | true:シリーズ名のデータラベルを表示 false:表示しない |
showbool | true:カテゴリー名のデータラベルを表示 false:表示しない |
showbool | true:値のデータラベルを表示 false:表示しない |
showbool | true:値のパーセントのデータラベルを表示 false:表示しない |
showbool | true:バブルグラフのサイズのデータラベルを表示 false:表示しない |
separator:str , optional | データラベルの区切り文字(既定値:,) |
def setDataSource(self, source:
str
, plotBy: enums.XlRowCol
, seriesLabelLines: int
, categoryLabelLines: int
):
¶
データソースを設定します。
チャートがピボットチャートの場合、このメソッドは使用できません。
Parameters | |
source:str | データソース領域(A1C1またはテーブル名) |
plotXlRowCol | データの向き |
seriesint | シリーズ軸のラベル行数(ヘッダなしの場合は、0となります) |
categoryint | カテゴリ軸のラベル行数(ヘッダなしの場合は、0となります) |
ピボットグラフの凡例フィールドボタンを表示するかどうかを設定します。
Parameters | |
show:bool | true:ピボットグラフの凡例フィールドボタンを表示する false:ピボットグラフの凡例フィールドボタンを表示しない |
ピボットグラフのレポートフィルターフィールドボタンを表示するかどうかを設定します。
Parameters | |
show:bool | true:ピボットグラフの凡例フィールドボタンを表示する false:ピボットグラフの凡例フィールドボタンを表示しない |
ピボットグラフの値フィールドボタンを表示するかどうかを設定します。
Parameters | |
show:bool | true: ピボットグラフの値フィールドボタンを表示する false:ピボットグラフの値フィールドボタンを表示する |
ピボットチャートにフィールド全体を展開およびフィールド全体を折りたたむボタンが表示されているかどうかを取得します。
Returns | |
bool | true: ピボットチャートにフィールド全体を展開およびフィールド全体を折りたたむボタンが表示されている |
ピボットグラフの凡例フィールドボタンを表示するかどうかを取得します。
Returns | |
bool | true: ピボットグラフの凡例フィールドボタンを表示する false: ピボットグラフの凡例フィールドボタンを表示しない |
ピボットグラフのレポートフィルターフィールドボタンを表示するかどうかを取得します。
Returns | |
bool | true: ピボットグラフのレポートフィルターフィールドボタンを表示する false:ピボットグラフのレポートフィルターフィールドボタンを表示しない |