ルールによる条件付き書式

ルールを使用して、セルの外観表示を設定できます。ルールによって条件付き書式を作成するには、以下のクラスを使用します。

クラス	ルール
AverageConditionalFormattingRule	平均値を上回る値、または下回る値をチェックします。
BetweenValuesConditionalFormattingRule	セル値が特定の範囲に含まれるかどうかをチェックします。
BlankConditionalFormattingRule	空白値、または非空白値をチェックします。
DatabarConditionalFormattingRule	範囲内のセル値に基づき、セル内にデータバーを表示します。
FormulaConditionalFormattingRule	条件のチェックに数式を使用します。
ErrorConditionalFormattingRule	エラー値、または非エラー値をチェックします。
IconSetConditionalFormattingRule	範囲内のセル値に基づき、アイコンを表示します。
TextConditionalFormattingRule	特定のテキストを検索します。
TwoColorScaleConditionalFormattingRule ThreeColorScaleConditionalFormattingRule	スライディングスケールを使用して色を設定します。たとえば、1が黄で50を緑と設定しておくと、25は黄緑色になります。
TimePeriodConditionalFormattingRule	セル値が特定の期間に該当するかどうかをチェックします。
TopRankedValuesConditionalFormattingRule	範囲内の上位または下位の値をチェックします。
UnaryComparisonConditionalFormattingRule	セル値を、単一の値と比較します。
UniqueOrDuplicatedConditionalFormattingRule	セル値が、範囲内で一意のものかどうか、または重複値かどうかをチェックします。

注意 : 各ルールの優先順位（Priority）について
各ルールの優先順位（Priority）は自動的にConditionalFormattingクラスに条件を追加するタイミングで、追加した順番に設定されます。条件付き書式に追加する前に各ルールのPriorityプロパティを設定しても有効にはなりません。下記コードの場合、先に追加された「between2」が優先度1で追加され、2番目に追加された「between」が優先度2に設定されます。 FarPoint.Win.Spread.BetweenValuesConditionalFormattingRule between = new FarPoint.Win.Spread.BetweenValuesConditionalFormattingRule(false, 1, false, 20, false); between.BackColor = Color.Bisque; between.Priority = 1; //この設定は有効になりません FarPoint.Win.Spread.BetweenValuesConditionalFormattingRule between2 = new FarPoint.Win.Spread.BetweenValuesConditionalFormattingRule(false, 1, false, 20, false); between2.BackColor = Color.Red; between2.Priority = 2; //この設定は有効になりません ConditionalFormatting cf1 = new ConditionalFormatting(new CellRange(0, 0, 4, 2)); cf1.Add(between2); //最初に追加 cf1.Add(between); //2番目に追加 fpSpread1.ActiveSheet.Models.ConditionalFormatting.Add(cf1); 下記のように条件付き書式が追加されるタイミング(ConditionalFormatting.Changedイベント)で設定・変更することは可能です。 fpSpread1.ActiveSheet.Models.ConditionalFormatting.Changed += new EventHandler<ConditionalFormattingModelEventArgs> (CFChange); private void CFChange(object sender, ConditionalFormattingModelEventArgs e) { between.Priority = 1; //この設定は有効です between2.Priority = 2; //この設定は有効です }

注意 : 各ルールの優先順位（Priority）について

各ルールの優先順位（Priority）は自動的にConditionalFormattingクラスに条件を追加するタイミングで、追加した順番に設定されます。条件付き書式に追加する前に各ルールのPriorityプロパティを設定しても有効にはなりません。
下記コードの場合、先に追加された「between2」が優先度1で追加され、2番目に追加された「between」が優先度2に設定されます。

      FarPoint.Win.Spread.BetweenValuesConditionalFormattingRule between = new FarPoint.Win.Spread.BetweenValuesConditionalFormattingRule(false, 1, false, 20, false);
      between.BackColor = Color.Bisque;
      between.Priority = 1; //この設定は有効になりません

      FarPoint.Win.Spread.BetweenValuesConditionalFormattingRule between2 = new FarPoint.Win.Spread.BetweenValuesConditionalFormattingRule(false, 1, false, 20, false);
      between2.BackColor = Color.Red;
      between2.Priority = 2; //この設定は有効になりません
      ConditionalFormatting cf1 = new ConditionalFormatting(new CellRange(0, 0, 4, 2));
      cf1.Add(between2); //最初に追加
      cf1.Add(between);   //2番目に追加

fpSpread1.ActiveSheet.Models.ConditionalFormatting.Add(cf1);

下記のように条件付き書式が追加されるタイミング(ConditionalFormatting.Changedイベント)で設定・変更することは可能です。

      fpSpread1.ActiveSheet.Models.ConditionalFormatting.Changed += new EventHandler<ConditionalFormattingModelEventArgs> (CFChange);
      private void CFChange(object sender, ConditionalFormattingModelEventArgs e)
      {
           between.Priority = 1;   //この設定は有効です
           between2.Priority = 2; //この設定は有効です
      }

それぞれの条件付き書式ルールの詳細については、以下の各トピックを参照してください。