PathGradientBrush Класс

Определение

Пространство имен:

System.Drawing.Drawing2D

Сборка:

System.Drawing.Common.dll

Исходный код:

PathGradientBrush.cs

Инкапсулирует Brush объект, заполняющий интерьер GraphicsPath объекта градиентом. Этот класс не может быть унаследован.

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

Наследование

Object

MarshalByRefObject

Brush

PathGradientBrush

Примеры

В следующем примере кода показано, как создать PathGradientBrushобъект. Этот пример предназначен для использования с Windows Forms, и требуется PaintEventArgs e, который является параметром 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)

Комментарии

Градиент цвета — это гладкое заливка цветов из центра пути к внешнему краю пути. Факторы, позиции и стиль смешивания влияют на то, где начинается и заканчивается градиент, а также насколько быстро он изменяет оттенк.

Градиентные кисти пути не подчиняются SmoothingMode свойству объекта, используемого Graphics для выполнения рисунка. Области, заполненные объектом PathGradientBrush , отображаются так же (псевдоним) независимо от режима сглаживания.

Замечание

В .NET 6 и более поздних версиях пакет System.Drawing.Common, который включает этот тип, поддерживается только в операционных системах Windows. Использование этого типа в кроссплатформенных приложениях вызывает предупреждения во время компиляции и исключения во время выполнения. Дополнительные сведения см. в статье System.Drawing.Common, поддерживаемой только в Windows.

Конструкторы

Имя	Описание
PathGradientBrush(GraphicsPath)	Инициализирует новый экземпляр PathGradientBrush класса с указанным путем.
PathGradientBrush(Point[], WrapMode)	Инициализирует новый экземпляр PathGradientBrush класса с указанными точками и режимом оболочки.
PathGradientBrush(Point[])	Инициализирует новый экземпляр PathGradientBrush класса с указанными точками.
PathGradientBrush(PointF[], WrapMode)	Инициализирует новый экземпляр PathGradientBrush класса с указанными точками и режимом оболочки.
PathGradientBrush(PointF[])	Инициализирует новый экземпляр PathGradientBrush класса с указанными точками.
PathGradientBrush(ReadOnlySpan<Point>)	Инициализирует новый экземпляр PathGradientBrush класса с указанными точками.
PathGradientBrush(ReadOnlySpan<PointF>)	Инициализирует новый экземпляр PathGradientBrush класса с указанными точками.
PathGradientBrush(WrapMode, ReadOnlySpan<Point>)	Инициализирует новый экземпляр PathGradientBrush класса с указанными точками и режимом оболочки.
PathGradientBrush(WrapMode, ReadOnlySpan<PointF>)	Инициализирует новый экземпляр PathGradientBrush класса с указанными точками и режимом оболочки.

Свойства

Имя	Описание
Blend	Возвращает или задает позицию Blend и факторы, определяющие настраиваемое отключение для градиента.
CenterColor	Возвращает или задает цвет в центре градиента пути.
CenterPoint	Возвращает или задает центральную точку градиента пути.
FocusScales	Возвращает или задает точку фокуса для градиента.
InterpolationColors	Возвращает или задает объект, определяющий ColorBlend многоцветный линейный градиент.
Rectangle	Получает ограничивающий прямоугольник для этого PathGradientBrush.
SurroundColors	Получает или задает массив цветов, соответствующих точкам в пути, который заполняется PathGradientBrush .
Transform	Получает или задает копию Matrix , которая определяет локальное геометрическое преобразование для этого PathGradientBrush.
WrapMode	Возвращает или задает объект, указывающий WrapMode режим оболочки для этого PathGradientBrush.

Методы

Имя	Описание
Clone()	Создает точную копию этого PathGradientBrushобъекта.
Dispose()	Освобождает все ресурсы, используемые этим Brush объектом. (Унаследовано от Brush)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые Brush и при необходимости освобождает управляемые ресурсы. (Унаследовано от Brush)
MultiplyTransform(Matrix, MatrixOrder)	Обновляет матрицу преобразования кисти с продуктом матрицы преобразования кисти, умноженной на другую матрицу.
MultiplyTransform(Matrix)	Обновляет матрицу преобразования кисти с помощью матрицы преобразования кисти, умноженной на другую матрицу.
ResetTransform()	Сбрасывает свойство на Transform удостоверение.
RotateTransform(Single, MatrixOrder)	Поворот локального геометрического преобразования по указанному количеству в указанном порядке.
RotateTransform(Single)	Поворот локального геометрического преобразования по указанному количеству. Этот метод добавляет поворот к преобразованию.
ScaleTransform(Single, Single, MatrixOrder)	Масштабирует локальное геометрическое преобразование по указанным значениям в указанном порядке.
ScaleTransform(Single, Single)	Масштабирует локальное геометрическое преобразование по указанным значениям. Этот метод добавляет матрицу масштабирования к преобразованию.
SetBlendTriangularShape(Single, Single)	Создает градиент с цветом центра и линейным откатом к каждому окружающему цвету.
SetBlendTriangularShape(Single)	Создает градиент с цветом центра и линейным откатом к одному окружающему цвету.
SetNativeBrush(IntPtr)	В производном классе задает ссылку на объект Кисти GDI+. (Унаследовано от Brush)
SetSigmaBellShape(Single, Single)	Создает градиентную кисть, которая изменяет цвет, начиная с центра пути на границу пути. Переход от одного цвета к другому основан на кривой колокола.
SetSigmaBellShape(Single)	Создает градиентную кисть, которая изменяет цвет, начиная с центра пути на границу пути. Переход от одного цвета к другому основан на кривой колокола.
TranslateTransform(Single, Single, MatrixOrder)	Применяет указанный перевод к локальному геометрическому преобразованию в указанном порядке.
TranslateTransform(Single, Single)	Применяет указанный перевод к локальному геометрическому преобразованию. Этот метод добавляет преобразование в преобразование.

См. также раздел

• Практическое руководство. Создание градиента пути