LinearGradientBrush Sınıf

Tanım

Ad Alanı:

System.Drawing.Drawing2D

Bütünleştirilmiş Kod:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v9.0.0-preview.5.24306.5

Kaynak:

LinearGradientBrush.cs

Doğrusal gradyan ile bir Brush kapsüller. Bu sınıf devralınamaz.

public ref class LinearGradientBrush sealed : System::Drawing::Brush

public sealed class LinearGradientBrush : System.Drawing.Brush

type LinearGradientBrush = class
    inherit Brush

Public NotInheritable Class LinearGradientBrush
Inherits Brush

Devralma

Object

MarshalByRefObject

Brush

LinearGradientBrush

Örnekler

Aşağıdaki örnek yatay bir LinearGradientBrusholuşturur; 0 yatay koordinatından 200 yatay koordinata ilerledikçe renk bileşenleri doğrusal olarak değişir. Örneğin, ilk koordinatı 0 ile 200 arasında olan bir nokta, 0 ile 255 arasında bir mavi bileşene sahip olur. Bu örnek, Windows Forms ile kullanılmak üzere tasarlanmıştır. Aşağıdaki kod örneği, Windows Forms ile kullanılmak üzere tasarlanmıştır ve PaintEventHandlerparametresi olan PaintEventArgsegerektirir.

public void UseHorizontalLinearGradients(PaintEventArgs e)
{
    LinearGradientBrush linGrBrush = new LinearGradientBrush(
       new Point(0, 10),
       new Point(200, 10),
       Color.FromArgb(255, 255, 0, 0),   // Opaque red
       Color.FromArgb(255, 0, 0, 255));  // Opaque blue

    Pen pen = new Pen(linGrBrush);

    e.Graphics.DrawLine(pen, 0, 10, 200, 10);
    e.Graphics.FillEllipse(linGrBrush, 0, 30, 200, 100);
    e.Graphics.FillRectangle(linGrBrush, 0, 155, 500, 30);
}

Dim linGrBrush As New LinearGradientBrush( _
   New Point(0, 10), _
   New Point(200, 10), _
   Color.FromArgb(255, 255, 0, 0), _
   Color.FromArgb(255, 0, 0, 255))
Dim pen As New Pen(linGrBrush)

e.Graphics.DrawLine(pen, 0, 10, 200, 10)
e.Graphics.FillEllipse(linGrBrush, 0, 30, 200, 100)
e.Graphics.FillRectangle(linGrBrush, 0, 155, 500, 30)

Açıklamalar

Bu sınıf hem iki renkli gradyanları hem de özel çok renkli gradyanları kapsüller.

Tüm doğrusal gradyanlar, dikdörtgen genişliğiyle veya iki noktayla belirtilen bir çizgi boyunca tanımlanır.

Varsayılan olarak, iki renkli doğrusal gradyan, başlangıç renginden belirtilen çizgi boyunca bitiş rengine kadar çift yatay bir doğrusal karışımdır. Blend sınıfını, SetSigmaBellShape yöntemlerini veya SetBlendTriangularShape yöntemlerini kullanarak blend desenini özelleştirin. LinearGradientMode numaralandırmasını veya oluşturucudaki açıyı belirterek gradyanın yönünü özelleştirin.

Çok renkli gradyan oluşturmak için InterpolationColors özelliğini kullanın.

Transform özelliği gradyan için uygulanan yerel geometrik dönüşümü belirtir.

Not

.NET 6 ve sonraki sürümlerde, bu türü içeren System.Drawing.Common paketiyalnı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'da desteklenir.

Oluşturucular

LinearGradientBrush(Point, Point, Color, Color)	Belirtilen noktalar ve renklerle LinearGradientBrush sınıfının yeni bir örneğini başlatır.
LinearGradientBrush(PointF, PointF, Color, Color)	Belirtilen noktalar ve renklerle LinearGradientBrush sınıfının yeni bir örneğini başlatır.
LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode)	Dikdörtgen, başlangıç ve bitiş renkleri ve yönlendirme temelinde LinearGradientBrush sınıfının yeni bir örneğini oluşturur.
LinearGradientBrush(Rectangle, Color, Color, Single)	Dikdörtgen, başlangıç ve bitiş renkleri ve yönlendirme açısı temelinde LinearGradientBrush sınıfının yeni bir örneğini oluşturur.
LinearGradientBrush(Rectangle, Color, Color, Single, Boolean)	Dikdörtgen, başlangıç ve bitiş renkleri ve yönlendirme açısı temelinde LinearGradientBrush sınıfının yeni bir örneğini oluşturur.
LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode)	Dikdörtgeni, başlangıç ve bitiş renklerini ve yönlendirme modunu temel alan yeni bir LinearGradientBrush örneği oluşturur.
LinearGradientBrush(RectangleF, Color, Color, Single)	Dikdörtgen, başlangıç ve bitiş renkleri ve yönlendirme açısı temelinde LinearGradientBrush sınıfının yeni bir örneğini oluşturur.
LinearGradientBrush(RectangleF, Color, Color, Single, Boolean)	Dikdörtgen, başlangıç ve bitiş renkleri ve yönlendirme açısı temelinde LinearGradientBrush sınıfının yeni bir örneğini oluşturur.

Özellikler

Blend	Gradyan için özel bir düşüş tanımlayan konumları ve faktörleri belirten bir Blend alır veya ayarlar.
GammaCorrection	Bu LinearGradientBrushiçin gama düzeltmenin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.
InterpolationColors	Çok renkli doğrusal gradyan tanımlayan bir ColorBlend alır veya ayarlar.
LinearColors	Gradyanın başlangıç ve bitiş renklerini alır veya ayarlar.
Rectangle	Gradyanın başlangıç ve bitiş noktalarını tanımlayan dikdörtgen bir bölge alır.
Transform	Bu LinearGradientBrushiçin yerel geometrik dönüşümü tanımlayan bir kopya Matrix alır veya ayarlar.
WrapMode	Bu LinearGradientBrushsarmalama modunu gösteren bir WrapMode sabit listesi alır veya ayarlar.

Yöntemler

Clone()	Bu LinearGradientBrushtam 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 nesnesi 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 isteğe bağlı olarak yönetilen kaynakları 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()	Geçerli örneğin Type 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 Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnesinin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
MultiplyTransform(Matrix)	Bu LinearGradientBrush yerel geometrik dönüşümünü temsil eden Matrix belirtilen Matrixön Matrix çarpar.
MultiplyTransform(Matrix, MatrixOrder)	Bu LinearGradientBrush yerel geometrik dönüşümünü belirtilen sırada belirtilen Matrix temsil eden Matrix çarpar.
ResetTransform()	Transform özelliğini kimliğe sıfırlar.
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.
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 matrisini dönüşüme ekler.
ScaleTransform(Single, Single, MatrixOrder)	Yerel geometrik dönüşümü belirtilen sırada belirtilen tutarlara göre ölçeklendirir.
SetBlendTriangularShape(Single)	Orta renkli doğrusal gradyan ve her iki uçta tek bir renge doğrusal bir dönüş oluşturur.
SetBlendTriangularShape(Single, Single)	Orta renkli doğrusal gradyan ve her iki uçta tek bir renge doğrusal bir dönüş oluşturur.
SetNativeBrush(IntPtr)	Türetilmiş bir sınıfta, GDI+ fırça nesnesine başvuru ayarlar. (Devralındığı yer: Brush)
SetSigmaBellShape(Single)	Çan şeklindeki eğriyi temel alan gradyan düşüşü oluşturur.
SetSigmaBellShape(Single, Single)	Çan şeklindeki eğriyi temel alan gradyan düşüşü oluşturur.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)
TranslateTransform(Single, Single)	Yerel geometrik dönüşümü belirtilen boyutlara göre çevirir. Bu yöntem, çeviriyi dönüştürmeye ekler.
TranslateTransform(Single, Single, MatrixOrder)	Yerel geometrik dönüşümü belirtilen boyutlara göre belirtilen sırada çevirir.

Ayrıca bkz.

• Nasıl Yapılır: Doğrusal Gradyan Oluşturma