PathGradientBrush Třída

Definice

Obor názvů:

System.Drawing.Drawing2D

Sestavení:

System.Drawing.Common.dll

Zdroj:

PathGradientBrush.cs

Zapouzdřuje Brush objekt, který vyplní vnitřní část GraphicsPath objektu přechodem. Tuto třídu nelze zdědit.

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

Dědičnost

Object

MarshalByRefObject

Brush

PathGradientBrush

Příklady

Následující příklad kódu ukazuje, jak vytvořit PathGradientBrush. Tento příklad je určen pro použití s Windows Forms a vyžaduje PaintEventArgs e, což je parametr 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)

Poznámky

Barevný přechod je hladké stínování barev od středu cesty k vnějšímu hraničnímu okraji cesty. Faktory, pozice a styl prolnutí ovlivňují, kde přechod začíná a končí a jak rychle se změní odstín.

Přechodové štětce cesty neposlouchají SmoothingMode vlastnost objektu Graphics použitého k vykreslení. Oblasti vyplněné objektem PathGradientBrush se vykreslují stejným způsobem (aliasované) bez ohledu na režim vyhlazování.

Poznámka:

V .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í v době kompilace a výjimky za běhu. Další informace naleznete v tématu System.Drawing.Common podporován pouze ve Windows.

Konstruktory

Name	Description
PathGradientBrush(GraphicsPath)	Inicializuje novou instanci PathGradientBrush třídy se zadanou cestou.
PathGradientBrush(Point[], WrapMode)	Inicializuje novou instanci PathGradientBrush třídy se zadanými body a režim zabalení.
PathGradientBrush(Point[])	Inicializuje novou instanci PathGradientBrush třídy se zadanými body.
PathGradientBrush(PointF[], WrapMode)	Inicializuje novou instanci PathGradientBrush třídy se zadanými body a režim zabalení.
PathGradientBrush(PointF[])	Inicializuje novou instanci PathGradientBrush třídy se zadanými body.
PathGradientBrush(ReadOnlySpan<Point>)	Inicializuje novou instanci PathGradientBrush třídy se zadanými body.
PathGradientBrush(ReadOnlySpan<PointF>)	Inicializuje novou instanci PathGradientBrush třídy se zadanými body.
PathGradientBrush(WrapMode, ReadOnlySpan<Point>)	Inicializuje novou instanci PathGradientBrush třídy se zadanými body a režim zabalení.
PathGradientBrush(WrapMode, ReadOnlySpan<PointF>)	Inicializuje novou instanci PathGradientBrush třídy se zadanými body a režim zabalení.

Vlastnosti

Name	Description
Blend	Získá nebo nastaví Blend , který určuje pozice a faktory, které definují vlastní pád přechodu.
CenterColor	Získá nebo nastaví barvu uprostřed přechodu cesty.
CenterPoint	Získá nebo nastaví středový bod přechodu cesty.
FocusScales	Získá nebo nastaví bod fokusu pro přechodový přechod.
InterpolationColors	Získá nebo nastaví ColorBlend , který definuje vícebarevný lineární přechod.
Rectangle	Získá ohraničující obdélník pro tento PathGradientBrush.
SurroundColors	Získá nebo nastaví pole barev, které odpovídají bodům v cestě, která tato PathGradientBrush výplň.
Transform	Získá nebo nastaví kopii Matrix , která definuje místní geometrické transformace pro toto PathGradientBrush.
WrapMode	Získá nebo nastaví WrapMode , který označuje režim zabalení pro toto PathGradientBrush.

Metody

Name	Description
Clone()	Vytvoří přesnou kopii tohoto PathGradientBrushsouboru .
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é Brush a volitelně uvolní spravované prostředky. (Zděděno od Brush)
MultiplyTransform(Matrix, MatrixOrder)	Aktualizuje transformační matici štětce pomocí součinu transformační matice štětce vynásobenou jinou maticí.
MultiplyTransform(Matrix)	Aktualizuje transformační matici štětce pomocí matice transformace štětce vynásobenou jinou maticí.
ResetTransform()	Transform Obnoví vlastnost na identitu.
RotateTransform(Single, MatrixOrder)	Otočí místní geometrické transformace o zadanou hodnotu v zadaném pořadí.
RotateTransform(Single)	Otočí místní geometrické transformace o zadanou hodnotu. Tato metoda předpenpenduje otočení na transformaci.
ScaleTransform(Single, Single, MatrixOrder)	Škáluje místní geometrické transformace podle zadaných částek v zadaném pořadí.
ScaleTransform(Single, Single)	Škáluje místní geometrické transformace podle zadaných částek. Tato metoda předpíná matici škálování na transformaci.
SetBlendTriangularShape(Single, Single)	Vytvoří přechod se středovou barvou a lineárním přechodem na každou okolní barvu.
SetBlendTriangularShape(Single)	Vytvoří přechod se středovou barvou a lineárním přechodem na jednu okolní barvu.
SetNativeBrush(IntPtr)	V odvozené třídě nastaví odkaz na objekt štětce GDI+ . (Zděděno od Brush)
SetSigmaBellShape(Single, Single)	Vytvoří přechodový štětec, který změní barvu od středu cesty směrem ven na hranici cesty. Přechod z jedné barvy na jinou je založen na křivkě tvaru zvonu.
SetSigmaBellShape(Single)	Vytvoří přechodový štětec, který změní barvu od středu cesty směrem ven na hranici cesty. Přechod z jedné barvy na jinou je založen na křivkě tvaru zvonu.
TranslateTransform(Single, Single, MatrixOrder)	Použije zadaný překlad na místní geometrické transformace v zadaném pořadí.
TranslateTransform(Single, Single)	Použije zadaný překlad na místní geometrické transformace. Tato metoda předloží překlad na transformaci.

Viz také

• Postupy: Vytvoření přechodu cesty