PowerTools SPREAD for Windows Forms 10.0J > 開発者ガイド > スタイル > セルの条件付き書式 > ルールによる条件付き書式 > カラースケールルール |
カラースケールは、データの分布および変動状態を分かりやすくするための視覚的なガイドです。2色のスケールは、2色のグラデーションを使用して、セル範囲のデータを比較します。色の濃さにより、値の高低を表します。たとえば、緑と赤のカラースケールの場合、高い値ほど緑に近く、低い値ほど赤に近い色でセルが描画されるように指定できます。各プロパティにより、値の型、値、最小値の色、および最大値の色を指定できます。
3色スケールは、3色のグラデーションを使用して、セル範囲のデータを比較します。色の濃さにより、値の高中低を表します。たとえば、緑、黄、および赤のカラースケールの場合、高い値ほど緑に近く、中間値は黄で、低い値ほど赤に近い色でセルが描画されるように指定できます。各プロパティにより、値の型、値、最小値の色、中間値の色、および最大値の色を指定できます。
次の図は、3色スケールルールを使用します。
2色スケールを使用するにはTwoColorScaleConditionalFormattingRuleクラスを、3色スケールを使用するにはThreeColorScaleConditionalFormattingRuleクラスを使用します。
次のサンプルコードは、3色スケールルールを作成し、SheetViewクラスのSetConditionalFormattingメソッドを使用して、このルールを適用します。
C# |
コードのコピー
|
---|---|
private void Form1_Load(object sender, 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; } private void button1_Click(object sender, EventArgs e) { FarPoint.Win.Spread.Model.CellRange celRange1 = new FarPoint.Win.Spread.Model.CellRange(0, 0, 3, 3); FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule rule = new FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule(Color.Aqua, Color.Bisque, Color.BlueViolet); fpSpread1.Sheets[0].SetConditionalFormatting(new FarPoint.Win.Spread.Model.CellRange[] { celRange1 }, rule); } |
Visual Basic |
コードのコピー
|
---|---|
Private Sub Form1_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 Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click Dim celRange1 As New FarPoint.Win.Spread.Model.CellRange(0, 0, 3, 3) Dim rule As New FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule(Color.Aqua, Color.Bisque, Color.BlueViolet) FpSpread1.Sheets(0).SetConditionalFormatting(New FarPoint.Win.Spread.Model.CellRange() {celRange1}, rule) End Sub |