CellFillRectangularGradient コンストラクタ

新しい CellFillRectangularGradient インスタンスを作成します。

シンタックス

C#

public CellFillRectangularGradient( 
   double left,
   double top,
   double right,
   double bottom,
   params CellFillGradientStop[] stops
)

パラメータ

left

グラデーションのインナー長方形の左辺です。0.0 (セルの左辺) から 1.0 (セルの右辺) までの値をとります。

top

グラデーションのインナー長方形の上辺です。0.0 (セルの上辺) から 1.0 (セルの底辺) までの値をとります。

right

グラデーションのインナー長方形の右辺です。0.0 (セルの左辺) から 1.0 (セルの右辺) までの値をとります。

bottom

グラデーションのインナー長方形の底辺です。0.0 (セルの上辺) から 1.0 (セルの底辺) までの値をとります。

stops

グラデーションの色遷移と配置を記述する 2 つ以上のグラデーション境界。

例外

例外	解説
System.ArgumentOutOfRangeException	left、top、right、または bottom が 0.0 未満の値であるか、または 1.0 を超える値です。
System.ArgumentException	stops に 2 つ以上のグラデーション境界が含まれていません。グラデーションを定義するには最低 2 つの境界が必要です。

解説

長方形グラデーションは、インナー長方形とワンセットのグラデーション境界を指定するという形で定義します。グラデーションはインナー長方形の縁からセルの縁に向かって進みます。インナー長方形の高さや幅がゼロでない場合、インナー長方形の中心は最初のグラデーション境界の色で塗りつぶされます。

インナー長方形は、left、top、right、および bottom の各パラメーターによって定義されます。こうしたパラメーターは、0.0 から 1.0 の範囲の相対値で、左上から右下に向かって増えていきます。したがって、たとえば、中心から外に向かって進むグラデーションを指定するには、すべての値を 0.5 に設定します。また、セルの左下隅から外に向かって進むグラデーションを指定するには、以下の値を使用します: left = 0.0、top = 1.0、right = 0.0、bottom = 1.0。