Class Chart
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Excelチャートを表すオブジェクトをカプセル化します。
public class Chart継承
継承されたメンバー
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
例
以下のコードは、.Netコードを使用してチャートを作成する方法を示しています。
Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];
Cells cells = sheet.Cells;
cells[0,1].PutValue("収入");
cells[1,0].PutValue("会社A");
cells[2,0].PutValue("会社B");
cells[3,0].PutValue("会社C");
cells[1,1].PutValue(10000);
cells[2,1].PutValue(20000);
cells[3,1].PutValue(30000);
int chartIndex = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15);
Chart chart = sheet.Charts[chartIndex];
chart.SetChartDataRange("A1:B4", true);
chart.ShowLegend = true;
chart.Title.Text = "収入分析";Dim workbook as Workbook = new Workbook()
Dim sheet as Worksheet = workbook.Worksheets(0)
Dim cells as Cells = sheet.Cells
cells(0,1).PutValue("収入")
cells(1,0).PutValue("会社A")
cells(2,0).PutValue("会社B")
cells(3,0).PutValue("会社C")
cells(1,1).PutValue(10000)
cells(2,1).PutValue(20000)
cells(3,1).PutValue(30000)
Dim chartIndex as Integer = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15)
Dim chart as Chart = sheet.Charts(chartIndex)
chart.SetChartDataRange("A1:B4", True);
chart.ShowLegend = True
chart.Title.Text = "収入分析"プロパティ
ActualChartSize
チャートの実際のサイズをピクセル単位で取得します。
[Obsolete("Chart.GetActualSize()メソッドを代わりに使用してください。")]
public Size ActualChartSize { get; }プロパティ値
備考
注: このメンバーは現在廃止されています。代わりに、 Chart.GetActualSize()メソッドを使用してください。 このプロパティは2022年7月以降12ヶ月後に削除されます。 Asposeはご不便をおかけしたことをお詫び申し上げます。
AutoScaling
Microsoft Excelが3-Dチャートをスケーリングして、対応する2-Dチャートに近いサイズにする場合はTrue。 RightAngleAxesプロパティはTrueでなければなりません。
public bool AutoScaling { get; set; }プロパティ値
BackWall
3-Dチャートの背面の壁を表すAspose.Cells.Charts.Chart.Wallsオブジェクトを返します。
public Walls BackWall { get; }プロパティ値
CategoryAxis
チャートのX軸を取得します。
public Axis CategoryAxis { get; }プロパティ値
ChartArea
ワークシート内のチャートエリアを取得します。
public ChartArea ChartArea { get; }プロパティ値
ChartDataTable
チャートデータテーブルを表します。
public ChartDataTable ChartDataTable { get; }プロパティ値
ChartObject
チャートシェイプを表します。
public ChartShape ChartObject { get; }プロパティ値
DepthPercent
チャートの幅に対する3-Dチャートの深さをパーセンテージで表します（20％から2000％の間）。
public int DepthPercent { get; set; }プロパティ値
DisplayNaAsBlank
#N/Aを空白値として表示するかどうかを示します。
public bool DisplayNaAsBlank { get; set; }プロパティ値
Elevation
3-Dチャートビューの高さを度数で表します。
public int Elevation { get; set; }プロパティ値
備考
チャートの視点は、チャートを表示する高さを度数で表します。 ほとんどのチャートタイプのデフォルトは15です。 このプロパティの値は-90から90の間でなければなりませんが、3-D棒グラフの場合は0から44の間でなければなりません。
FilteredNSeries
チャートでフィルタリングされたデータ系列を表すAspose.Cells.Charts.SeriesCollectionコレクションを取得します。
public SeriesCollection FilteredNSeries { get; }プロパティ値
FirstSliceAngle
最初のパイチャートまたはドーナツチャートのスライスの角度を度数で取得または設定します（垂直から時計回り）。 パイ、3-Dパイ、およびドーナツチャートにのみ適用され、0から360の範囲です。
public int FirstSliceAngle { get; set; }プロパティ値
Floor
3-Dチャートの壁を表すAspose.Cells.Charts.Chart.Floorオブジェクトを返します。
public Floor Floor { get; }プロパティ値
備考
このプロパティは3-Dパイチャートには適用されません。
GapDepth
3-Dチャート内のデータ系列間の距離をマーカー幅のパーセンテージとして取得または設定します。 このプロパティの値は0から500の間でなければなりません。
public int GapDepth { get; set; }プロパティ値
GapWidth
棒グラフまたは列のクラスタ間のスペースを棒グラフまたは列の幅のパーセンテージとして取得または設定します。 このプロパティの値は0から500の間でなければなりません。
public int GapWidth { get; set; }プロパティ値
HeightPercent
3-Dチャートの高さをチャートの幅のパーセンテージとして取得または設定します（5％から500％の間）。
public int HeightPercent { get; set; }プロパティ値
HidePivotFieldButtons
チャートがPivotChartのときにのみピボットチャートフィールドボタンを非表示にするかどうかを示します。
public bool HidePivotFieldButtons { get; set; }プロパティ値
Is3D
チャートが3Dチャートであるかどうかを示します。
public bool Is3D { get; }プロパティ値
IsRectangularCornered
チャートエリアが直角であるかどうかを示す値を取得または設定します。 デフォルトはtrueです。
public bool IsRectangularCornered { get; set; }プロパティ値
Legend
チャートの凡例を取得します。
public Legend Legend { get; }プロパティ値
Line
線を取得します。
public Line Line { get; }プロパティ値
NSeries
チャート内のデータ系列を表すAspose.Cells.Charts.SeriesCollectionコレクションを取得します。
public SeriesCollection NSeries { get; }プロパティ値
Name
チャートの名前を取得または設定します。
public string Name { get; set; }プロパティ値
PageSetup
このチャートのページ設定の説明を表します。
public PageSetup PageSetup { get; }プロパティ値
Perspective
3-Dチャートビューの視点を取得または設定します。0から100の間でなければなりません。 RightAngleAxesプロパティがTrueの場合、このプロパティは無視されます。
public short Perspective { get; set; }プロパティ値
PivotOptions
チャートに表示されるピボットコントロールを指定します。
public PivotOptions PivotOptions { get; }プロパティ値
PivotSource
ソースはピボットテーブルのデータです。 PivotSourceが空でない場合、チャートはPivotChartです。
public string PivotSource { get; set; }プロパティ値
備考
ワークシート「Sheet1」のピボットテーブル「PivotTable1」がファイル「Book1.xls」にある場合。 チャートとピボットテーブルが同じワークブックにない場合、pivotSourceは"[Book1.xls]Sheet1!PivotTable1"になります。 このプロパティを設定すると、以前のデータソース設定が失われます。
Placement
チャートがその下のセルにどのように接続されているかを表します。
public PlacementType Placement { get; set; }プロパティ値
PlotArea
チャートのプロットエリアを取得します。軸の目盛ラベルを含みます。
public PlotArea PlotArea { get; }プロパティ値
PlotBy
行または列でプロットするかどうかを取得または設定します。
public PlotDataByType PlotBy { get; }プロパティ値
PlotEmptyCellsType
空のセルをどのようにプロットするかを取得または設定します。
public PlotEmptyCellsType PlotEmptyCellsType { get; set; }プロパティ値
PlotVisibleCellsOnly
可視セルのみをプロットするかどうかを示します。
public bool PlotVisibleCellsOnly { get; set; }プロパティ値
PrintSize
印刷されたチャートのサイズを取得または設定します。
public PrintSizeType PrintSize { get; set; }プロパティ値
RightAngleAxes
チャートの軸が直角である場合はTrue。3-Dチャートにのみ適用されます（Column3Dおよび3-Dパイチャートを除く）。
public bool RightAngleAxes { get; set; }プロパティ値
備考
このプロパティがTrueの場合、Perspectiveプロパティは無視されます。
RotationAngle
3-Dチャートビューの回転を表します（プロットエリアのz軸周りの回転、度数で）。
public int RotationAngle { get; set; }プロパティ値
備考
このプロパティの値は0から360の間でなければなりませんが、3-D棒グラフの場合は0から44の間でなければなりません。 デフォルト値は20です。3-Dチャートにのみ適用されます。
SecondCategoryAxis
チャートの2番目のX軸を取得します。
public Axis SecondCategoryAxis { get; }プロパティ値
SecondValueAxis
チャートの2番目のY軸を取得します。
public Axis SecondValueAxis { get; }プロパティ値
SeriesAxis
チャートの系列軸を取得します。
public Axis SeriesAxis { get; }プロパティ値
Shapes
このチャート内のすべての描画シェイプを返します。
public ShapeCollection Shapes { get; }プロパティ値
ShowDataTable
チャートがデータテーブルを表示するかどうかを示す値を取得または設定します。
public bool ShowDataTable { get; set; }プロパティ値
ShowLegend
チャートの凡例が表示されるかどうかを示す値を取得または設定します。デフォルトはtrueです。
public bool ShowLegend { get; set; }プロパティ値
SideWall
3-Dチャートの側面の壁を表すAspose.Cells.Charts.Chart.Wallsオブジェクトを返します。
public Walls SideWall { get; }プロパティ値
SizeWithWindow
Microsoft Excelがチャートをチャートシートウィンドウのサイズに合わせてリサイズする場合はTrue。
public bool SizeWithWindow { get; set; }プロパティ値
Style
組み込みスタイルを取得または設定します。
public int Style { get; set; }プロパティ値
備考
1から48の間である必要があります。 設定されていない場合、-1を返します。
SubTitle
チャートのサブタイトルを取得します。 ODS形式のファイルのみ。
public Title SubTitle { get; }プロパティ値
Title
チャートのタイトルを取得します。
public Title Title { get; }プロパティ値
Type
チャートのタイプを取得または設定します。
public ChartType Type { get; set; }プロパティ値
ValueAxis
チャートのY軸を取得します。
public Axis ValueAxis { get; }プロパティ値
Walls
3-Dチャートの壁を表すAspose.Cells.Charts.Chart.Wallsオブジェクトを返します。
public Walls Walls { get; }プロパティ値
備考
このプロパティは3-Dパイチャートには適用されません。
WallsAndGridlines2D
3-Dチャートに2次元でグリッドラインが描画される場合はTrue。
public bool WallsAndGridlines2D { get; set; }プロパティ値
Worksheet
このチャートを含むワークシートを取得します。
public Worksheet Worksheet { get; }プロパティ値
メソッド
Calculate()
プロットエリア、軸のカスタム位置を計算します。位置が自動的に割り当てられている場合。
public void Calculate()Calculate(ChartCalculateOptions)
プロットエリア、軸のカスタム位置を計算します。位置が自動的に割り当てられている場合、チャート計算オプションを使用します。
public void Calculate(ChartCalculateOptions calculateOptions)パラメーター
calculateOptions ChartCalculateOptions
ChangeTemplate(byte[])
プリセットテンプレートでチャートタイプを変更します。
public void ChangeTemplate(byte[] data)パラメーター
data byte[]
チャートテンプレートファイルのデータ（.crtx）。
GetActualSize()
チャートの実際のサイズをピクセル単位で取得します。
public int[] GetActualSize()戻り値
int[]
配列内の実際のサイズ（幅と高さ）。 [0]は幅; [1]は高さ。
GetChartDataRange()
チャートのデータソース範囲を取得します。
public string GetChartDataRange()戻り値
データソース。
備考
範囲のみサポート。
HasAxis(AxisType, bool)
チャートに存在する軸を返します。
public bool HasAxis(AxisType aixsType, bool isPrimary)パラメーター
aixsType AxisType
isPrimary bool
戻り値
備考
通常、Pie、PieExploded、PiePie、PieBar、Pie3D、Pie3DExploded、Doughnut、DoughnutExplodedには軸がありません。
IsCellReferedByChart(int, int, int)
チャートによって参照されるセルかどうかを返します。
public bool IsCellReferedByChart(int sheetIndex, int rowIndex, int columnIndex)パラメーター
sheetIndex int
シートインデックス。-1は現在のチャートを含むワークシートを意味します。
rowIndex int
行インデックス
columnIndex int
列インデックス
戻り値
IsChartDataChanged()
チャートのデータソースが変更されたかどうかを検出します。
public bool IsChartDataChanged()戻り値
チャートが変更された場合はtrueを返し、そうでない場合はfalseを返します。
備考
このメソッドは、チャートを画像形式にレンダリングする前にチャートのデータソースの変更を検出します。 最初のChart.toImage呼び出し時に、チャートソースデータ（例：XValuesParseData、ValuesParseData）が記録されます。 再度Chart.toImageメソッドを呼び出す前に、IsChartDataChangedメソッドを呼び出して、Chartが再レンダリングする必要があるかどうかを確認します。
Move(int, int, int, int)
チャートを指定された位置に移動します。
public void Move(int upperLeftRow, int upperLeftColumn, int lowerRightRow, int lowerRightColumn)パラメーター
upperLeftRow int
左上の行インデックス。
upperLeftColumn int
左上の列インデックス。
lowerRightRow int
右下の行インデックス
lowerRightColumn int
右下の列インデックス
RefreshPivotData()
ピボットテーブルからチャートのデータを更新します。
public void RefreshPivotData()備考
ピボットデータソースからピボットテーブルレポートにデータを集めます。 このメソッドは、すべてのデータをピボットチャートに集めるためにのみ使用されます。
SetChartDataRange(string, bool)
チャートのデータ範囲を指定します。
public void SetChartDataRange(string area, bool isVertical)パラメーター
area string
データ系列をプロットするための値を指定します。
isVertical bool
セル値の範囲から行または列で系列をプロットするかどうかを指定します。
SwitchRowColumn()
行/列を切り替えます。
public bool SwitchRowColumn()戻り値
Falseは行/列の切り替えが失敗したことを意味します。
ToImage(string)
チャート画像を作成し、ファイルに保存します。 ファイル名の拡張子が画像の形式を決定します。
public void ToImage(string imageFile)パラメーター
imageFile string
フルパスの画像ファイル名。
備考
画像の形式はファイル名の拡張子を使用して指定されます。 たとえば、「myfile.png」と指定すると、画像は PNG形式で保存されます。次のファイル拡張子が認識されます: .bmp, .gif, .png, .jpg, .jpeg, .tiff, .tif, .emf。
幅または高さがゼロであるか、チャートがサポートされていない場合、Supported Charts Listに従って、このメソッドは何もしません。ToImage(string, ImageType)
チャート画像を作成し、指定された画像タイプでファイルに保存します。
public void ToImage(string imageFile, ImageType imageType)パラメーター
imageFile string
フルパスの画像ファイル名。
imageType ImageType
画像を保存する形式。
備考
画像の形式は`imageType`を使用して指定されます。 次の形式がサポートされています: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf。
幅または高さがゼロであるか、チャートがサポートされていない場合、Supported Charts Listに従って、このメソッドは何もしません。ToImage(string, long)
チャート画像を作成し、Jpeg形式でファイルに保存します。
public void ToImage(string imageFile, long jpegQuality)パラメーター
imageFile string
フルパスの画像ファイル名。
jpegQuality long
Jpeg品質。
備考
幅または高さがゼロであるか、チャートがサポートされていない場合、Supported Charts Listに従って、このメソッドは何もしません。
ToImage(Stream, long)
チャート画像を作成し、Jpeg形式でストリームに保存します。
public void ToImage(Stream stream, long jpegQuality)パラメーター
stream Stream
出力ストリーム。
jpegQuality long
Jpeg品質。
備考
幅または高さがゼロであるか、チャートがサポートされていない場合、Supported Charts Listに従って、このメソッドは何もしません。
ToImage(Stream, ImageType)
チャート画像を作成し、指定された形式でストリームに保存します。
public void ToImage(Stream stream, ImageType imageType)パラメーター
stream Stream
出力ストリーム。
imageType ImageType
画像を保存する形式。
備考
画像の形式は`imageType`を使用して指定されます。 次の形式がサポートされています: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf。
幅または高さがゼロであるか、チャートがサポートされていない場合、Supported Charts Listに従って、このメソッドは何もしません。ToImage(string, ImageOrPrintOptions)
チャート画像を作成し、ファイルに保存します。 ファイル名の拡張子が画像の形式を決定します。
public void ToImage(string imageFile, ImageOrPrintOptions options)パラメーター
imageFile string
フルパスの画像ファイル名。
options ImageOrPrintOptions
追加の画像作成オプション
例
300 dpiとCCITT4圧縮でTiffに保存します。
ImageOrPrintOptions options = new ImageOrPrintOptions();
options.HorizontalResolution = 300;
options.VerticalResolution = 300;
options.TiffCompression = TiffCompression.CompressionCCITT4;
Workbook book = new Workbook(@"test.xls");
book.Worksheets[0].Charts[0].ToImage(@"chart.Tiff", options);
[VB]
Dim options As ImageOrPrintOptions = New ImageOrPrintOptions()
options.HorizontalResolution = 300
options.VerticalResolution = 300
options.TiffCompression = TiffCompression.CompressionCCITT4
Dim book As Workbook = New Workbook("test.xls")
book.Worksheets(0).Charts(0).ToImage("chart.Tiff", options)300 dpiと80の画像品質でJpegに保存します。
ImageOrPrintOptions options = new ImageOrPrintOptions();
options.HorizontalResolution = 300;
options.VerticalResolution = 300;
options.Quality = 80;
Workbook book = new Workbook(@"test.xls");
book.Worksheets[0].Charts[0].ToImage(@"chart.Jpeg", options);
[VB]
Dim options As ImageOrPrintOptions = New ImageOrPrintOptions()
options.HorizontalResolution = 300
options.VerticalResolution = 300
options.Quality = 80
Dim book As Workbook = New Workbook("test.xls")
book.Worksheets(0).Charts(0).ToImage("chart.Jpeg", options)備考
画像の形式はファイル名の拡張子を使用して指定されます。 たとえば、「myfile.png」と指定すると、画像は PNG形式で保存されます。次のファイル拡張子が認識されます: .bmp, .gif, .png, .jpg, .jpeg, .tiff, .tif, .emf。
幅または高さがゼロであるか、チャートがサポートされていない場合、Supported Charts Listに従って、このメソッドは何もしません。 詳細については、Supported Charts Listを参照してください。ToImage(Stream, ImageOrPrintOptions)
チャート画像を作成し、指定された形式でストリームに保存します。
public void ToImage(Stream stream, ImageOrPrintOptions options)パラメーター
stream Stream
出力ストリーム。
options ImageOrPrintOptions
追加の画像作成オプション
備考
画像の形式は`options.ImageType`を使用して指定されます。 次の形式がサポートされています: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf。
幅または高さがゼロであるか、チャートがサポートされていない場合、Supported Charts Listに従って、このメソッドは何もしません。 詳細については、Supported Charts Listを参照してください。ToPdf(string)
チャートをpdfファイルに保存します。
public void ToPdf(string fileName)パラメーター
fileName string
フルパスのpdfファイル名
ToPdf(string, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)
チャートをpdfファイルに保存します。
public void ToPdf(string fileName, float desiredPageWidth, float desiredPageHeight, PageLayoutAlignmentType hAlignmentType, PageLayoutAlignmentType vAlignmentType)パラメーター
fileName string
フルパスのpdfファイル名
desiredPageWidth float
インチ単位の希望するページ幅。
desiredPageHeight float
インチ単位の希望するページ高さ。
hAlignmentType PageLayoutAlignmentType
出力ページ内のチャートの水平方向の配置タイプ。
vAlignmentType PageLayoutAlignmentType
出力ページ内のチャートの垂直方向の配置タイプ。
ToPdf(Stream)
チャートpdfを作成し、ストリームに保存します。
public void ToPdf(Stream stream)パラメーター
stream Stream
出力ストリーム。
ToPdf(Stream, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)
チャートpdfを作成し、ストリームに保存します。
public void ToPdf(Stream stream, float desiredPageWidth, float desiredPageHeight, PageLayoutAlignmentType hAlignmentType, PageLayoutAlignmentType vAlignmentType)パラメーター
stream Stream
出力ストリーム。
desiredPageWidth float
インチ単位の希望するページ幅。
desiredPageHeight float
インチ単位の希望するページ高さ。
hAlignmentType PageLayoutAlignmentType
出力ページ内のチャートの水平方向の配置タイプ。
vAlignmentType PageLayoutAlignmentType
出力ページ内のチャートの垂直方向の配置タイプ。
