PathGradientBrush Sınıf

Tanım

Ad Alanı:

System.Drawing.Drawing2D

Bütünleştirilmiş Kod:

System.Drawing.Common.dll

Kaynak:

PathGradientBrush.cs

Bir nesnenin içini gradyanla dolduran bir GraphicsPath nesneyi kapsüllerBrush. Bu sınıf devralınamaz.

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

Devralma

Object

MarshalByRefObject

Brush

PathGradientBrush

Örnekler

Aşağıdaki kod örneğinde nasıl oluşturulacağı gösterilmektedir PathGradientBrush. Bu örnek, Windows Forms ile kullanılmak üzere tasarlanmıştır ve parametresi PaintEventHandlerolan e değerini gerektirirPaintEventArgs.

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)

Açıklamalar

Renk gradyanı, yolun orta noktasından yolun dış sınır kenarına kadar renklerin düzgün gölgelenmesidir. Blend faktörleri, konumları ve stili gradyanın nerede başlayıp bittiğini ve gölgenin ne kadar hızlı değiştiğini etkiler.

Yol gradyan fırçaları, çizimi yapmak için kullanılan nesnenin Graphics özelliğine uymazSmoothingMode. Nesne PathGradientBrush kullanılarak doldurulan alanlar, düzeltme modundan bağımsız olarak aynı şekilde işlenir (diğer ad kullanılır).

Uyarı

.NET 6 ve sonraki sürümlerde, bu türü içeren System.Drawing.Common paketi yalnızca Windows işletim sistemlerinde desteklenir. Platformlar arası uygulamalarda bu türün kullanılması derleme zamanı uyarılarına ve çalışma zamanı özel durumlarına neden olur. Daha fazla bilgi için bkz . System.Drawing.Common yalnızca Windows'ta desteklenir.

Oluşturucular

Name	Description
PathGradientBrush(GraphicsPath)	Belirtilen yol ile sınıfının yeni bir örneğini PathGradientBrush başlatır.
PathGradientBrush(Point[], WrapMode)	Belirtilen noktalar ve sarmalama moduyla sınıfın yeni bir örneğini PathGradientBrush başlatır.
PathGradientBrush(Point[])	Belirtilen noktalarla sınıfının yeni bir örneğini PathGradientBrush başlatır.
PathGradientBrush(PointF[], WrapMode)	Belirtilen noktalar ve sarmalama moduyla sınıfın yeni bir örneğini PathGradientBrush başlatır.
PathGradientBrush(PointF[])	Belirtilen noktalarla sınıfının yeni bir örneğini PathGradientBrush başlatır.
PathGradientBrush(ReadOnlySpan<Point>)	Belirtilen noktalarla sınıfının yeni bir örneğini PathGradientBrush başlatır.
PathGradientBrush(ReadOnlySpan<PointF>)	Belirtilen noktalarla sınıfının yeni bir örneğini PathGradientBrush başlatır.
PathGradientBrush(WrapMode, ReadOnlySpan<Point>)	Belirtilen noktalar ve sarmalama moduyla sınıfın yeni bir örneğini PathGradientBrush başlatır.
PathGradientBrush(WrapMode, ReadOnlySpan<PointF>)	Belirtilen noktalar ve sarmalama moduyla sınıfın yeni bir örneğini PathGradientBrush başlatır.

Özellikler

Name	Description
Blend	Gradyan için özel bir Blend düşüş tanımlayan konumları ve faktörleri belirten bir alır veya ayarlar.
CenterColor	Yol gradyanının ortasındaki rengi alır veya ayarlar.
CenterPoint	Yol gradyanının orta noktasını alır veya ayarlar.
FocusScales	Gradyan düşüşü için odak noktasını alır veya ayarlar.
InterpolationColors	Çok renkli doğrusal gradyan tanımlayan bir ColorBlend alır veya ayarlar.
Rectangle	Bu PathGradientBrushiçin sınırlayıcı bir dikdörtgen alır.
SurroundColors	Bu PathGradientBrush dolgu yolundaki noktalara karşılık gelen bir renk dizisi alır veya ayarlar.
Transform	Bu PathGradientBrushiçin yerel geometrik dönüşümü tanımlayan bir kopyasını Matrix alır veya ayarlar.
WrapMode	Bu PathGradientBrushiçin sarmalama modunu gösteren bir WrapMode alır veya ayarlar.

Yöntemler

Name	Description
Clone()	Bunun PathGradientBrushtam bir kopyasını oluşturur.
Dispose()	Bu Brush nesne tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Brush)
Dispose(Boolean)	tarafından Brush kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır. (Devralındığı yer: Brush)
MultiplyTransform(Matrix, MatrixOrder)	Fırçanın dönüştürme matrisini, fırçanın dönüştürme matrisinin çarpımı ile başka bir matrisle çarpılarak güncelleştirir.
MultiplyTransform(Matrix)	Fırçanın dönüşüm matrisini, fırçanın dönüşüm matrisinin çarpımı başka bir matrisle çarpılarak güncelleştirir.
ResetTransform()	Özelliğini kimliğe sıfırlar Transform .
RotateTransform(Single, MatrixOrder)	Yerel geometrik dönüşümü belirtilen sırada belirtilen miktarda döndürür.
RotateTransform(Single)	Yerel geometrik dönüşümü belirtilen miktarda döndürür. Bu yöntem, dönüşümü döndürmenin başına ekler.
ScaleTransform(Single, Single, MatrixOrder)	Yerel geometrik dönüşümü belirtilen sırada belirtilen tutarlara göre ölçeklendirir.
ScaleTransform(Single, Single)	Yerel geometrik dönüşümü belirtilen miktarlara göre ölçeklendirir. Bu yöntem, ölçeklendirme matrisini dönüşüme ekler.
SetBlendTriangularShape(Single, Single)	Orta renkli bir gradyan ve çevresindeki her renge doğrusal bir düşüş oluşturur.
SetBlendTriangularShape(Single)	Orta renkli bir gradyan ve çevresindeki tek bir renge doğrusal bir düşüş oluşturur.
SetNativeBrush(IntPtr)	Türetilmiş bir sınıfta, GDI+ fırça nesnesine başvuru ayarlar. (Devralındığı yer: Brush)
SetSigmaBellShape(Single, Single)	Yolun ortasından başlayıp yolun sınırına kadar renk değiştiren bir gradyan fırçası oluşturur. Bir renkten diğerine geçiş, çan şeklindeki eğriyi temel alır.
SetSigmaBellShape(Single)	Yolun ortasından başlayıp yolun sınırına kadar renk değiştiren bir gradyan fırçası oluşturur. Bir renkten diğerine geçiş, çan şeklindeki eğriyi temel alır.
TranslateTransform(Single, Single, MatrixOrder)	Belirtilen çeviriyi, belirtilen sırada yerel geometrik dönüşüme uygular.
TranslateTransform(Single, Single)	Belirtilen çeviriyi yerel geometrik dönüşüme uygular. Bu yöntem, çeviriyi dönüştürmeye ekler.

Ayrıca bkz.

• Nasıl yapılır: Yol Gradyanı Oluşturma