LinearGradientBrush クラス

定義

線形グラデーションされた Brush をカプセル化します。Encapsulates a Brush with a linear gradient. このクラスは継承できません。This class cannot be inherited.

public ref class LinearGradientBrush sealed : System::Drawing::Brush
public sealed class LinearGradientBrush : System.Drawing.Brush
type LinearGradientBrush = class
    inherit Brush
Public NotInheritable Class LinearGradientBrush
Inherits Brush
継承
LinearGradientBrush

次の例では、水平 LinearGradientBrushを作成します。水平方向の座標0から200の水平方向の座標に移動すると、カラーコンポーネントが直線的に変化します。The following example creates a horizontal LinearGradientBrush; the color components change linearly as you move from a horizontal coordinate of 0 to a horizontal coordinate of 200. たとえば、最初の座標が 0 ~ 200 の中間にある点には、0から255の中間にある青のコンポーネントがあります。For example, a point whose first coordinate is halfway between 0 and 200 will have a blue component that is halfway between 0 and 255. この例は、Windows フォームで使用するように設計されています。This example is designed for use with Windows Forms. 次のコード例は、Windows フォームで使用するように設計されています。また、PaintEventHandlerのパラメーターである PaintEventArgseが必要です。The following code example is designed for use with Windows Forms, and it requires the PaintEventArgse, which is a parameter of PaintEventHandler.

public void UseHorizontalLinearGradients(PaintEventArgs e)
{
    LinearGradientBrush linGrBrush = new LinearGradientBrush(
       new Point(0, 10),
       new Point(200, 10),
       Color.FromArgb(255, 255, 0, 0),   // Opaque red
       Color.FromArgb(255, 0, 0, 255));  // Opaque blue

    Pen pen = new Pen(linGrBrush);

    e.Graphics.DrawLine(pen, 0, 10, 200, 10);
    e.Graphics.FillEllipse(linGrBrush, 0, 30, 200, 100);
    e.Graphics.FillRectangle(linGrBrush, 0, 155, 500, 30);
}
Dim linGrBrush As New LinearGradientBrush( _
   New Point(0, 10), _
   New Point(200, 10), _
   Color.FromArgb(255, 255, 0, 0), _
   Color.FromArgb(255, 0, 0, 255))
Dim pen As New Pen(linGrBrush)

e.Graphics.DrawLine(pen, 0, 10, 200, 10)
e.Graphics.FillEllipse(linGrBrush, 0, 30, 200, 100)
e.Graphics.FillRectangle(linGrBrush, 0, 155, 500, 30)

注釈

このクラスは、2色のグラデーションとカスタムの多色グラデーションの両方をカプセル化します。This class encapsulates both two-color gradients and custom multicolor gradients.

すべての線状グラデーションは、四角形の幅または2つの点によって指定された線に沿って定義されます。All linear gradients are defined along a line specified either by the width of a rectangle or by two points.

既定では、2色の線状グラデーションは、開始色から指定された直線に沿った終了色までの、均等な水平方向の線形ブレンドです。By default, a two-color linear gradient is an even horizontal linear blend from the starting color to the ending color along the specified line. Blend クラス、SetSigmaBellShape メソッド、または SetBlendTriangularShape メソッドを使用して blend パターンをカスタマイズします。Customize the blend pattern using the Blend class, the SetSigmaBellShape methods, or the SetBlendTriangularShape methods. LinearGradientMode 列挙体またはコンストラクターの角度を指定して、グラデーションの方向をカスタマイズします。Customize the direction of the gradient by specifying the LinearGradientMode enumeration or the angle in the constructor.

InterpolationColors プロパティを使用して、多色グラデーションを作成します。Use the InterpolationColors property to create a multicolor gradient.

Transform プロパティは、グラデーションに適用されるローカルジオメトリック変換を指定します。The Transform property specifies a local geometric transform applied to the gradient.

コンストラクター

LinearGradientBrush(Point, Point, Color, Color)

指定したポイントと色で、LinearGradientBrush クラスの新しいインスタンスを初期化します。Initializes a new instance of the LinearGradientBrush class with the specified points and colors.

LinearGradientBrush(PointF, PointF, Color, Color)

指定したポイントと色で、LinearGradientBrush クラスの新しいインスタンスを初期化します。Initializes a new instance of the LinearGradientBrush class with the specified points and colors.

LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode)

四角形、開始色、終了色、および方向に基づいて、LinearGradientBrush クラスの新しいインスタンスを作成します。Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and orientation.

LinearGradientBrush(Rectangle, Color, Color, Single)

四角形、開始色、終了色、および方向の角度に基づいて、LinearGradientBrush クラスの新しいインスタンスを作成します。Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

LinearGradientBrush(Rectangle, Color, Color, Single, Boolean)

四角形、開始色、終了色、および方向の角度に基づいて、LinearGradientBrush クラスの新しいインスタンスを作成します。Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode)

四角形、開始色、終了色、および方向のモードに基づいて、LinearGradientBrush の新しいインスタンスを作成します。Creates a new instance of the LinearGradientBrush based on a rectangle, starting and ending colors, and an orientation mode.

LinearGradientBrush(RectangleF, Color, Color, Single)

四角形、開始色、終了色、および方向の角度に基づいて、LinearGradientBrush クラスの新しいインスタンスを作成します。Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

LinearGradientBrush(RectangleF, Color, Color, Single, Boolean)

四角形、開始色、終了色、および方向の角度に基づいて、LinearGradientBrush クラスの新しいインスタンスを作成します。Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

プロパティ

Blend

グラデーションのカスタムの減色を定義する位置と係数を保持した Blend を取得または設定します。Gets or sets a Blend that specifies positions and factors that define a custom falloff for the gradient.

GammaCorrection

LinearGradientBrush に対してガンマ補正が有効になっているかどうかを示す値を取得または設定します。Gets or sets a value indicating whether gamma correction is enabled for this LinearGradientBrush.

InterpolationColors

複数の色による線形グラデーションを定義する ColorBlend を取得または設定します。Gets or sets a ColorBlend that defines a multicolor linear gradient.

LinearColors

グラデーションの開始色と終了色を取得または設定します。Gets or sets the starting and ending colors of the gradient.

Rectangle

グラデーションの開始点と終了点を定義する四角形領域を取得します。Gets a rectangular region that defines the starting and ending points of the gradient.

Transform

この Matrix に適用されるローカル ジオメトリック変換を定義する LinearGradientBrush のコピーを取得または設定します。Gets or sets a copy Matrix that defines a local geometric transform for this LinearGradientBrush.

WrapMode

この WrapMode のラップ モードを示す LinearGradientBrush 列挙体を取得または設定します。Gets or sets a WrapMode enumeration that indicates the wrap mode for this LinearGradientBrush.

メソッド

Clone()

この LinearGradientBrush の同一コピーを作成します。Creates an exact copy of this LinearGradientBrush.

CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(継承元 MarshalByRefObject)
Dispose()

この Brush オブジェクトによって使用されているすべてのリソースを解放します。Releases all resources used by this Brush object.

(継承元 Brush)
Dispose(Boolean)

Brush によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。Releases the unmanaged resources used by the Brush and optionally releases the managed resources.

(継承元 Brush)
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判定します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(継承元 MarshalByRefObject)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。Obtains a lifetime service object to control the lifetime policy for this instance.

(継承元 MarshalByRefObject)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。Creates a shallow copy of the current MarshalByRefObject object.

(継承元 MarshalByRefObject)
MultiplyTransform(Matrix)

指定された Matrix を先に適用するように指定して、LinearGradientBrush のローカル ジオメトリック変換を表す Matrix に、この指定された Matrix を乗算します。Multiplies the Matrix that represents the local geometric transform of this LinearGradientBrush by the specified Matrix by prepending the specified Matrix.

MultiplyTransform(Matrix, MatrixOrder)

Matrix のローカル ジオメトリック変換を表す LinearGradientBrush に、指定された Matrix を指定された順序で乗算します。Multiplies the Matrix that represents the local geometric transform of this LinearGradientBrush by the specified Matrix in the specified order.

ResetTransform()

Transform プロパティを単位行列にリセットします。Resets the Transform property to identity.

RotateTransform(Single)

指定した分量だけローカル ジオメトリック変換を回転します。Rotates the local geometric transform by the specified amount. このメソッドは変換の前に回転を行います。This method prepends the rotation to the transform.

RotateTransform(Single, MatrixOrder)

指定した順序で、指定した分量だけローカル ジオメトリック変換を回転します。Rotates the local geometric transform by the specified amount in the specified order.

ScaleTransform(Single, Single)

指定した分量だけローカル ジオメトリック変換をスケールします。Scales the local geometric transform by the specified amounts. このメソッドは変換の前にスケーリング行列を適用します。This method prepends the scaling matrix to the transform.

ScaleTransform(Single, Single, MatrixOrder)

指定した順序で、指定した分量だけローカル ジオメトリック変換をスケールします。Scales the local geometric transform by the specified amounts in the specified order.

SetBlendTriangularShape(Single)

中心の色、および両端の単色への線形の減色が設定されている線形グラデーションを作成します。Creates a linear gradient with a center color and a linear falloff to a single color on both ends.

SetBlendTriangularShape(Single, Single)

中心の色、および両端の単色への線形の減色が設定されている線形グラデーションを作成します。Creates a linear gradient with a center color and a linear falloff to a single color on both ends.

SetNativeBrush(IntPtr)

派生クラスでは、GDI+GDI+ ブラシ オブジェクトへの参照を設定します。In a derived class, sets a reference to a GDI+GDI+ brush object.

(継承元 Brush)
SetSigmaBellShape(Single)

釣鐘型の曲線に基づいて、グラデーションの減色を作成します。Creates a gradient falloff based on a bell-shaped curve.

SetSigmaBellShape(Single, Single)

釣鐘型の曲線に基づいて、グラデーションの減色を作成します。Creates a gradient falloff based on a bell-shaped curve.

ToString()

現在のオブジェクトを表す string を返します。Returns a string that represents the current object.

(継承元 Object)
TranslateTransform(Single, Single)

指定した寸法でローカル ジオメトリック変換を平行移動します。Translates the local geometric transform by the specified dimensions. このメソッドは変換の前に平行移動を行います。This method prepends the translation to the transform.

TranslateTransform(Single, Single, MatrixOrder)

指定した順序で、指定した寸法だけローカル ジオメトリック変換を平行移動します。Translates the local geometric transform by the specified dimensions in the specified order.

適用対象

こちらもご覧ください