PathGradientBrush クラス

定義

名前空間:

System.Drawing.Drawing2D

アセンブリ:

System.Drawing.Common.dll

ソース:

PathGradientBrush.cs

GraphicsPath オブジェクトの内部をグラデーションで塗りつぶすBrush オブジェクトをカプセル化します。 このクラスは継承できません。

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

継承

Object

MarshalByRefObject

Brush

PathGradientBrush

例

次のコード例は、 PathGradientBrushを作成する方法を示しています。 この例は Windows フォームで使用するように設計されており、PaintEventHandlerのパラメーターである PaintEventArgs e が必要です。

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)

注釈

カラー グラデーションは、パスの中心点からパスの外側の境界エッジまでの色の滑らかな網かけです。 ブレンド係数、位置、スタイルは、グラデーションの開始位置と終了位置、およびグラデーションの網掛けの変化速度に影響します。

パス グラデーション ブラシは、描画に使用するGraphics オブジェクトのSmoothingModeプロパティに従いません。 PathGradientBrush オブジェクトを使用して塗りつぶされた領域は、スムージング モードに関係なく、同じ方法 (エイリアス化) でレンダリングされます。

注

.NET 6 以降のバージョンでは、この種類を含む System.Drawing.Common パッケージは、Windows オペレーティング システムでのみサポートされています。 クロスプラットフォーム アプリでこの種類を使用すると、コンパイル時の警告と実行時の例外が発生します。 詳細については、「System.Drawing.Common が Windows でしかサポートされない」を参照してください。

コンストラクター

名前	説明
PathGradientBrush(GraphicsPath)	指定したパスを使用して、 PathGradientBrush クラスの新しいインスタンスを初期化します。
PathGradientBrush(Point[], WrapMode)	指定したポイントとラップ モードを使用して、 PathGradientBrush クラスの新しいインスタンスを初期化します。
PathGradientBrush(Point[])	指定したポイントを使用して、 PathGradientBrush クラスの新しいインスタンスを初期化します。
PathGradientBrush(PointF[], WrapMode)	指定したポイントとラップ モードを使用して、 PathGradientBrush クラスの新しいインスタンスを初期化します。
PathGradientBrush(PointF[])	指定したポイントを使用して、 PathGradientBrush クラスの新しいインスタンスを初期化します。
PathGradientBrush(ReadOnlySpan<Point>)	指定したポイントを使用して、 PathGradientBrush クラスの新しいインスタンスを初期化します。
PathGradientBrush(ReadOnlySpan<PointF>)	指定したポイントを使用して、 PathGradientBrush クラスの新しいインスタンスを初期化します。
PathGradientBrush(WrapMode, ReadOnlySpan<Point>)	指定したポイントとラップ モードを使用して、 PathGradientBrush クラスの新しいインスタンスを初期化します。
PathGradientBrush(WrapMode, ReadOnlySpan<PointF>)	指定したポイントとラップ モードを使用して、 PathGradientBrush クラスの新しいインスタンスを初期化します。

プロパティ

名前	説明
Blend	グラデーションのカスタムフォールオフを定義する位置と要素を指定する Blend を取得または設定します。
CenterColor	パス グラデーションの中心にある色を取得または設定します。
CenterPoint	パスグラデーションの中心点を取得または設定します。
FocusScales	グラデーションのフォールオフのフォーカス ポイントを取得または設定します。
InterpolationColors	多色線形グラデーションを定義する ColorBlend を取得または設定します。
Rectangle	この PathGradientBrushの外接する四角形を取得します。
SurroundColors	この PathGradientBrush が塗りつぶすパス内のポイントに対応する色の配列を取得または設定します。
Transform	このPathGradientBrushのローカル ジオメトリック変換を定義するMatrixのコピーを取得または設定します。
WrapMode	このPathGradientBrushのラップ モードを示すWrapModeを取得または設定します。

メソッド

名前	説明
Clone()	この PathGradientBrushの正確なコピーを作成します。
Dispose()	この Brush オブジェクトで使用されているすべてのリソースを解放します。 (継承元 Brush)
Dispose(Boolean)	Brushによって使用されるアンマネージ リソースを解放し、必要に応じてマネージド リソースを解放します。 (継承元 Brush)
MultiplyTransform(Matrix, MatrixOrder)	ブラシの変換マトリックスを、ブラシの変換行列の積に別の行列を乗算して更新します。
MultiplyTransform(Matrix)	ブラシの変換行列を、ブラシの変換行列の積に別の行列を乗算して更新します。
ResetTransform()	Transform プロパティを ID にリセットします。
RotateTransform(Single, MatrixOrder)	指定した順序で、指定した量だけローカル ジオメトリック変換を回転します。
RotateTransform(Single)	ローカル ジオメトリック変換を指定した量だけ回転します。 このメソッドは、変換の前に回転を付加します。
ScaleTransform(Single, Single, MatrixOrder)	指定した順序で、指定した量だけローカル ジオメトリック変換をスケーリングします。
ScaleTransform(Single, Single)	ローカル ジオメトリック変換を指定した量だけスケーリングします。 このメソッドは、変換の前にスケーリング マトリックスを追加します。
SetBlendTriangularShape(Single, Single)	中心の色と、周囲の各色に対する直線的なフォールオフを含むグラデーションを作成します。
SetBlendTriangularShape(Single)	中心の色と、周囲の 1 つの色に対する直線的なフォールオフを含むグラデーションを作成します。
SetNativeBrush(IntPtr)	派生クラスで、GDI+ ブラシ オブジェクトへの参照を設定します。 (継承元 Brush)
SetSigmaBellShape(Single, Single)	パスの中心からパスの境界まで外側に向かって色を変更するグラデーション ブラシを作成します。 ある色から別の色への遷移は、ベルの形をした曲線に基づいています。
SetSigmaBellShape(Single)	パスの中心からパスの境界まで外側に向かって色を変更するグラデーション ブラシを作成します。 ある色から別の色への遷移は、ベルの形をした曲線に基づいています。
TranslateTransform(Single, Single, MatrixOrder)	指定した順序で、指定した平行移動をローカル ジオメトリック変換に適用します。
TranslateTransform(Single, Single)	指定した平行移動をローカル ジオメトリック変換に適用します。 このメソッドは変換の前に変換を付加します。

こちらもご覧ください

• 方法: パスグラデーションを作成する