PathGradientBrush Класс

Определение

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

System.Drawing.Drawing2D

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

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

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[])	Инициализирует новый экземпляр класса PathGradientBrush с указанными точками.
PathGradientBrush(Point[], WrapMode)	Инициализирует новый экземпляр класса PathGradientBrush с указанными точками и режимом переноса.
PathGradientBrush(PointF[])	Инициализирует новый экземпляр класса PathGradientBrush с указанными точками.
PathGradientBrush(PointF[], WrapMode)	Инициализирует новый экземпляр класса PathGradientBrush с указанными точками и режимом переноса.

Свойства

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

Методы

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

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

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