カラースケールルール

カラースケールは、データの分布および変動状態を分かりやすくするための視覚的なガイドです。 2色のスケールは、2色のグラデーションを使用して、セル範囲のデータを比較します。色の濃さにより、値の高低を表します。たとえば、緑と赤のカラースケールの場合、高い値ほど緑に近く、低い値ほど赤に近い色でセルが描画されるように指定できます。各プロパティにより、値の型、値、最小値の色、および最大値の色を指定できます。

3色スケールは、3色のグラデーションを使用して、セル範囲のデータを比較します。色の濃さにより、値の高中低を表します。たとえば、緑、黄、および赤のカラースケールの場合、高い値ほど緑に近く、中間値は黄で、低い値ほど赤に近い色でセルが描画されるように指定できます。各プロパティにより、値の型、値、最小値の色、中間値の色、および最大値の色を指定できます。

次の図は、3色スケールルールを使用します。

設定方法

カラースケールのルールを定義するには、以下のクラスを使用します。

これらのルールを、次のいずれかの方法で条件付き書式として追加します。

SheetView クラスのConditionalFormatting プロパティを使用
SheetView クラスのSetConditionalFormatting メソッドを使用

サンプルコード

次のサンプルコードは、3色スケールルールを作成し、SetConditionalFormatting メソッドを使用して、このルールを適用します。

C#
Visual Basic

protected void Page_Load(object sender, System.EventArgs e)
{
    FpSpread1.Sheets[0].Cells[0, 0].Value = 3;
    FpSpread1.Sheets[0].Cells[1, 0].Value = 2;
    FpSpread1.Sheets[0].Cells[1, 1].Value = 10;
    FpSpread1.Sheets[0].Cells[0, 2].Value = 1;
}
 
protected void Button1_Click(object sender, EventArgs e)
{
    FarPoint.Web.Spread.Model.CellRange celRange1 = new FarPoint.Web.Spread.Model.CellRange(0, 0, 3, 3);
    FarPoint.Web.Spread.ThreeColorScaleConditionalFormattingRule rule = new FarPoint.Web.Spread.ThreeColorScaleConditionalFormattingRule(Color.Aqua, Color.Bisque, Color.BlueViolet);
    FpSpread1.Sheets[0].SetConditionalFormatting(new FarPoint.Web.Spread.Model.CellRange[] { celRange1 }, rule);
}

Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
    FpSpread1.Sheets(0).Cells(0, 0).Value = 3
    FpSpread1.Sheets(0).Cells(1, 0).Value = 2
    FpSpread1.Sheets(0).Cells(1, 1).Value = 10
    FpSpread1.Sheets(0).Cells(0, 2).Value = 1
End Sub
 
Protected Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click
    Dim celRange1 As New FarPoint.Web.Spread.Model.CellRange(0, 0, 3, 3)
    Dim rule As New FarPoint.Web.Spread.ThreeColorScaleConditionalFormattingRule(Drawing.Color.Aqua, Drawing.Color.Bisque, Drawing.Color.BlueViolet)
    FpSpread1.Sheets(0).SetConditionalFormatting(New FarPoint.Web.Spread.Model.CellRange() {celRange1}, rule)
End Sub