PathGradientBrush クラス

リファレンス

定義

名前空間:: System.Drawing.Drawing2D

アセンブリ:: System.Drawing.Common.dll

アセンブリ:: System.Drawing.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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 フォームで使用するように設計されており、パラメーターである PaintEventHandlere が必要PaintEventArgsです。

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)

注釈

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

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

注意

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

コンストラクター

PathGradientBrush(GraphicsPath)	パスを指定して、PathGradientBrush クラスの新しいインスタンスを初期化します。
PathGradientBrush(Point[])	点を指定して、PathGradientBrush クラスの新しいインスタンスを初期化します。
PathGradientBrush(Point[], WrapMode)	点とラップモードを指定して、PathGradientBrush クラスの新しいインスタンスを初期化します。
PathGradientBrush(PointF[])	点を指定して、PathGradientBrush クラスの新しいインスタンスを初期化します。
PathGradientBrush(PointF[], WrapMode)	点とラップモードを指定して、PathGradientBrush クラスの新しいインスタンスを初期化します。

プロパティ

Blend	グラデーションのカスタムの減色を定義する位置と係数を保持した Blend を取得または設定します。
CenterColor	パスグラデーションの中心の色を取得または設定します。
CenterPoint	パスグラデーションの中心点を取得または設定します。
FocusScales	グラデーションの減色の集束点を取得または設定します。
InterpolationColors	複数の色による線形グラデーションを定義する ColorBlend を取得または設定します。
Rectangle	PathGradientBrush に外接する四角形を取得します。
SurroundColors	PathGradientBrush で塗りつぶすパス内の点に対応している色の配列を取得または設定します。
Transform	この PathGradientBrush に適用されるローカルジオメトリック変換を定義する Matrix のコピーを取得または設定します。
WrapMode	この PathGradientBrush のラップモードを示す WrapMode を取得または設定します。

メソッド

Clone()	この PathGradientBrush の同一コピーを作成します。
CreateObjRef(Type)	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject)
Dispose()	この Brush オブジェクトによって使用されているすべてのリソースを解放します。 (継承元 Brush)
Dispose(Boolean)	Brush によって使用されているアンマネージドリソースを解放し、オプションでマネージドリソースも解放します。 (継承元 Brush)
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetLifetimeService()	互換性のために残されています。対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
InitializeLifetimeService()	互換性のために残されています。このインスタンスの有効期間ポリシーを制御する有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
MemberwiseClone(Boolean)	現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject)
MultiplyTransform(Matrix)	ブラシの変換行列に別の行列を掛け合わせることにより、そのブラシの変換行列を更新します。
MultiplyTransform(Matrix, MatrixOrder)	ブラシの変換行列に別の行列を掛け合わせることにより、そのブラシの変換行列を更新します。
ResetTransform()	Transform プロパティを ID にリセットします。
RotateTransform(Single)	指定した分量だけローカルジオメトリック変換を回転します。このメソッドは変換の前に回転を行います。
RotateTransform(Single, MatrixOrder)	指定した順序で、指定した分量だけローカルジオメトリック変換を回転します。
ScaleTransform(Single, Single)	指定した分量だけローカルジオメトリック変換をスケールします。このメソッドは変換の前にスケーリング行列を適用します。
ScaleTransform(Single, Single, MatrixOrder)	指定した順序で、指定した分量だけローカルジオメトリック変換をスケールします。
SetBlendTriangularShape(Single)	中心の色から周囲の色に向かって線形に減色していくグラデーションを作成します。
SetBlendTriangularShape(Single, Single)	中心の色から周囲の各色に向かって線形に減色していくグラデーションを作成します。
SetNativeBrush(IntPtr)	派生クラスで、GDI+ ブラシオブジェクトへの参照を設定します。 (継承元 Brush)
SetSigmaBellShape(Single)	パスの中心から境界へと外側に向かって色が変化していくグラデーションブラシを作成します。色は、釣鐘型の曲線に基づいて、ある色から別の色へと変化していきます。
SetSigmaBellShape(Single, Single)	パスの中心から境界へと外側に向かって色が変化していくグラデーションブラシを作成します。色は、釣鐘型の曲線に基づいて、ある色から別の色へと変化していきます。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
TranslateTransform(Single, Single)	ローカルジオメトリック変換に、指定された平行移動を適用します。このメソッドは変換の前に平行移動を行います。
TranslateTransform(Single, Single, MatrixOrder)	指定した順序で、指定した平行移動をローカルジオメトリック変換に適用します。

適用対象

こちらもご覧ください

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