ig.excel.ConditionValue
備考
ConditionValue.valueType プロパティが Number、Percentage、または Percentile に設定される場合、ConditionValue.value プロパティのみは適用可能です。
同様に、ValueType が Formula に設定した場合に ConditionValue.formula プロパティのみ適用できます。
ValueType の以下の設定の場合、Value および Formula は適用できません。実際のしきい値は関連する範囲の最高値または最低値に基づいて決定されます。
- AutomaticMinimum
- AutomaticMaximum
- LowestValue
- HighestValue
依存関係
-
formula
- .formula( );
- 返却型:
- ig.excel.Formula
- 返却型の説明:
- Formula を返します。
セル値が関連する条件に合うかどうかを設定する数式を返します。
備考
このプロパティは、ConditionValue.valueType プロパティが Formula に設定されている場合にだけ適用可能です。
数式を割り当てるには、ConditionValue.setFormula メソッドを使用します。
-
setFormula
- .setFormula( formula:string, [cellReferenceMode:ig.excel.CellReferenceMode], [valueType:ig.excel.FormatConditionValueType] );
指定した数式を ConditionValue.formula プロパティに割り当て、Formula 値を ConditionValue.valueType プロパティに割り当てます。
- formula
- タイプ:string
- ConditionValue.value プロパティに割り当てる ConditionValue.formula の文字列表現。
- cellReferenceMode
- タイプ:ig.excel.CellReferenceMode
- オプション
- formula パラメーターが A1 または R1C1 式として解析するかどうかを指定する CellReferenceMode 値。このプロパティはオプションで、デフォルト値は null です。この場合、Workbook.cellReferenceMode プロパティが使用されます。
- valueType
- タイプ:ig.excel.FormatConditionValueType
- オプション
- 数式から返された値が使用される方法を指定する FormatConditionValueType 値。このパラメーターはオプションであり、デフォルト値は 'Formula' です。
-
setValue
- .setValue( valueType:ig.excel.FormatConditionValueType );
ConditionValue.valueType プロパティを指定した FormatConditionValueType 値に設定します。
- valueType
- タイプ:ig.excel.FormatConditionValueType
- ConditionValue.valueType プロパティの新しい値。
備考
valueType パラメーターを以下の値の 1 つに設定する必要があります。それ以外の場合、例外は発生されます。
- AutomaticLowest
- AutomaticHighest
- LowestValue
- HighestValue
ConditionValue.value プロパティを数値に設定するには、ConditionValue.setValue メソッドを使用します。
ConditionValue.valueType プロパティを Formula に設定するには、ConditionValue.setFormula メソッドを使用します。
-
setValue
- .setValue( value:number, valueType:ig.excel.FormatConditionValueType );
ConditionValue.valueType プロパティを指定した FormatConditionValueType 値に設定します。
- value
- タイプ:number
- ConditionValue.value プロパティの新しい値。
- valueType
- タイプ:ig.excel.FormatConditionValueType
- ConditionValue.valueType プロパティの新しい値。
例外
例外 説明 ig.ArgumentException 値型または値が条件に適切ではないかどうか。 ig.ArgumentOutOfRangeException 値が範囲以外かどうか。 備考
valueType パラメーターを以下の値の 1 つに設定する必要があります。それ以外の場合、例外は発生されます。
- AutomaticLowest
- AutomaticHighest
- LowestValue
- HighestValue
ConditionValue.value プロパティを数値に設定するには、ConditionValue.setValue メソッドを使用します。
ConditionValue.valueType プロパティを Formula に設定するには、ConditionValue.setFormula メソッドを使用します。
-
toString
- .toString( );
このインスタンスの文字列表現を返します。
-
value
- .value( );
このインスタンスの数値を返します。
備考
このプロパティは読み取り専用です。値タイプを割り当てるには、ConditionValue.setValue または ConditionValue.setValue メソッドを使用します。
注: この値の単位は ConditionValue.valueType プロパティによって決定されます。たとえば、ValueType が Number に設定される場合、値は数値として使用されますが、Percentage に設定される場合、パーセンテージとして使用されます。
-
valueType
- .valueType( );
- 返却型:
- ig.excel.FormatConditionValueType
- 返却型の説明:
- FormatConditionValueType を返します。
このインスタンスのしきい値が決定される方法を指定する FormatConditionValueType 値を返します。
備考
このプロパティは読み取り専用です。以下の値タイプを割り当てるには、ConditionValue.setValue メソッドを使用します。
- AutomaticLowest
- AutomaticHighest
- LowestValue
- HighestValue
Number、Percentage、または Percentile の値タイプを割り当てるには、ConditionValue.setValue メソッドを使用します。
ConditionValue.formula を割り当てるには、ConditionValue.setFormula メソッドを使用します。