次の方法で共有


Excel.Interfaces.ConditionalFormatLoadOptions interface

条件付き書式の範囲、書式、規則、およびその他のプロパティをカプセル化するオブジェクト。 条件付き書式オブジェクト モデルの詳細については、「 Excel 範囲に条件付き書式を適用する」を参照してください。

注釈

[ API セット: ExcelApi 1.6 ]

プロパティ

$all

読み込みオプションに $all を指定すると、すべてのスカラー プロパティ ( Range.addressなど) が読み込まれますが、ナビゲーション プロパティ ( Range.format.fill.color など) は読み込まれません。

cellValue

現在の条件付き書式が CellValue 型の場合は、セル値の条件付き書式プロパティを返します。

cellValueOrNullObject

現在の条件付き書式が CellValue 型の場合は、セル値の条件付き書式プロパティを返します。

colorScale

現在の条件付き書式が ColorScale 型の場合は、カラー スケールの条件付き書式プロパティを返します。

colorScaleOrNullObject

現在の条件付き書式が ColorScale 型の場合は、カラー スケールの条件付き書式プロパティを返します。

custom

現在の条件付き書式がカスタム型の場合は、カスタム条件付き書式プロパティを返します。

customOrNullObject

現在の条件付き書式がカスタム型の場合は、カスタム条件付き書式プロパティを返します。

dataBar

現在の条件付き書式がデータ バーの場合は、データ バーのプロパティを返します。

dataBarOrNullObject

現在の条件付き書式がデータ バーの場合は、データ バーのプロパティを返します。

iconSet

現在の条件付き書式が IconSet 型の場合は、アイコン セットの条件付き書式プロパティを返します。

iconSetOrNullObject

現在の条件付き書式が IconSet 型の場合は、アイコン セットの条件付き書式プロパティを返します。

id

現在の ConditionalFormatCollectionの条件付き書式の優先順位。

preset

事前設定された条件の条件付き形式を返します。 詳細については、Excel.PresetCriteriaConditionalFormatを参照してください。

presetOrNullObject

事前設定された条件の条件付き形式を返します。 詳細については、Excel.PresetCriteriaConditionalFormatを参照してください。

priority

この条件付き書式が現在存在する条件付き書式コレクション内の優先順位 (またはインデックス)。 これを変更すると、他の条件付き形式の優先順位も変更され、連続した優先順位が可能になります。 バックから始める場合は、負の優先順位を使用します。 境界を超える優先順位は、最大 (負の場合は最小) の優先順位を取得して設定します。 また、優先度を変更する場合は、さらに変更を加える場合は、その新しい優先度の場所にあるオブジェクトの新しいコピーを再フェッチする必要があることに注意してください。

stopIfTrue

この条件付き書式の条件が満たされた場合、優先順位の低い書式はそのセルに影響を及ぼしません。 値は、データ バー、アイコン セット、カラー スケールに null されます。これは、 StopIfTrue の概念がないためです。

textComparison

現在の条件付き書式がテキスト型の場合は、特定のテキスト条件付き書式プロパティを返します。 たとえば、"Text" という単語に一致するセルの書式を設定します。

textComparisonOrNullObject

現在の条件付き書式がテキスト型の場合は、特定のテキスト条件付き書式プロパティを返します。 たとえば、"Text" という単語に一致するセルの書式を設定します。

topBottom

現在の条件付き書式が TopBottom 型の場合は、上下の条件付き書式プロパティを返します。 たとえば、上位 10% または下位 10 個の項目を書式設定します。

topBottomOrNullObject

現在の条件付き書式が TopBottom 型の場合は、上下の条件付き書式プロパティを返します。 たとえば、上位 10% または下位 10 個の項目を書式設定します。

type

条件付き書式の種類。 一度に設定できるのは 1 つだけです。

プロパティの詳細

$all

読み込みオプションに $all を指定すると、すべてのスカラー プロパティ ( Range.addressなど) が読み込まれますが、ナビゲーション プロパティ ( Range.format.fill.color など) は読み込まれません。

$all?: boolean;

プロパティ値

boolean

cellValue

現在の条件付き書式が CellValue 型の場合は、セル値の条件付き書式プロパティを返します。

cellValue?: Excel.Interfaces.CellValueConditionalFormatLoadOptions;

プロパティ値

注釈

[ API セット: ExcelApi 1.6 ]

cellValueOrNullObject

現在の条件付き書式が CellValue 型の場合は、セル値の条件付き書式プロパティを返します。

cellValueOrNullObject?: Excel.Interfaces.CellValueConditionalFormatLoadOptions;

プロパティ値

注釈

[ API セット: ExcelApi 1.6 ]

colorScale

現在の条件付き書式が ColorScale 型の場合は、カラー スケールの条件付き書式プロパティを返します。

colorScale?: Excel.Interfaces.ColorScaleConditionalFormatLoadOptions;

プロパティ値

注釈

[ API セット: ExcelApi 1.6 ]

colorScaleOrNullObject

現在の条件付き書式が ColorScale 型の場合は、カラー スケールの条件付き書式プロパティを返します。

colorScaleOrNullObject?: Excel.Interfaces.ColorScaleConditionalFormatLoadOptions;

プロパティ値

注釈

[ API セット: ExcelApi 1.6 ]

custom

現在の条件付き書式がカスタム型の場合は、カスタム条件付き書式プロパティを返します。

custom?: Excel.Interfaces.CustomConditionalFormatLoadOptions;

プロパティ値

注釈

[ API セット: ExcelApi 1.6 ]

customOrNullObject

現在の条件付き書式がカスタム型の場合は、カスタム条件付き書式プロパティを返します。

customOrNullObject?: Excel.Interfaces.CustomConditionalFormatLoadOptions;

プロパティ値

注釈

[ API セット: ExcelApi 1.6 ]

dataBar

現在の条件付き書式がデータ バーの場合は、データ バーのプロパティを返します。

dataBar?: Excel.Interfaces.DataBarConditionalFormatLoadOptions;

プロパティ値

注釈

[ API セット: ExcelApi 1.6 ]

dataBarOrNullObject

現在の条件付き書式がデータ バーの場合は、データ バーのプロパティを返します。

dataBarOrNullObject?: Excel.Interfaces.DataBarConditionalFormatLoadOptions;

プロパティ値

注釈

[ API セット: ExcelApi 1.6 ]

iconSet

現在の条件付き書式が IconSet 型の場合は、アイコン セットの条件付き書式プロパティを返します。

iconSet?: Excel.Interfaces.IconSetConditionalFormatLoadOptions;

プロパティ値

注釈

[ API セット: ExcelApi 1.6 ]

iconSetOrNullObject

現在の条件付き書式が IconSet 型の場合は、アイコン セットの条件付き書式プロパティを返します。

iconSetOrNullObject?: Excel.Interfaces.IconSetConditionalFormatLoadOptions;

プロパティ値

注釈

[ API セット: ExcelApi 1.6 ]

id

現在の ConditionalFormatCollectionの条件付き書式の優先順位。

id?: boolean;

プロパティ値

boolean

注釈

[ API セット: ExcelApi 1.6 ]

preset

事前設定された条件の条件付き形式を返します。 詳細については、Excel.PresetCriteriaConditionalFormatを参照してください。

preset?: Excel.Interfaces.PresetCriteriaConditionalFormatLoadOptions;

プロパティ値

注釈

[ API セット: ExcelApi 1.6 ]

presetOrNullObject

事前設定された条件の条件付き形式を返します。 詳細については、Excel.PresetCriteriaConditionalFormatを参照してください。

presetOrNullObject?: Excel.Interfaces.PresetCriteriaConditionalFormatLoadOptions;

プロパティ値

注釈

[ API セット: ExcelApi 1.6 ]

priority

この条件付き書式が現在存在する条件付き書式コレクション内の優先順位 (またはインデックス)。 これを変更すると、他の条件付き形式の優先順位も変更され、連続した優先順位が可能になります。 バックから始める場合は、負の優先順位を使用します。 境界を超える優先順位は、最大 (負の場合は最小) の優先順位を取得して設定します。 また、優先度を変更する場合は、さらに変更を加える場合は、その新しい優先度の場所にあるオブジェクトの新しいコピーを再フェッチする必要があることに注意してください。

priority?: boolean;

プロパティ値

boolean

注釈

[ API セット: ExcelApi 1.6 ]

stopIfTrue

この条件付き書式の条件が満たされた場合、優先順位の低い書式はそのセルに影響を及ぼしません。 値は、データ バー、アイコン セット、カラー スケールに null されます。これは、 StopIfTrue の概念がないためです。

stopIfTrue?: boolean;

プロパティ値

boolean

注釈

[ API セット: ExcelApi 1.6 ]

textComparison

現在の条件付き書式がテキスト型の場合は、特定のテキスト条件付き書式プロパティを返します。 たとえば、"Text" という単語に一致するセルの書式を設定します。

textComparison?: Excel.Interfaces.TextConditionalFormatLoadOptions;

プロパティ値

注釈

[ API セット: ExcelApi 1.6 ]

textComparisonOrNullObject

現在の条件付き書式がテキスト型の場合は、特定のテキスト条件付き書式プロパティを返します。 たとえば、"Text" という単語に一致するセルの書式を設定します。

textComparisonOrNullObject?: Excel.Interfaces.TextConditionalFormatLoadOptions;

プロパティ値

注釈

[ API セット: ExcelApi 1.6 ]

topBottom

現在の条件付き書式が TopBottom 型の場合は、上下の条件付き書式プロパティを返します。 たとえば、上位 10% または下位 10 個の項目を書式設定します。

topBottom?: Excel.Interfaces.TopBottomConditionalFormatLoadOptions;

プロパティ値

注釈

[ API セット: ExcelApi 1.6 ]

topBottomOrNullObject

現在の条件付き書式が TopBottom 型の場合は、上下の条件付き書式プロパティを返します。 たとえば、上位 10% または下位 10 個の項目を書式設定します。

topBottomOrNullObject?: Excel.Interfaces.TopBottomConditionalFormatLoadOptions;

プロパティ値

注釈

[ API セット: ExcelApi 1.6 ]

type

条件付き書式の種類。 一度に設定できるのは 1 つだけです。

type?: boolean;

プロパティ値

boolean

注釈

[ API セット: ExcelApi 1.6 ]