PathGradientBrush Sınıf

Tanım

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
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 olan e değerini PaintEventHandlergerektirirPaintEventArgs.

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 (diğer adla) işlenir.

Not

.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

PathGradientBrush(GraphicsPath)

Belirtilen yol ile sınıfını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(Point[], WrapMode)

Belirtilen noktalar ve sarmalama modu ile sınıfını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(PointF[], WrapMode)

Belirtilen noktalar ve sarmalama modu ile sınıfının yeni bir örneğini PathGradientBrush başlatır.

Özellikler

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 dizisini 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

Clone()

Bu PathGradientBrushöğesinin tam bir kopyasını oluşturur.

CreateObjRef(Type)

Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur.

(Devralındığı yer: MarshalByRefObject)
Dispose()

Bu Brush nesne tarafından kullanılan tüm kaynakları serbest bırakır.

(Devralındığı yer: Brush)
Dispose(Boolean)

Brush tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır.

(Devralındığı yer: Brush)
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetLifetimeService()
Geçersiz.

Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır.

(Devralındığı yer: MarshalByRefObject)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
InitializeLifetimeService()
Geçersiz.

Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır.

(Devralındığı yer: MarshalByRefObject)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
MemberwiseClone(Boolean)

Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur.

(Devralındığı yer: MarshalByRefObject)
MultiplyTransform(Matrix)

Fırçanın dönüştürme matrisini, fırçanın dönüştürme matrisinin çarpımı başka bir matrisle çarpılarak Güncelleştirmeler.

MultiplyTransform(Matrix, MatrixOrder)

Fırçanın dönüştürme matrisini, fırçanın dönüştürme matrisinin çarpımı başka bir matrisle çarpılarak Güncelleştirmeler.

ResetTransform()

Özelliği kimliğe sıfırlar Transform .

RotateTransform(Single)

Yerel geometrik dönüşümü belirtilen miktarda döndürür. Bu yöntem dönüşüme döndürmenin başına ekler.

RotateTransform(Single, MatrixOrder)

Yerel geometrik dönüşümü belirtilen sırada belirtilen miktarda döndürür.

ScaleTransform(Single, Single)

Yerel geometrik dönüşümü belirtilen miktarlara göre ölçeklendirir. Bu yöntem, ölçeklendirme matrisinin başına dönüşüm ekler.

ScaleTransform(Single, Single, MatrixOrder)

Yerel geometrik dönüşümü belirtilen sırada belirtilen tutarlara göre ölçeklendirir.

SetBlendTriangularShape(Single)

Orta rengi olan bir gradyan ve çevreleyen bir renge doğrusal bir düşüş oluşturur.

SetBlendTriangularShape(Single, Single)

Orta renkli bir gradyan ve çevresindeki her 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)

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, 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.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
TranslateTransform(Single, Single)

Belirtilen çeviriyi yerel geometrik dönüşüme uygular. Bu yöntem, çeviriyi dönüştürmeye ekler.

TranslateTransform(Single, Single, MatrixOrder)

Belirtilen çeviriyi belirtilen sırada yerel geometrik dönüşüme uygular.

Şunlara uygulanır

Ayrıca bkz.