MESCIUS SPREAD for Windows Forms 17.0J
スパークラインの操作
MESCIUS SPREAD for Windows Forms 17.0J > 開発者ガイド > スパークライン > メソッドを使用してスパークラインの追加 > スパークラインの操作

ユーザーは、Windows標準のショットカットキーを使用して、スパークラインをコピー、貼り付け、切り取り、削除できます。

また、コードでスパークラインをグループ化することもできます。

スパークラインのグループ化

スパークラインをグループ化すると、複数のスパークラインに対して、スパークラインの種類やマーカー、データポイントの色や軸の設定を共有できます。

グループ化すると、スパークラインが1つの新規グループとしてマージされ、以前のグループからは削除されます。選択した複数のスパークラインが、それぞれ種類の異なるグループに属している場合は、最後に選択したグループの種類が新規グループに適用されます。新規グループは、最後に選択したグループの設定を維持します。

選択したスパークラインのグループ化を解除すると、これらのスパークラインは、1つのスパークラインのみで構成される個々のグループに分離されます。 元のスパークラインのデータおよび場所の範囲は、新規グループにも使用されます。 元のグループの設定も、新規グループに使用されます。

グループを削除すると、その中のスパークラインもすべて削除されます。すべてのスパークラインを削除するには、SheetViewクラスのClearSparklinesメソッドを使用します。

グループをコピーすると、それは新しいグループとして新しい位置に貼り付けられます。グループから単一のスパークラインをコピーした場合、このスパークラインのみが存在する新しいグループが作成されます。

一つのスパークラインしか存在しない場合も、このスパークラインのみで構成されるグループとしてグループ化されています。AddSparklineメソッドまたはAddSquareSparklineメソッドの戻り値は、スパークラインが追加されたグループです。

スパークラインの行と列の入れ替え

SheetViewクラスのAddSquareSparklineメソッドで追加したスパークラインは、データ範囲の行と列を入れ替えることができます。

行と列を入れ替えるには、ExcelSparklineGroupクラスのSwitchRowColumnメソッドを使用します。この場合、データ範囲の行数および列数は同一である必要があります。

設定方法

スパークラインをグループ化するには、SheetViewクラスのGroupSparklineメソッドを使用します。グループ化を解除するには、UnGroupSparklineメソッドを使用します。

サンプルコード

次のサンプルコードは、スパークラインをグループ化します。

C#
コードのコピー 
private void Form1_Load(object sender, EventArgs e)
{
    fpSpread1.Sheets[0].Cells[0, 0].Value = 2;
    fpSpread1.Sheets[0].Cells[0, 1].Value = 5;
    fpSpread1.Sheets[0].Cells[0, 2].Value = 4;
    fpSpread1.Sheets[0].Cells[0, 3].Value = -1;
    fpSpread1.Sheets[0].Cells[0, 4].Value = 3;
    fpSpread1.Sheets[0].Cells[1, 0].Value = 3;
    fpSpread1.Sheets[0].Cells[1, 1].Value = 1;
    fpSpread1.Sheets[0].Cells[1, 2].Value = 2;
    fpSpread1.Sheets[0].Cells[1, 3].Value = -1;
    fpSpread1.Sheets[0].Cells[1, 4].Value = 5;
    fpSpread1.Sheets[0].Cells[2, 0].Value = 3;
    fpSpread1.Sheets[0].Cells[2, 1].Value = 1;
    fpSpread1.Sheets[0].Cells[2, 2].Value = 2;
    fpSpread1.Sheets[0].Cells[2, 3].Value = -1;
    fpSpread1.Sheets[0].Cells[2, 4].Value = 5;
    // 1つ目のスパークラインを作成します
    FarPoint.Win.Spread.Chart.SheetCellRange data1 = new FarPoint.Win.Spread.Chart.SheetCellRange(fpSpread1.Sheets[0], 0, 0, 1, 5);
    fpSpread1.Sheets[0].AddSparkline(data1, new FarPoint.Win.Spread.Model.CellRange(0, 5, 1, 1),
        FarPoint.Win.Spread.SparklineType.Line, new FarPoint.Win.Spread.ExcelSparklineSetting() { ShowMarkers = true, MarkersColor = Color.Red });
    // 2つ目のスパークラインを作成します
    FarPoint.Win.Spread.Chart.SheetCellRange data2 = new FarPoint.Win.Spread.Chart.SheetCellRange(fpSpread1.Sheets[0], 1, 0, 1, 5);
    fpSpread1.Sheets[0].AddSparkline(data2, new FarPoint.Win.Spread.Model.CellRange(1, 5, 1, 1),
        FarPoint.Win.Spread.SparklineType.Line, new FarPoint.Win.Spread.ExcelSparklineSetting() { ShowMarkers = true, MarkersColor = Color.Green });
    // 3つ目のスパークラインを作成します
    FarPoint.Win.Spread.Chart.SheetCellRange data3 = new FarPoint.Win.Spread.Chart.SheetCellRange(fpSpread1.Sheets[0], 2, 0, 1, 5);
    fpSpread1.Sheets[0].AddSparkline(data3, new FarPoint.Win.Spread.Model.CellRange(2, 5, 1, 1),
        FarPoint.Win.Spread.SparklineType.Line, new FarPoint.Win.Spread.ExcelSparklineSetting() { ShowMarkers = true, MarkersColor = Color.Blue });
}
private void button1_Click(object sender, EventArgs e)
{
    // スパークラインをグループ化します
    FarPoint.Win.Spread.ExcelSparklineGroup esg = fpSpread1.Sheets[0].GroupSparkline(new FarPoint.Win.Spread.Model.CellRange[] { new FarPoint.Win.Spread.Model.CellRange(0, 5, 3, 1) }, FarPoint.Win.Spread.SparklineType.Line);
    // グループにマーカーの外観を設定します
    esg.Setting = new FarPoint.Win.Spread.ExcelSparklineSetting() { ShowMarkers = true, MarkersColor = Color.Orange };
}
Visual Basic
コードのコピー 
Private Sub Form1_Load(sender As Object, e As EventArgs) Handles MyBase.Load
    FpSpread1.Sheets(0).Cells(0, 0).Value = 2
    FpSpread1.Sheets(0).Cells(0, 1).Value = 5
    FpSpread1.Sheets(0).Cells(0, 2).Value = 4
    FpSpread1.Sheets(0).Cells(0, 3).Value = -1
    FpSpread1.Sheets(0).Cells(0, 4).Value = 3
    FpSpread1.Sheets(0).Cells(1, 0).Value = 3
    FpSpread1.Sheets(0).Cells(1, 1).Value = 1
    FpSpread1.Sheets(0).Cells(1, 2).Value = 2
    FpSpread1.Sheets(0).Cells(1, 3).Value = -1
    FpSpread1.Sheets(0).Cells(1, 4).Value = 5
    FpSpread1.Sheets(0).Cells(2, 0).Value = 3
    FpSpread1.Sheets(0).Cells(2, 1).Value = 1
    FpSpread1.Sheets(0).Cells(2, 2).Value = 2
    FpSpread1.Sheets(0).Cells(2, 3).Value = -1
    FpSpread1.Sheets(0).Cells(2, 4).Value = 5
    ' 1つの目のスパークラインを作成します       
    Dim data1 = New FarPoint.Win.Spread.Chart.SheetCellRange(FpSpread1.Sheets(0), 0, 0, 1, 5)
    FpSpread1.Sheets(0).AddSparkline(data1, New FarPoint.Win.Spread.Model.CellRange(0, 5, 1, 1),
                                        FarPoint.Win.Spread.SparklineType.Line,
                                        New FarPoint.Win.Spread.ExcelSparklineSetting() With {
                                                                    .ShowMarkers = True,
                                                                    .MarkersColor = Color.Red
                                                                })
    ' 2つの目のスパークラインを作成します       
    Dim data2 = New FarPoint.Win.Spread.Chart.SheetCellRange(FpSpread1.Sheets(0), 1, 0, 1, 5)
    FpSpread1.Sheets(0).AddSparkline(data1, New FarPoint.Win.Spread.Model.CellRange(1, 5, 1, 1),
                                        FarPoint.Win.Spread.SparklineType.Line,
                                        New FarPoint.Win.Spread.ExcelSparklineSetting() With {
                                                                    .ShowMarkers = True,
                                                                    .MarkersColor = Color.Green
                                                                })
    ' 3つの目のスパークラインを作成します       
    Dim data3 = New FarPoint.Win.Spread.Chart.SheetCellRange(FpSpread1.Sheets(0), 2, 0, 1, 5)
    FpSpread1.Sheets(0).AddSparkline(data1, New FarPoint.Win.Spread.Model.CellRange(2, 5, 1, 1),
                                        FarPoint.Win.Spread.SparklineType.Line,
                                        New FarPoint.Win.Spread.ExcelSparklineSetting() With {
                                                                    .ShowMarkers = True,
                                                                    .MarkersColor = Color.Blue
                                                                })
End Sub
Private Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click
    ' スパークラインをグループ化します
    Dim esg As FarPoint.Win.Spread.ExcelSparklineGroup = FpSpread1.Sheets(0).GroupSparkline(
        New FarPoint.Win.Spread.Model.CellRange() {
        New FarPoint.Win.Spread.Model.CellRange(0, 5, 3, 1)},
        FarPoint.Win.Spread.SparklineType.Line)
    ' グループにマーカーの外観を設定します
    esg.Setting = New FarPoint.Win.Spread.ExcelSparklineSetting() With {
        .ShowMarkers = True,
        .MarkersColor = Color.Orange
    }
End Sub

SPREAD デザイナの使用

  1. スパークラインが表示されているセルを選択します。
  2. スパークラインをグループ化またはグループ解除するには、ツールバーのセクションから「グループ化」や「グループ解除」を選択します。
  3. スパークラインを削除するには、「クリア」を選択します。
  4. ［データの編集］オプションを使用してデータを編集するか、スパークラインに使用されるデータの範囲を変更します。
  5. [ファイル] メニューから［適用して終了］を選択し、変更を保存して SPREAD デザイナを終了します。
参照
メソッドを使用してスパークラインの追加
水平軸と垂直軸の指定
マーカーとポイント

 

 

© MESCIUS inc. All rights reserved.