MESCIUS SPREAD for Windows Forms 17.0J
円チャートの作成
MESCIUS SPREAD for Windows Forms 17.0J > 開発者ガイド > チャート > チャートの作成 > プロットの作成 > 円チャートの作成

円チャートは、コーディングまたはデザイナを使用して作成できます。次の図は、電子製品の販売に関する情報を示す円チャートの例です。

 

APIに関する詳細は、PiePlotArea クラスを参照してください。また、円チャートの作成には、円チャートのデータ系列を表すPieSeries  クラスを使用します。

  • 分離円を設定するには、PieSeriesクラスのPieDetachments プロパティを設定します。
  • ドーナツチャートを作成するには、PiePlotAreaクラスのHoleSize プロパティで、円チャートの中央の穴の大きさを設定します。

設定方法

  1. 円チャートのデータ系列を表すPieSeries オブジェクトを作成し、データを追加します。
  2. プロットエリアを表すPiePlotArea オブジェクトを作成し、位置とサイズを設定します。
  3. プロットエリアにデータ系列を追加します。
  4. ラベル、および凡例エリアを作成します。
  5. ChartModel オブジェクトを作成し、プロットエリア、ラベル、および凡例エリアを追加します。
  6. チャートにチャートモデルを割り当てます。

サンプルコード

次のサンプルコードは、店にある電子製品（携帯電話、ラップトップ、タブレット）の年間売上高を表示する円チャートを作成する例です。

C#
コードのコピー 
// 円チャートを作成します。
fpSpread1.Sheets[0].Cells[0, 0].Text = "製品";
fpSpread1.Sheets[0].Cells[1, 0].Text = "携帯電話";
fpSpread1.Sheets[0].Cells[2, 0].Text = "ラップトップ";
fpSpread1.Sheets[0].Cells[3, 0].Text = "タブレット";
fpSpread1.Sheets[0].Cells[0, 1].Text = "製品販売(2018年)(百万ドル単位)";
fpSpread1.Sheets[0].Cells[1, 1].Value = 59.3;
fpSpread1.Sheets[0].Cells[2, 1].Value = 34.7;
fpSpread1.Sheets[0].Cells[3, 1].Value = 18.2;
CurrencyCellType currencycell = new CurrencyCellType();
currencycell.DecimalPlaces = 2;
currencycell.ShowCurrencySymbol = true;
currencycell.CurrencySymbol = "$";
fpSpread1.Sheets[0].Cells[1, 1, 3, 1].CellType = currencycell;
FarPoint.Win.Spread.Chart.SpreadChart chart = fpSpread1.Sheets[0].AddChart(0, 0, typeof(FarPoint.Win.Chart.PieSeries), 400, 370, 240, 30);
FarPoint.Win.Chart.PieSeries series = (FarPoint.Win.Chart.PieSeries)chart.Model.PlotAreas[0].Series[0];
series.LabelVisible = true;
series.LabelContainsCategoryName = true;
series.LabelContainsValue = true;
Visual Basic
コードのコピー 
' 円チャートを作成します。
fpSpread1.Sheets(0).Cells(0, 0).Text = "製品"
fpSpread1.Sheets(0).Cells(1, 0).Text = "携帯電話"
fpSpread1.Sheets(0).Cells(2, 0).Text = "ラップトップ"
fpSpread1.Sheets(0).Cells(3, 0).Text = "タブレット"
fpSpread1.Sheets(0).Cells(0, 1).Text = "製品販売(2018年)(百万ドル単位)"
fpSpread1.Sheets(0).Cells(1, 1).Value = 59.3
fpSpread1.Sheets(0).Cells(2, 1).Value = 34.7
fpSpread1.Sheets(0).Cells(3, 1).Value = 18.2
Dim currencycell As CurrencyCellType = New CurrencyCellType()
currencycell.DecimalPlaces = 2
currencycell.ShowCurrencySymbol = True
currencycell.CurrencySymbol = "$"
fpSpread1.Sheets(0).Cells(1, 1, 3, 1).CellType = currencycell
Dim chart As FarPoint.Win.Spread.Chart.SpreadChart = fpSpread1.Sheets(0).AddChart(0, 0, GetType(FarPoint.Win.Chart.PieSeries), 400, 370, 240, 30)
Dim series As FarPoint.Win.Chart.PieSeries = CType(chart.Model.PlotAreas(0).Series(0), FarPoint.Win.Chart.PieSeries)
series.LabelVisible = True
series.LabelContainsCategoryName = True
series.LabelContainsValue = True

 

また、円チャートにパーセンテージのラベルを追加するには、PieSeriesクラスのLabelContainsPercentageプロパティを使用します。このプロパティはブール値を受け入れ、デフォルトではfalseです。

C#
コードのコピー 
// 円チャートでパーセンテージのラベルを有効にします。
series.LabelContainsPercentage = true;
Visual Basic
コードのコピー 
' 円チャートでパーセンテージのラベルを有効にします。
series.LabelContainsPercentage = True

SPREAD デザイナの使用

  1. ［チャートデザイナ］を起動します。
  2. 左側のツリーメニューから対象の［チャートモデル］を選択します。
  3. 右側のプロパティリストの［その他］セクションのProtAreasから［プロットエリアコレクションエディタ］を開きます。
  4. ［追加］ボタンの右横のドロップダウンボタンをクリックします。
  5. PiePlotAreaを選択して追加し、各プロパティを必要に応じて設定します。
［チャートデザイナ］の起動については、「SPREADデザイナガイド」の「チャートデザイナ」を参照してください。

 

 

© MESCIUS inc. All rights reserved.