ig.excel.ColorScaleConditionalFormat
備考
このクラスは、コンストラクターの colorScaleType パラメーターの値に基づいて決定される 2 色または 3 色スケールをサポートします。
2 色スケールの場合、関連する範囲のセルは、値が最小値および最大値のしきい値に相対する方法に基づいて色が設定されます。
3 色スケールの場合、関連する範囲のセルは、値が最小値、中値、および最大値のしきい値に相対する方法に基づいて色が設定されます。
このクラスは一意の色しきい値を最大 3 つサポートします。
単一のしきい値の指定はサポートされていません。予期されていない動作となる場合があります。
このインスタンスが 2 色スケールとして作成される場合、ColorScaleConditionalFormat.midpointThreshold プロパティは適用できません。この場合、MidpointThreshold プロパティから返されたオブジェクトにプロパティを設定することは例外が発生する原因となります。
依存関係
-
colorScaleType
- .colorScaleType( );
このインスタンスを 2 色または 3 色スケールとして識別する ColorScaleType 値を返します。
備考
'TwoColor' 値と作成された ColorScaleConditionalFormat インスタンスは ColorScaleConditionalFormat.midpointThreshold をサポートしません。 MidpointThreshold プロパティから返されたオブジェクトにプロパティの設定は例外が発生する原因となります。
-
maximumThreshold
- .maximumThreshold( );
このインスタンスの最大しきい値のプロパティを定義する ColorScaleCriterion オブジェクトを返します。
-
midpointThreshold
- .midpointThreshold( );
このインスタンスの中値しきい値のプロパティを定義する ColorScaleCriterion オブジェクトを返します。
備考
中値しきい値は、colorScaleType パラメーターに指定された 'ThreeColor' 値を持つ ColorScaleConditionalFormat インスタンスのみにサポートされます。
このプロパティから返されたインスタンスにプロパティを設定すると、このインスタンスが 2 色スケールとして作成した場合に例外が発生する原因になります。
以下の値型は中値しきい値で無効です。例外を発生する原因になります。
- LowestValue
- HighestValue
- AutomaticMinimum
- AutomaticMaximum
-
minimumThreshold
- .minimumThreshold( );
このインスタンスの最小しきい値のプロパティを定義する ColorScaleCriterion オブジェクトを返します。
備考
最小しきい値は、関連する範囲の間の最小値の条件を定義します。
2 色スケールの場合、ColorScaleConditionalFormat.maximumThreshold は次の「位置」を定義します。3 色スケールの場合、ColorScaleConditionalFormat.midpointThreshold プロパティは次の位置を定義します。
以下の値型は最小しきい値で無効です。例外を発生する原因になります。
- HighestValue
- AutomaticMinimum
- AutomaticMaximum