ColorScale インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
カラー スケールの条件付き書式ルールを示します。
public interface class ColorScale[System.Runtime.InteropServices.Guid("00024493-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface ColorScalePublic Interface ColorScale- 属性
例
次のコード例は、数値の範囲を作成し、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() |
条件付き書式ルールの順位を設定し、ワークシート上の他のすべてのルールの後に評価されるようにします。 |