ig.excel.RankConditionalFormat

セルの値が関連する範囲の上位または下位にあるかどうかに基づいて WorksheetCell のビジュアル属性を制御するプロパティを公開します。

備考

セル値が関連する範囲の上下 n 値によって定義される範囲にある場合、順位条件が true に評価します。n は RankConditionalFormat.rank を表します。

順位条件の一般的な例として「上位 10」があります。範囲の上位 10 つの高い値の範囲にあるセル値がこの条件に一致します。RankConditionalFormat.rank プロパティが任意の数値またはパーセンテージに設定できます。上位または下位 10 値に制限されません。

デフォルトで、セルの値が指定した順位以上にある場合、この条件は true に評価します。順位以下に変更するには、RankConditionalFormat.topBottom プロパティを 'Bottom' に設定します。

数値条件が RankConditionalFormat.isPercent プロパティを使用してパーセンテージに変更できます。 この場合、Rank プロパティはパーセンテージとして使用されます。

依存関係

jquery-1.4.4.js
infragistics.util.js
infragistics.ext_core.js
infragistics.ext_collections.js
infragistics.ext_collectionsExtended.js
infragistics.ext_io.js
infragistics.ext_text.js
infragistics.documents.core_core.js
infragistics.ext_ui.js
このコントロールにオプションはありません。
このコントロールにイベントはありません。

  • cellFormat
    継承

    .cellFormat( );
    返却型:
    ig.excel.IWorksheetCellFormat
    返却型の説明:
    IWorksheetCellFormat を返します。

    この条件と関連する条件に一致するセルの書式設定を表す IWorksheetCellFormat インターフェイス実装を返します。

    備考

    IWorksheetCellFormat 実装は値が関連する条件に一致するセルに適用されるビジュアル属性を定義します。

    関連項目

  • conditionType
    継承

    .conditionType( );
    返却型:
    ig.excel.FormatConditionType
    返却型の説明:
    FormatConditionType を返します。

    このインスタンスの条件のタイプを識別する FormatConditionType 値を返します。

    関連項目

  • isPercent

    .isPercent( );

    RankConditionalFormat.rank がパーセンテージ値を使用して決定されるかどうかを示すブール値を返します。

    備考

    この条件はデフォルトでセル値を RankConditionalFormat.rank プロパティの値に比較します。順位で明示的な数値を表します。ペインをパーセンテージとして識別するためにこのプロパティを True に設定します。

    IsPercent プロパティが true に設定去れる場合、このプロパティは 1 ~ 100 の値 (境界を含む) のみをサポートします。

  • isPercent

    .isPercent( value:boolean );

    RankConditionalFormat.rank がパーセンテージ値を使用して決定されるかどうかを示すブール値を返します。

    • value
    • タイプ:boolean

    備考

    この条件はデフォルトでセル値を RankConditionalFormat.rank プロパティの値に比較します。順位で明示的な数値を表します。ペインをパーセンテージとして識別するためにこのプロパティを True に設定します。

    IsPercent プロパティが true に設定去れる場合、このプロパティは 1 ~ 100 の値 (境界を含む) のみをサポートします。

  • priority
    継承

    .priority( );

    複数の条件付き書式ルールが存在する場合に評価の順序を決定する値を返します。

    備考

    デフォルトで、条件は、含まれているコレクション内に現れる順序で評価されます。

    このプロパティを使用すると、条件のコレクションでの順序位置をオーバーライドできます。

    より低い数値がより優先されます。たとえば、優先が 1 に設定される条件が 2 の優先の条件の前に評価されます。

    セル値が複数の条件に一致する場合、最初に評価された条件によって定義される書式は優先があります。

    1 つ以上の条件で優先を設定する場合、各条件に一意の値があることを確認するためにコレクションのその他の条件の値を変更する可能性があります。

  • priority
    継承

    .priority( value:number );

    複数の条件付き書式ルールが存在する場合に評価の順序を決定する値を返します。

    • value
    • タイプ:number

    備考

    デフォルトで、条件は、含まれているコレクション内に現れる順序で評価されます。

    このプロパティを使用すると、条件のコレクションでの順序位置をオーバーライドできます。

    より低い数値がより優先されます。たとえば、優先が 1 に設定される条件が 2 の優先の条件の前に評価されます。

    セル値が複数の条件に一致する場合、最初に評価された条件によって定義される書式は優先があります。

    1 つ以上の条件で優先を設定する場合、各条件に一意の値があることを確認するためにコレクションのその他の条件の値を変更する可能性があります。

  • rank

    .rank( );

    関連する条件の順位値の数値またはパーセンテージを指定する値を返します。

    備考

    このプロパティのデフォルト値は 10 で、RankConditionalFormat.topBottom プロパティのデフォルト値は 'Top' です。デフォルト以外のプロパティ値を指定しないでこのクラスのインスタンスを作成すると、「上位 10」の条件になります。

    このプロパティの値が RankConditionalFormat.isPercent プロパティの値に基づいて数値またはパーセンテージとして使用されます。

    IsPercent プロパティが true に設定去れる場合、このプロパティは 1 ~ 100 の値 (境界を含む) のみをサポートします。

    関連項目

  • rank

    .rank( value:number );

    関連する条件の順位値の数値またはパーセンテージを指定する値を返します。

    • value
    • タイプ:number

    備考

    このプロパティのデフォルト値は 10 で、RankConditionalFormat.topBottom プロパティのデフォルト値は 'Top' です。デフォルト以外のプロパティ値を指定しないでこのクラスのインスタンスを作成すると、「上位 10」の条件になります。

    このプロパティの値が RankConditionalFormat.isPercent プロパティの値に基づいて数値またはパーセンテージとして使用されます。

    IsPercent プロパティが true に設定去れる場合、このプロパティは 1 ~ 100 の値 (境界を含む) のみをサポートします。

    関連項目

  • regions
    継承

    .regions( );

    この条件が関連するセル範囲を識別する WorksheetRegion を返します。

  • setFirstPriority
    継承

    .setFirstPriority( );

    このルールが最初の評価される条件になるために ConditionBase.priority 値を設定します。関連するコレクションに複数の要素が含まれる場合のみに適用できます。

    備考

    複数の条件が同じコレクションに存在する場合、評価の順序はこの条件に一致するセルに適用される書式に影響します。

    このメソッドは、関連する条件を最初に評価される条件に設定します。

    条件を最後に評価される条件に設定するには、ConditionBase.setLastPriority メソッドを使用します。

    関連項目

  • setLastPriority
    継承

    .setLastPriority( );

    このルールが最後の評価される条件になるために ConditionBase.priority 値を設定します。関連する ConditionalFormatCollection に複数の要素が含まれる場合のみに適用できます。

    備考

    ConditionBase.setFirstPriority メソッドは関連する条件を最初に評価されることを設定する通り、SetLastPriority メソッドは関連する条件を最後に評価されることを設定します。

    このメソッドを複数の条件で呼び出す場合、以前設定した最後に評価される条件と置き換えます。

    関連項目

  • setRegions
    継承

    .setRegions( regionAddress:string, cellReferenceMode:ig.excel.CellReferenceMode );

    既存の領域を新しい領域と置き換えます。

    • regionAddress
    • タイプ:string
    • コンマに分割される領域アドレスを 1 つ以上含む文字列。
    • cellReferenceMode
    • タイプ:ig.excel.CellReferenceMode
    • オプションのセル参照モード。

    例外

    例外 説明
    ig.ArgumentException regionAddress が無効か、その他のワークシートからの領域を含む場合。

  • stopIfTrue
    継承

    .stopIfTrue( );

    このルールが true に評価する場合、追加の書式ルールが評価されるかどうかを示すブール値を返します。含まれるコレクションが複数の要素を含む場合のみに適用されます。

    備考

    セル値が複数の条件に一致する場合、最初の条件によって定義される書式は優先があります。書式プロパティは解決処理で結合されます。たとえば、1 つの書式設定に赤い境界線があり、その他の書式設定に赤い前景色がある場合、その 2 つの条件に一致するセル値の書式設定は赤い境界線および赤い前景色になります。

    このプロパティを使用すると、解決処理をオーバーライドできます。つまり、最初の条件が true に評価した後、その他の条件付き書式が適用されないために設定できます。

    上記の例で、StopIfTrue が赤い境界線の条件付き書式で true の値に設定され、赤い前景色のその他の条件付き書式があり、セル値がその両方の条件に一致する場合があります。StopIfTrue 設定が追加の書式の評価を許可しないため、セルが赤い前景色を表示しません。ただし、StopIfTrue が false に設定される場合、赤い境界線および赤い前景色を表示します。

    次の条件の評価を許可しない機能に追加して、ConditionBase.priority プロパティを使用して条件の評価順序を制御できます。

  • stopIfTrue
    継承

    .stopIfTrue( value:boolean );

    このルールが true に評価する場合、追加の書式ルールが評価されるかどうかを示すブール値を返します。含まれるコレクションが複数の要素を含む場合のみに適用されます。

    • value
    • タイプ:boolean

    備考

    セル値が複数の条件に一致する場合、最初の条件によって定義される書式は優先があります。書式プロパティは解決処理で結合されます。たとえば、1 つの書式設定に赤い境界線があり、その他の書式設定に赤い前景色がある場合、その 2 つの条件に一致するセル値の書式設定は赤い境界線および赤い前景色になります。

    このプロパティを使用すると、解決処理をオーバーライドできます。つまり、最初の条件が true に評価した後、その他の条件付き書式が適用されないために設定できます。

    上記の例で、StopIfTrue が赤い境界線の条件付き書式で true の値に設定され、赤い前景色のその他の条件付き書式があり、セル値がその両方の条件に一致する場合があります。StopIfTrue 設定が追加の書式の評価を許可しないため、セルが赤い前景色を表示しません。ただし、StopIfTrue が false に設定される場合、赤い境界線および赤い前景色を表示します。

    次の条件の評価を許可しない機能に追加して、ConditionBase.priority プロパティを使用して条件の評価順序を制御できます。

  • topBottom

    .topBottom( );
    返却型:
    ig.excel.FormatConditionTopBottom
    返却型の説明:
    FormatConditionTopBottom を返します。

    セル値が関連する範囲の順位の上または下にある必要かどうかを示す値を返します。

    関連項目

  • topBottom

    .topBottom( value:ig.excel.FormatConditionTopBottom );
    返却型:
    ig.excel.FormatConditionTopBottom
    返却型の説明:
    FormatConditionTopBottom を返します。

    セル値が関連する範囲の順位の上または下にある必要かどうかを示す値を返します。

    • value
    • タイプ:ig.excel.FormatConditionTopBottom

    関連項目

  • workbook
    継承

    .workbook( );
    返却型:
    ig.excel.Workbook
    返却型の説明:
    Workbook を返します。

    関連付けられたワークブックへの参照を返します。

    関連項目

  • worksheet
    継承

    .worksheet( );
    返却型:
    ig.excel.Worksheet
    返却型の説明:
    Worksheet を返します。

    関連付けられたワークシートへの参照を返します。

    関連項目

Copyright © 1996 - 2024 Infragistics, Inc. All rights reserved.