PathGradientBrush クラス

定義

GraphicsPath オブジェクトの内部をグラデーションで塗りつぶす Brush オブジェクトをカプセル化します。Encapsulates a Brush object that fills the interior of a GraphicsPath object with a gradient. このクラスは継承できません。This class cannot be inherited.

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

PathGradientBrush作成する方法を次のコード例に示します。The following code example shows how to create a PathGradientBrush. この例は、Windows フォームで使用するように設計されPaintEventArgsています。この例でPaintEventHandlerは、e が必要です。これは、のパラメーターです。This example is designed for use with Windows Forms, and it requires the PaintEventArgs e, which is a parameter of PaintEventHandler.

public void FillEllipseWithPathGradient(PaintEventArgs e)
{
    // Create a path that consists of a single ellipse.
    GraphicsPath path = new GraphicsPath();
    path.AddEllipse(0, 0, 140, 70);

    // Use the path to construct a brush.
    PathGradientBrush pthGrBrush = new PathGradientBrush(path);

    // Set the color at the center of the path to blue.
    pthGrBrush.CenterColor = Color.FromArgb(255, 0, 0, 255);

    // Set the color along the entire boundary 
    // of the path to aqua.
    Color[] colors = { Color.FromArgb(255, 0, 255, 255) };
    pthGrBrush.SurroundColors = colors;

    e.Graphics.FillEllipse(pthGrBrush, 0, 0, 140, 70);

}
' Create a path that consists of a single ellipse.
Dim path As New GraphicsPath()
path.AddEllipse(0, 0, 140, 70)

' Use the path to construct a brush.
Dim pthGrBrush As New PathGradientBrush(path)

' Set the color at the center of the path to blue.
pthGrBrush.CenterColor = Color.FromArgb(255, 0, 0, 255)

' Set the color along the entire boundary 
' of the path to aqua.
Dim colors As Color() = {Color.FromArgb(255, 0, 255, 255)}
pthGrBrush.SurroundColors = colors

e.Graphics.FillEllipse(pthGrBrush, 0, 0, 140, 70)

注釈

色のグラデーションは、パスの中心点からパスの外側の境界線までの色の滑らかな網掛けです。The color gradient is a smooth shading of colors from the center point of the path to the outside boundary edge of the path. Blend の要因、位置、およびスタイルは、グラデーションの開始位置と終了位置、および影の変化速度に影響します。Blend factors, positions, and style affect where the gradient starts and ends, and how fast it changes shade.

パスグラデーションブラシは、描画にSmoothingMode使用されるGraphicsオブジェクトのプロパティには従いません。Path gradient brushes do not obey the SmoothingMode property of the Graphics object used to do the drawing. PathGradientBrushオブジェクトを使用して塗りつぶされた領域は、スムージングモードに関係なく同じ方法 (エイリアス) で表示されます。Areas filled using a PathGradientBrush object are rendered the same way (aliased) regardless of the smoothing mode.

コンストラクター

PathGradientBrush(GraphicsPath)

パスを指定して、PathGradientBrush クラスの新しいインスタンスを初期化します。Initializes a new instance of the PathGradientBrush class with the specified path.

PathGradientBrush(Point[])

点を指定して、PathGradientBrush クラスの新しいインスタンスを初期化します。Initializes a new instance of the PathGradientBrush class with the specified points.

PathGradientBrush(Point[], WrapMode)

点とラップ モードを指定して、PathGradientBrush クラスの新しいインスタンスを初期化します。Initializes a new instance of the PathGradientBrush class with the specified points and wrap mode.

PathGradientBrush(PointF[])

点を指定して、PathGradientBrush クラスの新しいインスタンスを初期化します。Initializes a new instance of the PathGradientBrush class with the specified points.

PathGradientBrush(PointF[], WrapMode)

点とラップ モードを指定して、PathGradientBrush クラスの新しいインスタンスを初期化します。Initializes a new instance of the PathGradientBrush class with the specified points and wrap mode.

プロパティ

Blend

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

CenterColor

パス グラデーションの中心の色を取得または設定します。Gets or sets the color at the center of the path gradient.

CenterPoint

パス グラデーションの中心点を取得または設定します。Gets or sets the center point of the path gradient.

FocusScales

グラデーションの減色の集束点を取得または設定します。Gets or sets the focus point for the gradient falloff.

InterpolationColors

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

Rectangle

PathGradientBrush に外接する四角形を取得します。Gets a bounding rectangle for this PathGradientBrush.

SurroundColors

PathGradientBrush で塗りつぶすパス内の点に対応している色の配列を取得または設定します。Gets or sets an array of colors that correspond to the points in the path this PathGradientBrush fills.

Transform

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

WrapMode

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

メソッド

Clone()

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

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)

ブラシの変換行列に別の行列を掛け合わせることにより、そのブラシの変換行列を更新します。Updates the brush's transformation matrix with the product of brush's transformation matrix multiplied by another matrix.

MultiplyTransform(Matrix, MatrixOrder)

ブラシの変換行列に別の行列を掛け合わせることにより、そのブラシの変換行列を更新します。Updates the brush's transformation matrix with the product of the brush's transformation matrix multiplied by another matrix.

ResetTransform()

Transform プロパティを ID にリセットします。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 gradient with a center color and a linear falloff to one surrounding color.

SetBlendTriangularShape(Single, Single)

中心の色から周囲の各色に向かって線形に減色していくグラデーションを作成します。Creates a gradient with a center color and a linear falloff to each surrounding color.

SetNativeBrush(IntPtr)

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

(継承元 Brush)
SetSigmaBellShape(Single)

パスの中心から境界へと外側に向かって色が変化していくグラデーション ブラシを作成します。Creates a gradient brush that changes color starting from the center of the path outward to the path's boundary. 色は、釣鐘型の曲線に基づいて、ある色から別の色へと変化していきます。The transition from one color to another is based on a bell-shaped curve.

SetSigmaBellShape(Single, Single)

パスの中心から境界へと外側に向かって色が変化していくグラデーション ブラシを作成します。Creates a gradient brush that changes color starting from the center of the path outward to the path's boundary. 色は、釣鐘型の曲線に基づいて、ある色から別の色へと変化していきます。The transition from one color to another is based on a bell-shaped curve.

ToString()

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

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

ローカル ジオメトリック変換に、指定された平行移動を適用します。Applies the specified translation to the local geometric transform. このメソッドは変換の前に平行移動を行います。This method prepends the translation to the transform.

TranslateTransform(Single, Single, MatrixOrder)

指定した順序で、指定した平行移動をローカル ジオメトリック変換に適用します。Applies the specified translation to the local geometric transform in the specified order.

適用対象

こちらもご覧ください