Spread Windows Forms 13.0 Product Documentation
FarPoint.Win.Spread Assembly / FarPoint.Win.Spread Namespace / SheetView Class / SetConditionalFormatting Method / SetConditionalFormatting(CellRange[],IConditionalFormattingRule[]) Method
Cell ranges
Rules to apply for the specified range of cells
Example


In This Topic
    SetConditionalFormatting(CellRange[],IConditionalFormattingRule[]) Method
    In This Topic
    Sets conditional formatting for a specified ranges of cells on the sheet based on specified rules.
    Syntax
    'Declaration
     
    Public Overloads Sub SetConditionalFormatting( _
       ByVal cellRanges() As CellRange, _
       ByVal ParamArray rules() As IConditionalFormattingRule _
    ) 
    'Usage
     
    Dim instance As SheetView
    Dim cellRanges() As CellRange
    Dim rules() As IConditionalFormattingRule
     
    instance.SetConditionalFormatting(cellRanges, rules)
    public void SetConditionalFormatting( 
       CellRange[] cellRanges,
       params IConditionalFormattingRule[] rules
    )

    Parameters

    cellRanges
    Cell ranges
    rules
    Rules to apply for the specified range of cells
    Example
    This example creates a conditional rule.
    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.UnaryComparisonConditionalFormattingRule unary = new FarPoint.Win.Spread.UnaryComparisonConditionalFormattingRule(FarPoint.Win.Spread.UnaryComparisonOperator.EqualTo, 10, false);
                unary.Operator = FarPoint.Win.Spread.UnaryComparisonOperator.EqualTo;
                unary.Value = 10;
                unary.BackColor = Color.Red;
                unary.FontStyle = new FarPoint.Win.Spread.SpreadFontStyle(RegularBoldItalicFontStyle.Bold);            
         
                FarPoint.Win.Spread.BetweenValuesConditionalFormattingRule between = new FarPoint.Win.Spread.BetweenValuesConditionalFormattingRule(true, 10, false, 20, false);
                between.FirstValue = 1;
                between.SecondValue = 20;
                between.IsNotBetween = true;
                between.BackColor = Color.Bisque;
                            
                //SetConditionalFormatting Overload
                fpSpread1.ActiveSheet.SetConditionalFormatting(0, 0, 3, 3, false, unary, between);
                //fpSpread1.ActiveSheet.SetConditionalFormatting(new FarPoint.Win.Spread.Model.CellRange[] { new FarPoint.Win.Spread.Model.CellRange(1, 1, 2, 3), new FarPoint.Win.Spread.Model.CellRange(1, 2, 2, 1) }, unary, between);
                //fpSpread1.ActiveSheet.SetConditionalFormatting(new FarPoint.Win.Spread.Model.CellRange[] { new FarPoint.Win.Spread.Model.CellRange(1, 1, 2, 3), new FarPoint.Win.Spread.Model.CellRange(1, 2, 2, 1) }, false, unary);
                //fpSpread1.ActiveSheet.SetConditionalFormatting(1, 1, unary);
                //fpSpread1.ActiveSheet.SetConditionalFormatting(1, 1, false, unary);
                //fpSpread1.ActiveSheet.SetConditionalFormatting(0, 0, 3, 3, unary, between);
                //fpSpread1.ActiveSheet.SetConditionalFormatting(0, 0, 3, 3, false, unary);
            }
    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 unary As New FarPoint.Win.Spread.UnaryComparisonConditionalFormattingRule(FarPoint.Win.Spread.UnaryComparisonOperator.EqualTo, 10, False)
            unary.Operator = FarPoint.Win.Spread.UnaryComparisonOperator.EqualTo
            unary.Value = 10
            unary.BackColor = Color.Red
            unary.FontStyle = New FarPoint.Win.Spread.SpreadFontStyle(RegularBoldItalicFontStyle.Bold)
    
            Dim between As New FarPoint.Win.Spread.BetweenValuesConditionalFormattingRule(True, 10, False, 20, False)
            between.FirstValue = 1
            between.SecondValue = 20
            between.IsNotBetween = True
            between.BackColor = Color.Bisque
    
            'SetConditionalFormatting Overload
            FpSpread1.ActiveSheet.SetConditionalFormatting(0, 0, 3, 3, False, unary, between)
            'FpSpread1.ActiveSheet.SetConditionalFormatting(New FarPoint.Win.Spread.Model.CellRange() {New FarPoint.Win.Spread.Model.CellRange(1, 1, 2, 3), New FarPoint.Win.Spread.Model.CellRange(1, 2, 2, 1)}, unary, between)
            'FpSpread1.ActiveSheet.SetConditionalFormatting(New FarPoint.Win.Spread.Model.CellRange() {New FarPoint.Win.Spread.Model.CellRange(1, 1, 2, 3), New FarPoint.Win.Spread.Model.CellRange(1, 2, 2, 1)}, False, unary)
            'FpSpread1.ActiveSheet.SetConditionalFormatting(1, 1, unary)
            'FpSpread1.ActiveSheet.SetConditionalFormatting(1, 1, False, unary)
            'FpSpread1.ActiveSheet.SetConditionalFormatting(0, 0, 3, 3, unary, between)
            'FpSpread1.ActiveSheet.SetConditionalFormatting(0, 0, 3, 3, False, unary)
        End Sub
    See Also