Excel VBAリファレンス(ChartGroupsコレクション、ChartGroupオブジェクト編)

2024-01-07

ChartGroupオブジェクトはグラフのデータ系列を表し、ChartGroupsコレクションはグラフ内の全てのデータ系列を表します。
⇒Excel VBAの主なオブジェクトについては、Excel VBAリファレンス(Excel VBAのオブジェクト構造編)を参照して下さい。

■ChartGroupsコレクションの詳細

ChartGroupsコレクションで提供されているメソッドとプロパティは下表の通りです。

ChartGroupsコレクションのメソッド

Itemメソッド
説明 コレクションから単一のオブジェクトを取得する
定義 Function Item(Index As Variant) As ChartGroup

ChartGroupsコレクションのプロパティ

Applicationプロパティ(読み取り専用)
説明 オブジェクトを作成したアプリケーションを表すApplicationオブジェクトを取得
定義 Property Application() As Application
Countプロパティ(読み取り専用)
説明 コレクションに含まれるオブジェクトの数を取得
定義 Property Count() As Long
Creatorプロパティ(読み取り専用)
説明 オブジェクトを作成したアプリケーションの整数値を取得

(※)XlCreator列挙体は、以下の値のみ。
xlCreatorCode(1480803660):Macintosh版Excelでのシグネチャ

定義 Property Creator() As XlCreator
Parentプロパティ(読み取り専用)
説明 指定したオブジェクトの親オブジェクトを取得
定義 Property Parent() As Object

■ChartGroupオブジェクトの詳細

ChartGroupオブジェクトで提供されているメソッドとプロパティは下表の通りです。

ChartGroupオブジェクトのメソッド

CategoryCollectionメソッド
説明 グラフグループ内の全ての表示カテゴリを表すCategoryCollectionコレクションを取得する
定義 Function CategoryCollection([Index As Variant]) As CategoryCollection
FullCategoryCollectionメソッド
説明 グラフグループ内の全ての表示およびフィルター処理されたカテゴリを表すCategoryCollectionコレクションを取得する
定義 Function FullCategoryCollection([Index As Variant]) As CategoryCollection
SeriesCollectionメソッド
説明 単一の系列を表すSeriesオブジェクトまたは全ての系列を表すSeriesCollectionコレクションを取得する
定義 Function SeriesCollection(Index As Variant) As Object

ChartGroupオブジェクトのプロパティ

Applicationプロパティ(読み取り専用)
説明 オブジェクトを作成したアプリケーションを表すApplicationオブジェクトを取得
定義 Property Application() As Application
AxisGroupプロパティ
説明 指定したグラフのグループを設定/取得

(※)XlAxisGroup列挙体の値は、以下の通り。
xlPrimary(1):プライマリ軸グループ
xlSecondary(2):セカンダリ軸グループ

定義 Property AxisGroup() As XlAxisGroup
BinsCountValueプロパティ
説明 ヒストグラムのビンの数を設定/取得
定義 Property BinsCountValue() As Long
BinsOverflowEnabledプロパティ
説明 ヒストグラムのオーバーフロービンを有効にするかどうかを設定/取得(Trueの場合、有効)
定義 Property BinsOverflowEnabled() As Boolean
BinsOverflowValueプロパティ
説明 ヒストグラムのオーバーフロービンの下限値を設定/取得
定義 Property BinsOverflowValue() As Double
BinsTypeプロパティ
説明 ヒストグラムの横軸の書式設定をビンの種類毎に設定/取得

(※)xlBinsType列挙体の値は、以下の通り。
xlBinsTypeAutomatic(0): ビンの種類を自動的に設定
xlBinsTypeCategorical(1):カテゴリ別にビンの種類を設定
xlBinsTypeManual(2):手動でビンの種類を設定
xlBinsTypeBinSize(3):サイズ別にビンの種類を設定
xlBinsTypeBinCount(4):カウント別にビンの種類を設定

定義 Property BinsType() As xlBinsType
BinsUnderflowEnabledプロパティ
説明 ヒストグラムのアンダーフロービンを有効にするかどうかを設定/取得(Trueの場合、有効)
定義 Property BinsUnderflowEnabled() As Boolean
BinsUnderflowValueプロパティ
説明 ヒストグラムのアンダーフロービンの上限値を設定/取得
定義 Property BinsUnderflowValue() As Double
BinWidthValueプロパティ
説明 ヒストグラムのビンの幅をポイント単位で設定/取得
定義 Property BinWidthValue() As Double
BubbleScaleプロパティ
説明 バブルチャートにおけるバブルのスケールファクター(※)を設定/取得

(※)既定のバブルサイズに対するパーセンテージ。

定義 Property BubbleScale() As Long
Creatorプロパティ(読み取り専用)
説明 オブジェクトを作成したアプリケーションの整数値を取得

(※)XlCreator列挙体は、以下の値のみ。
xlCreatorCode(1480803660):Macintosh版Excelでのシグネチャ

定義 Property Creator() As XlCreator
DoughnutHoleSizeプロパティ
説明 ドーナツグラフの穴のサイズを設定/取得

(※)グラフのサイズに対するパーセンテージ。

定義 Property DoughnutHoleSize() As Long
DownBarsプロパティ(読み取り専用)
説明 線グラフの下線を表すDownBarsオブジェクトを取得
定義 Property DownBars() As DownBars
DropLinesプロパティ(読み取り専用)
説明 線グラフまたは面グラフ上の系列の降下線を表すDropLinesオブジェクトを取得
定義 Property DropLines() As DropLines
FirstSliceAngleプロパティ
説明 円グラフまたはドーナツグラフの最初のスライスの角度を設定/取得

(※)縦の中心から時計回りの度数。

定義 Property FirstSliceAngle() As Long
GapWidthプロパティ
説明 棒グラフにおけるバーまたは列のクラスタ間のスペースを設定/取得

(※)バーまたは列の幅に対するパーセンテージ。

定義 Property GapWidth() As Long
Has3DShadingプロパティ
説明 3D網掛けプロパティを適用するかどうか設定/取得(Trueの場合、適用する)
定義 Property Has3DShading() As Boolean
HasDropLinesプロパティ
説明 線グラフまたは面グラフに降下線を表示するかどうかを設定/取得(Trueの場合、表示する)
定義 Property HasDropLines() As Boolean
HasHiLoLinesプロパティ
説明 折れ線グラフに高低線を表示するかどうかを設定/取得(Trueの場合、表示する)
定義 Property HasHiLoLines() As Boolean
HasRadarAxisLabelsプロパティ
説明 レーダーチャートに軸ラベルを表示するかどうかを設定/取得(Trueの場合、表示する)
定義 Property HasRadarAxisLabels() As Boolean
HasSeriesLinesプロパティ
説明 積み上げグラフ、円グラフ、棒グラフに系列線を表示するかどうかを設定/取得(Trueの場合、表示する)
定義 Property HasSeriesLines() As Boolean
HasUpDownBarsプロパティ
説明 折れ線グラフに上下のバーを表示するかどうかを設定/取得(Trueの場合、表示する)
定義 Property HasUpDownBars() As Boolean
HiLoLinesプロパティ(読み取り専用)
説明 線グラフ上の系列の高低線を表すHiLoLinesオブジェクトを取得
定義 Property HiLoLines() As HiLoLines
Indexプロパティ(読み取り専用)
説明 コレクション内でのオブジェクトのインデックス番号を取得
定義 Property Index() As Long
Overlapプロパティ
説明 2D棒グラフおよび2D列グラフの横棒と縦棒の配置方法を設定/取得
定義 Property Overlap() As Long
Parentプロパティ(読み取り専用)
説明 指定したオブジェクトの親オブジェクトを取得
定義 Property Parent() As Object
RadarAxisLabelsプロパティ(読み取り専用)
説明 レーダーチャートの軸ラベルを表すTickLabelsオブジェクトを取得
定義 Property RadarAxisLabels() As TickLabels
SecondPlotSizeプロパティ
説明 円グラフのセカンダリセクションのサイズを設定/取得

(※)円グラフのプライマリセクションのサイズに対するパーセンテージ。

定義 Property SecondPlotSize() As Long
SeriesLinesプロパティ(読み取り専用)
説明 積み上げグラフまたは円グラフの系列線を表すSeriesLinesオブジェクトを取得
定義 Property SeriesLines() As SeriesLines
ShowNegativeBubblesプロパティ
説明 バブルチャートに負のバブルを表示するかどうかを設定/取得(Trueの場合、表示する)
定義 Property ShowNegativeBubbles() As Boolean
SizeRepresentsプロパティ
説明 バブルチャートでバブルの大きさが何を表すかを設定/取得

(※)XlSizeRepresents列挙体の値は、以下の通り。
xlSizeIsArea(1):バブルの領域
xlSizeIsWidth(2):バブルの幅

定義 Property SizeRepresents() As XlSizeRepresents
SplitTypeプロパティ
説明 円グラフの2つのセクションを分割する方法を設定/取得

(※)XlChartSplitType列挙体の値は、以下の通り。
xlSplitByCustomSplit(4):第2円グラフに任意のスライドを表示
xlSplitByPercentValue(3):第2円グラフに総計値のパーセンテージをいくらか下回る値を表示
xlSplitByPosition(1):第2円グラフにデータ系列の最小値を表示
xlSplitByValue(2):第2円グラフにSplitValueプロパティによって指定された値を下回る値を表示

定義 Property SplitType() As XlChartSplitType
SplitValueプロパティ
説明 円グラフの2つのセクションを区切る閾値を設定/取得
定義 Property SplitValue() As Variant
UpBarsプロパティ(読み取り専用)
説明 線グラフの上線を表すUpBarsオブジェクトを取得
定義 Property UpBars() As UpBars
VaryByCategoriesプロパティ
説明 データマーカーに異なる色またはパターンを割当てるかどうかを設定/取得(Trueの場合、割当てる)
定義 Property VaryByCategories() As Boolean

国本温子(著),緑川吉行(著),できるシリーズ編集部(著)
出版社:インプレス
発売日:2022/3/23
単行本(ソフトカバー):A5判/912ページ

大村あつし(著),古川順平(著)
出版社:技術評論社
発売日:2021/1/9
単行本(ソフトカバー):A5判/800ページ

高橋宣成(著)
出版社:技術評論社
発売日:2019/11/25
単行本(ソフトカバー):B5変形判/576ページ

リファレンス

Posted by hides