PathGradientBrush Klasa

Definicja

Przestrzeń nazw:

System.Drawing.Drawing2D

Zestaw:

System.Drawing.Common.dll

Źródło:

PathGradientBrush.cs

Hermetyzuje Brush obiekt, który wypełnia wnętrze GraphicsPath obiektu gradientem. Tej klasy nie można dziedziczyć.

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

Dziedziczenie

Object

MarshalByRefObject

Brush

PathGradientBrush

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć element PathGradientBrush. Ten przykład jest przeznaczony do użycia z formularzami systemu Windows i wymaga parametru PaintEventArgs e, który jest parametrem 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)

Uwagi

Gradient koloru jest gładkim cieniowaniem kolorów z punktu środkowego ścieżki do zewnętrznej krawędzi granicy ścieżki. Czynniki, pozycje i styl mieszania wpływają na miejsce rozpoczęcia i zakończenia gradientu oraz szybkość zmiany cienia.

Pędzle gradientowe ścieżki nie przestrzegają SmoothingMode właściwości Graphics obiektu użytego do wykonania rysunku. Obszary wypełnione za pomocą PathGradientBrush obiektu są renderowane w taki sam sposób (alias) niezależnie od trybu wygładzania.

Uwaga / Notatka

W wersjach .NET 6 i nowszych pakiet System.Drawing.Common, który zawiera ten typ, jest obsługiwany tylko w systemach operacyjnych Windows. Użycie tego typu w aplikacjach międzyplatformowych powoduje ostrzeżenia w czasie kompilacji i wyjątki czasu wykonywania. Aby uzyskać więcej informacji, zobacz System.Drawing.Common supported only on Windows (Obsługiwane tylko w systemie Windows).

Konstruktory

Nazwa	Opis
PathGradientBrush(GraphicsPath)	Inicjuje PathGradientBrush nowe wystąpienie klasy z określoną ścieżką.
PathGradientBrush(Point[], WrapMode)	Inicjuje nowe wystąpienie PathGradientBrush klasy z określonymi punktami i trybem zawijania.
PathGradientBrush(Point[])	Inicjuje PathGradientBrush nowe wystąpienie klasy z określonymi punktami.
PathGradientBrush(PointF[], WrapMode)	Inicjuje nowe wystąpienie PathGradientBrush klasy z określonymi punktami i trybem zawijania.
PathGradientBrush(PointF[])	Inicjuje PathGradientBrush nowe wystąpienie klasy z określonymi punktami.
PathGradientBrush(ReadOnlySpan<Point>)	Inicjuje PathGradientBrush nowe wystąpienie klasy z określonymi punktami.
PathGradientBrush(ReadOnlySpan<PointF>)	Inicjuje PathGradientBrush nowe wystąpienie klasy z określonymi punktami.
PathGradientBrush(WrapMode, ReadOnlySpan<Point>)	Inicjuje nowe wystąpienie PathGradientBrush klasy z określonymi punktami i trybem zawijania.
PathGradientBrush(WrapMode, ReadOnlySpan<PointF>)	Inicjuje nowe wystąpienie PathGradientBrush klasy z określonymi punktami i trybem zawijania.

Właściwości

Nazwa	Opis
Blend	Pobiera lub ustawia Blend element określający pozycje i czynniki definiujące niestandardowy spadek gradientu.
CenterColor	Pobiera lub ustawia kolor w środku gradientu ścieżki.
CenterPoint	Pobiera lub ustawia punkt środkowy gradientu ścieżki.
FocusScales	Pobiera lub ustawia punkt koncentracji uwagi dla spadku gradientu.
InterpolationColors	Pobiera lub ustawia ColorBlend element definiujący gradient liniowy wielobarwny.
Rectangle	Pobiera prostokąt ograniczenia dla tego PathGradientBrushelementu .
SurroundColors	Pobiera lub ustawia tablicę kolorów odpowiadających punktom w ścieżce, PathGradientBrush która wypełnia.
Transform	Pobiera lub ustawia kopię Matrix obiektu definiującą lokalną transformację geometryczną dla tego PathGradientBrushelementu .
WrapMode	Pobiera lub ustawia WrapMode wartość wskazującą tryb zawijania dla tego elementu PathGradientBrush.

Metody

Nazwa	Opis
Clone()	Tworzy dokładną kopię tego elementu PathGradientBrush.
Dispose()	Zwalnia wszystkie zasoby używane przez ten Brush obiekt. (Odziedziczone po Brush)
Dispose(Boolean)	Zwalnia niezarządzane zasoby używane przez Brush program i opcjonalnie zwalnia zarządzane zasoby. (Odziedziczone po Brush)
MultiplyTransform(Matrix, MatrixOrder)	Aktualizuje macierz przekształcania pędzla za pomocą produktu macierzy przekształcania pędzla pomnożonej przez inną macierz.
MultiplyTransform(Matrix)	Aktualizuje macierz przekształceń pędzla za pomocą produktu macierzy transformacji pędzla pomnożonej przez inną macierz.
ResetTransform()	Resetuje Transform właściwość do tożsamości.
RotateTransform(Single, MatrixOrder)	Obraca lokalną transformację geometryczną o określoną kwotę w określonej kolejności.
RotateTransform(Single)	Obraca lokalną transformację geometryczną o określoną kwotę. Ta metoda poprzedza rotację do przekształcenia.
ScaleTransform(Single, Single, MatrixOrder)	Skaluje lokalną transformację geometryczną według określonych kwot w określonej kolejności.
ScaleTransform(Single, Single)	Skaluje lokalną transformację geometryczną według określonych kwot. Ta metoda poprzedza macierz skalowania do przekształcenia.
SetBlendTriangularShape(Single, Single)	Tworzy gradient z kolorem środkowym i spadkiem liniowym do każdego otaczającego koloru.
SetBlendTriangularShape(Single)	Tworzy gradient z kolorem środkowym i odejmem liniowym do jednego otaczającego koloru.
SetNativeBrush(IntPtr)	W klasie pochodnej ustawia odwołanie do obiektu pędzla GDI+ . (Odziedziczone po Brush)
SetSigmaBellShape(Single, Single)	Tworzy szczotkę gradientową, która zmienia kolor rozpoczynający się od środka ścieżki na zewnątrz do granicy ścieżki. Przejście z jednego koloru do drugiego opiera się na krzywej w kształcie dzwonu.
SetSigmaBellShape(Single)	Tworzy szczotkę gradientową, która zmienia kolor rozpoczynający się od środka ścieżki na zewnątrz do granicy ścieżki. Przejście z jednego koloru do drugiego opiera się na krzywej w kształcie dzwonu.
TranslateTransform(Single, Single, MatrixOrder)	Stosuje określone tłumaczenie do lokalnej transformacji geometrycznej w określonej kolejności.
TranslateTransform(Single, Single)	Stosuje określone tłumaczenie do lokalnej transformacji geometrycznej. Ta metoda poprzedza tłumaczenie przekształcenia.

Zobacz też

• Instrukcje: tworzenie gradientu ścieżki