PathGradientBrush Класс

Ссылка

Определение

Пространство имен:: System.Drawing.Drawing2D

Сборка:: System.Drawing.Common.dll

Сборка:: System.Drawing.dll

Пакет:: System.Drawing.Common v6.0.0

Пакет:: System.Drawing.Common v7.0.0

Пакет:: System.Drawing.Common v8.0.0

Пакет:: System.Drawing.Common v9.0.0-preview.2.24128.3

Исходный код:: PathGradientBrush.cs

Исходный код:: PathGradientBrush.cs

Исходный код:: 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)	Применяет указанный сдвиг к локальному геометрическому преобразованию в заданном порядке.

Применяется к

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

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