PathGradientBrush Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инкапсулирует объект Brush, заполняющий градиентом внутреннюю область объекта GraphicsPath. Этот класс не наследуется.
public ref class PathGradientBrush sealed : System::Drawing::Brushpublic sealed class PathGradientBrush : System.Drawing.Brushtype PathGradientBrush = class
inherit BrushPublic NotInheritable Class PathGradientBrush
Inherits Brush- Наследование
Примеры
В следующем примере кода показано, как создать .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) |
Применяет указанный сдвиг к локальному геометрическому преобразованию в заданном порядке. |
