ColorScale インターフェイス

定義

名前空間:

Microsoft.Office.Interop.Excel

アセンブリ:

Microsoft.Office.Interop.Excel.dll

カラー スケールの条件付き書式ルールを示します。

public interface class ColorScale

[System.Runtime.InteropServices.Guid("00024493-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface ColorScale

Public Interface ColorScale

属性

GuidAttribute InterfaceTypeAttribute

例

次のコード例は、数値の範囲を作成し、2 色スケールの条件付き書式ルールをその範囲に適用します。 その後、最小しきい値の色は赤、最高しきい値の色は青に割り当てられます。

<span class="label">Sub CreateColorScaleCF() 































































































































































































































































    Dim cfColorScale As </span>
<i>ColorScale</i>
<span class="label">'Fill cells with sample data from 1 to 10     With ActiveSheet         .Range("C1") = 1         .Range("C2") = 2         .Range("C1:C2").AutoFill Destination:=Range("C1:C10")     End With          Range("C1:C10").Select          'Create a two-color ColorScale object for the created sample data range     Set cfColorScale = Selection.FormatConditions.AddColorScale(ColorScaleType:=2)          'Set the minimum threshold to red and maximum threshold to blue     cfColorScale.ColorScaleCriteria(1).FormatColor.Color = RGB(255, 0, 0)     cfColorScale.ColorScaleCriteria(2).FormatColor.Color = RGB(0, 0, 255)          End Sub</span>

注釈

すべての条件付き書式オブジェクトは、コレクション オブジェクト (コレクションの子) 内 FormatConditions に Range 含まれています。 FormatConditions コレクションの または AddColorScale(Int32) メソッドを使用Add(XlFormatConditionType, Object, Object, Object, Object, Object, Object, Object)して、カラー スケールの書式設定ルールを作成できます。

カラー スケールは、データの分布や偏差を把握するうえで視覚的な手掛かりとなります。 データ範囲、テーブルのデータ、またはピボットテーブル レポートのデータには、2 色スケールまたは 3 色スケールを適用できます。 2 色スケールの条件付き書式では、値、種類、および色を範囲の最小および最大しきい値に割り当てます。 3 色スケールには、中間しきい値もあります。

これらの各しきい値は、オブジェクトの ColorScaleCriteria プロパティを設定することによって決定されます。 ColorScaleCriteria オブジェクトは、ColorScale オブジェクトの子であり、カラー スケールのすべてのオブジェクトのColorScaleCriterionコレクションです。

プロパティ

Application	オブジェクト修飾子なしで使用する場合、このプロパティは Microsoft Office Excel アプリケーションを _Application 表すオブジェクトを返します。 オブジェクト修飾子を指定した場合、指定したオブジェクトを作成した Application オブジェクトを取得します。 読み取り専用です。
AppliesTo	書式設定規則を Range 適用するセル範囲を指定する オブジェクトを返します。
ColorScaleCriteria	個々ColorScaleCriterionのオブジェクトのColorScaleCriteriaコレクションである オブジェクトを返します。 オブジェクトは ColorScaleCriterion 、カラー スケールの条件付き形式で使用されるしきい値条件の種類、値、色を指定します。 読み取り専用です。
Creator	このオブジェクトが作成されたアプリケーションを XlCreator 示す列挙型の定数を返します。 読み取り専用です。
Formula	アイコン セットが適用される値を特定する数式を表す文字列型 (String) の値を取得または設定します。
Parent	指定されたオブジェクトの親オブジェクトを返します。 読み取り専用です。
Priority	条件付き書式ルールの優先度の値を取得、または設定します。 優先度は、ワークシート内に複数の条件付き書式ルールが存在する場合、その評価の順序を決定します。
PTCondition	条件付き書式がグラフに適用されているかどうかを示す ブール 値を PivotTable 返します。 読み取り専用です。
ScopeType	ピボットテーブル グラフに適用される条件付き書式の範囲を XlPivotConditionScope 決定する列挙の定数の 1 つを設定または返します。
StopIfTrue	現在のルールが True に評価された場合、そのセルの書式ルールをさらに評価するかどうかを表すブール型 (Boolean) の値を取得、または設定します。
Type	条件付き書式の種類を指定する列挙型の XlFormatConditionType 定数のいずれかを返します。 読み取り専用です。

メソッド

Delete()	指定された条件付き書式ルールのオブジェクトを削除します。
ModifyAppliesToRange(Range)	書式のルールが適用されるセル範囲を設定します。
SetFirstPriority()	条件付き書式ルールの優先度の値を "1" に設定し、ワークシート内の他のルールより先に評価されるようにします。
SetLastPriority()	条件付き書式ルールの順位を設定し、ワークシート上の他のすべてのルールの後に評価されるようにします。