PathGradientBrush Klasa

Definicja

Przestrzeń nazw:

System.Drawing.Drawing2D

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Źródło:

PathGradientBrush.cs

Hermetyzuje Brush obiekt, który wypełnia wnętrze GraphicsPath obiektu gradientem. Klasa ta nie może być dziedziczona.

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 Windows Forms i wymaga 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 to gładkie cieniowanie kolorów od punktu środkowego ścieżki do zewnętrznej krawędzi granicy ścieżki. Czynniki mieszane, pozycje i styl wpływają na miejsce rozpoczęcia i zakończenia gradientu oraz szybkość zmiany cienia.

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

Uwaga

W programie .NET 6 i nowszych wersjach pakiet System.Drawing.Common, który obejmuje 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 only supported on Windows (Obsługiwane tylko w systemie Windows).

Konstruktory

PathGradientBrush(GraphicsPath)	Inicjuje PathGradientBrush nowe wystąpienie klasy przy użyciu określonej ścieżki.
PathGradientBrush(Point[])	Inicjuje PathGradientBrush nowe wystąpienie klasy z określonymi punktami.
PathGradientBrush(Point[], WrapMode)	Inicjuje PathGradientBrush nowe wystąpienie klasy z określonymi punktami i trybem zawijania.
PathGradientBrush(PointF[])	Inicjuje PathGradientBrush nowe wystąpienie klasy z określonymi punktami.
PathGradientBrush(PointF[], WrapMode)	Inicjuje PathGradientBrush nowe wystąpienie klasy z określonymi punktami i trybem zawijania.

Właściwości

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 PathGradientBrush.
SurroundColors	Pobiera lub ustawia tablicę kolorów odpowiadających punktom w ścieżce, która PathGradientBrush wypełnia.
Transform	Pobiera lub ustawia kopię Matrix obiektu definiującą lokalną transformację geometryczną dla tego elementu PathGradientBrush.
WrapMode	Pobiera lub ustawia WrapMode wartość wskazującą tryb zawijania dla tego PathGradientBrushelementu .

Metody

Clone()	Tworzy dokładną kopię tego elementu PathGradientBrush.
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszystkie zasoby używane przez ten Brush obiekt. (Odziedziczone po Brush)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element Brush i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po Brush)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
MultiplyTransform(Matrix)	Aktualizacje macierz przekształceń pędzla z produktem macierzy transformacji pędzla pomnożonego przez inną macierz.
MultiplyTransform(Matrix, MatrixOrder)	Aktualizacje macierz przekształceń pędzla z iloczynem macierzy transformacji pędzla pomnożonej przez inną macierz.
ResetTransform()	Resetuje Transform właściwość do tożsamości.
RotateTransform(Single)	Obraca lokalną transformację geometryczną o określoną kwotę. Ta metoda poprzedza rotację przekształcenia.
RotateTransform(Single, MatrixOrder)	Obraca lokalną transformację geometryczną o określoną 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.
ScaleTransform(Single, Single, MatrixOrder)	Skaluje lokalną transformację geometryczną według określonych kwot w określonej kolejności.
SetBlendTriangularShape(Single)	Tworzy gradient z kolorem środkowym i liniowym spadkiem do jednego otaczającego koloru.
SetBlendTriangularShape(Single, Single)	Tworzy gradient z kolorem środkowym i odejmem liniowym do każdego otaczającego koloru.
SetNativeBrush(IntPtr)	W klasie pochodnej ustawia odwołanie do obiektu pędzla GDI+. (Odziedziczone po Brush)
SetSigmaBellShape(Single)	Tworzy pędzel gradientowy, który 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, Single)	Tworzy pędzel gradientowy, który 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.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TranslateTransform(Single, Single)	Stosuje określone tłumaczenie do lokalnej transformacji geometrycznej. Ta metoda poprzedza tłumaczenie przekształcenia.
TranslateTransform(Single, Single, MatrixOrder)	Stosuje określone tłumaczenie do lokalnego przekształcenia geometrycznego w określonej kolejności.

Zobacz też

• Instrukcje: Twórca gradientu ścieżki