PathGradientBrush Kelas

Definisi

Ruang nama:

System.Drawing.Drawing2D

Rakitan:

System.Drawing.Common.dll

Sumber:

PathGradientBrush.cs

Merangkum Brush objek yang mengisi interior GraphicsPath objek dengan gradien. Kelas ini tidak dapat diwariskan.

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

Warisan

Object

MarshalByRefObject

Brush

PathGradientBrush

Contoh

Contoh kode berikut menunjukkan cara membuat PathGradientBrush. Contoh ini dirancang untuk digunakan dengan Windows Forms, dan memerlukan PaintEventArgs e, yang merupakan parameter dari 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)

Keterangan

Gradien warna adalah bayangan warna yang halus dari titik tengah jalur ke tepi batas luar jalur. Faktor campuran, posisi, dan gaya memengaruhi di mana gradien dimulai dan berakhir, dan seberapa cepat perubahan bayangan.

Sikat gradien jalur tidak mematuhi SmoothingMode properti objek yang Graphics digunakan untuk melakukan gambar. Area yang PathGradientBrush diisi menggunakan objek dirender dengan cara yang sama (alias) terlepas dari mode penghalusan.

Nota

Dalam .NET 6 dan versi yang lebih baru, paket System.Drawing.Common, yang mencakup jenis ini, hanya didukung pada sistem operasi Windows. Penggunaan jenis ini dalam aplikasi lintas platform menyebabkan peringatan waktu kompilasi dan pengecualian run-time. Untuk informasi selengkapnya, lihat System.Drawing.Common hanya didukung di Windows.

Konstruktor

Nama	Deskripsi
PathGradientBrush(GraphicsPath)	Menginisialisasi instans PathGradientBrush baru kelas dengan jalur yang ditentukan.
PathGradientBrush(Point[], WrapMode)	Menginisialisasi instans PathGradientBrush baru kelas dengan titik dan mode bungkus yang ditentukan.
PathGradientBrush(Point[])	Menginisialisasi instans PathGradientBrush baru kelas dengan titik yang ditentukan.
PathGradientBrush(PointF[], WrapMode)	Menginisialisasi instans PathGradientBrush baru kelas dengan titik dan mode bungkus yang ditentukan.
PathGradientBrush(PointF[])	Menginisialisasi instans PathGradientBrush baru kelas dengan titik yang ditentukan.
PathGradientBrush(ReadOnlySpan<Point>)	Menginisialisasi instans PathGradientBrush baru kelas dengan titik yang ditentukan.
PathGradientBrush(ReadOnlySpan<PointF>)	Menginisialisasi instans PathGradientBrush baru kelas dengan titik yang ditentukan.
PathGradientBrush(WrapMode, ReadOnlySpan<Point>)	Menginisialisasi instans PathGradientBrush baru kelas dengan titik dan mode bungkus yang ditentukan.
PathGradientBrush(WrapMode, ReadOnlySpan<PointF>)	Menginisialisasi instans PathGradientBrush baru kelas dengan titik dan mode bungkus yang ditentukan.

Properti

Nama	Deskripsi
Blend	Mendapatkan atau mengatur Blend yang menentukan posisi dan faktor yang menentukan falloff kustom untuk gradien.
CenterColor	Mendapatkan atau mengatur warna di tengah gradien jalur.
CenterPoint	Mendapatkan atau mengatur titik tengah gradien jalur.
FocusScales	Mendapatkan atau mengatur titik fokus untuk falloff gradien.
InterpolationColors	Mendapatkan atau mengatur ColorBlend yang menentukan gradien linier multikolom.
Rectangle	Mendapatkan persegi panjang pembatas untuk ini PathGradientBrush.
SurroundColors	Mendapatkan atau mengatur array warna yang sesuai dengan titik dalam jalur yang diisi ini PathGradientBrush .
Transform	Mendapatkan atau mengatur salinan Matrix yang mendefinisikan transformasi geometrik lokal untuk ini PathGradientBrush.
WrapMode	Mendapatkan atau mengatur WrapMode yang menunjukkan mode bungkus untuk ini PathGradientBrush.

Metode

Nama	Deskripsi
Clone()	Membuat salinan yang tepat dari ini PathGradientBrush.
Dispose()	Merilis semua sumber daya yang digunakan oleh objek ini Brush . (Diperoleh dari Brush)
Dispose(Boolean)	Merilis sumber daya yang tidak dikelola yang Brush digunakan oleh dan secara opsional merilis sumber daya terkelola. (Diperoleh dari Brush)
MultiplyTransform(Matrix, MatrixOrder)	Memperbarui matriks transformasi kuas dengan produk matriks transformasi sikat dikalikan dengan matriks lain.
MultiplyTransform(Matrix)	Memperbarui matriks transformasi kuas dengan produk matriks transformasi sikat dikalikan dengan matriks lain.
ResetTransform()	Mereset properti ke Transform identitas.
RotateTransform(Single, MatrixOrder)	Memutar transformasi geometrik lokal dengan jumlah yang ditentukan dalam urutan yang ditentukan.
RotateTransform(Single)	Memutar transformasi geometrik lokal dengan jumlah yang ditentukan. Metode ini menangguhkan rotasi ke transformasi.
ScaleTransform(Single, Single, MatrixOrder)	Menskalakan transformasi geometrik lokal dengan jumlah yang ditentukan dalam urutan yang ditentukan.
ScaleTransform(Single, Single)	Menskalakan transformasi geometrik lokal dengan jumlah yang ditentukan. Metode ini menambahkan matriks penskala ke transformasi.
SetBlendTriangularShape(Single, Single)	Membuat gradien dengan warna tengah dan falloff linier ke setiap warna di sekitarnya.
SetBlendTriangularShape(Single)	Membuat gradien dengan warna tengah dan falloff linier ke satu warna di sekitarnya.
SetNativeBrush(IntPtr)	Dalam kelas turunan, mengatur referensi ke objek sikat GDI+. (Diperoleh dari Brush)
SetSigmaBellShape(Single, Single)	Membuat kuas gradien yang berubah warna mulai dari tengah jalur keluar ke batas jalur. Transisi dari satu warna ke warna lainnya didasarkan pada kurva berbentuk bel.
SetSigmaBellShape(Single)	Membuat kuas gradien yang berubah warna mulai dari tengah jalur keluar ke batas jalur. Transisi dari satu warna ke warna lainnya didasarkan pada kurva berbentuk bel.
TranslateTransform(Single, Single, MatrixOrder)	Menerapkan terjemahan yang ditentukan ke transformasi geometrik lokal dalam urutan yang ditentukan.
TranslateTransform(Single, Single)	Menerapkan terjemahan yang ditentukan ke transformasi geometrik lokal. Metode ini menambahkan terjemahan ke transformasi.

Lihat juga

• Cara: Membuat Gradien Jalur