LinearGradientBrush Třída

Definice

Obor názvů:

System.Drawing.Drawing2D

Sestavení:

System.Drawing.Common.dll

Balíček:

System.Drawing.Common v8.0.0

Zdroj:

LinearGradientBrush.cs

Zapouzdří objekt Brush lineárním přechodem. Tato třída se nemůže dědit.

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

Dědičnost

Object

MarshalByRefObject

Brush

LinearGradientBrush

Příklady

Následující příklad vytvoří vodorovnou LinearGradientBrush; barevné komponenty se mění lineárně při přechodu z vodorovné souřadnice 0 na vodorovnou souřadnici 200. Například bod, jehož první souřadnice je uprostřed cesty mezi 0 a 200, bude mít modrou komponentu, která je v polovině cesty mezi 0 a 255. Tento příklad je určený pro použití s model Windows Forms. Následující příklad kódu je navržený pro použití s model Windows Forms a vyžaduje PaintEventArgse, což je parametr PaintEventHandler.

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)

Poznámky

Tato třída zapouzdřuje jak dvoubarevné přechody, tak vlastní vícebarevné přechody.

Všechny lineární přechody jsou definovány podél čáry určené buď šířkou obdélníku, nebo dvěma body.

Ve výchozím nastavení je dvoubarevný lineární přechod rovnoměrným vodorovným prolnutím počáteční barvy s koncovou barvou podél zadané čáry. Přizpůsobte vzor prolnutí pomocí Blend třídy, SetSigmaBellShape metod nebo SetBlendTriangularShape metod. Přizpůsobte směr přechodu zadáním výčtu LinearGradientMode nebo úhlu v konstruktoru.

InterpolationColors Pomocí vlastnosti vytvořte vícebarevný přechod.

Vlastnost Transform určuje místní geometrickou transformaci použitou na přechod.

Poznámka

V rozhraní .NET 6 a novějších verzích je balíček System.Drawing.Common, který obsahuje tento typ, podporován pouze v operačních systémech Windows. Použití tohoto typu v multiplatformních aplikacích způsobuje upozornění na kompilaci a výjimky za běhu. Další informace najdete v tématu System.Drawing.Common podporované pouze ve Windows.

Konstruktory

LinearGradientBrush(Point, Point, Color, Color)	Inicializuje novou instanci LinearGradientBrush třídy se zadanými body a barvami.
LinearGradientBrush(PointF, PointF, Color, Color)	Inicializuje novou instanci LinearGradientBrush třídy se zadanými body a barvami.
LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode)	Vytvoří novou instanci LinearGradientBrush třídy na základě obdélníku, počáteční a koncové barvy a orientace.
LinearGradientBrush(Rectangle, Color, Color, Single)	Vytvoří novou instanci LinearGradientBrush třídy na základě obdélníku, počáteční a koncové barvy a úhlu orientace.
LinearGradientBrush(Rectangle, Color, Color, Single, Boolean)	Vytvoří novou instanci LinearGradientBrush třídy na základě obdélníku, počáteční a koncové barvy a úhlu orientace.
LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode)	Vytvoří novou instanci objektu LinearGradientBrush na základě obdélníku, počáteční a koncové barvy a režim orientace.
LinearGradientBrush(RectangleF, Color, Color, Single)	Vytvoří novou instanci LinearGradientBrush třídy na základě obdélníku, počáteční a koncové barvy a úhlu orientace.
LinearGradientBrush(RectangleF, Color, Color, Single, Boolean)	Vytvoří novou instanci LinearGradientBrush třídy na základě obdélníku, počáteční a koncové barvy a úhlu orientace.

Vlastnosti

Blend	Získá nebo nastaví, Blend který určuje pozice a faktory, které definují vlastní falloff pro přechod.
GammaCorrection	Získá nebo nastaví hodnotu označující, zda je pro tuto LinearGradientBrushfunkci povolena korekce gama.
InterpolationColors	Získá nebo nastaví, ColorBlend který definuje vícebarevný lineární přechod.
LinearColors	Získá nebo nastaví počáteční a koncové barvy přechodu.
Rectangle	Získá obdélníkovou oblast, která definuje počáteční a koncové body přechodu.
Transform	Získá nebo nastaví kopii Matrix , která definuje místní geometrické transformace pro tento LinearGradientBrushobjekt .
WrapMode	Získá nebo nastaví WrapMode výčet, který označuje režim zalamování pro tento LinearGradientBrush.

Metody

Clone()	Vytvoří přesnou kopii tohoto LinearGradientBrushobjektu .
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané tímto Brush objektem. (Zděděno od Brush)
Dispose(Boolean)	Uvolní nespravované prostředky používané nástrojem Brush a volitelně uvolní spravované prostředky. (Zděděno od Brush)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
MultiplyTransform(Matrix)	Vynásobí hodnotu Matrix , která představuje místní geometrickou transformaci, LinearGradientBrush o hodnotu určenou Matrix předponou zadaného Matrixobjektu .
MultiplyTransform(Matrix, MatrixOrder)	Vynásobí hodnotu Matrix , která představuje místní geometrické transformace, LinearGradientBrush o hodnotu zadanou Matrix v zadaném pořadí.
ResetTransform()	Transform Obnoví vlastnost na identitu.
RotateTransform(Single)	Otočí místní geometrické transformace o zadanou hodnotu. Tato metoda předpenduje rotaci transformace.
RotateTransform(Single, MatrixOrder)	Otočí místní geometrické transformace o zadanou hodnotu v zadaném pořadí.
ScaleTransform(Single, Single)	Změní měřítko místní geometrické transformace o zadané částky. Tato metoda předpřidá matici škálování k transformaci.
ScaleTransform(Single, Single, MatrixOrder)	Škáluje místní geometrické transformace podle zadaných částek v zadaném pořadí.
SetBlendTriangularShape(Single)	Vytvoří lineární přechod se středovou barvou a lineárním poklesem na jednu barvu na obou koncích.
SetBlendTriangularShape(Single, Single)	Vytvoří lineární přechod se středovou barvou a lineárním poklesem na jednu barvu na obou koncích.
SetNativeBrush(IntPtr)	V odvozené třídě nastaví odkaz na objekt štětce GDI+ . (Zděděno od Brush)
SetSigmaBellShape(Single)	Vytvoří přechodový pokles na základě křivky ve tvaru zvonu.
SetSigmaBellShape(Single, Single)	Vytvoří přechodový pokles na základě křivky ve tvaru zvonu.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TranslateTransform(Single, Single)	Přeloží místní geometrické transformace podle zadaných rozměrů. Tato metoda předpenduje překlad transformace.
TranslateTransform(Single, Single, MatrixOrder)	Přeloží místní geometrické transformace podle zadaných rozměrů v zadaném pořadí.

Viz také

• Postupy: Create lineárního přechodu