PathGradientBrush Класс

Определение

Инкапсулирует объект Brush, заполняющий градиентом внутреннюю область объекта GraphicsPath.Encapsulates a Brush object that fills the interior of a GraphicsPath object with a gradient. Этот класс не наследуется.This class cannot be inherited.

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
Наследование
PathGradientBrush

Примеры

В следующем примере кода показано, как создать PathGradientBrush .The following code example shows how to create a PathGradientBrush. Этот пример предназначен для использования с Windows Forms, и для него требуется PaintEventArgs e, который является параметром PaintEventHandler .This example is designed for use with Windows Forms, and it requires the PaintEventArgs e, which is a parameter of 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)

Комментарии

Цветовой градиент — это плавное затенение цветов от центральной точки контура до границ внешней границы пути.The color gradient is a smooth shading of colors from the center point of the path to the outside boundary edge of the path. Коэффициенты смешения, положения и стиль влияют на то, где начинается и заканчивается градиент, и как быстро изменяется заливка.Blend factors, positions, and style affect where the gradient starts and ends, and how fast it changes shade.

Кисти градиента пути не подчиняются SmoothingMode свойству Graphics объекта, используемого для рисования.Path gradient brushes do not obey the SmoothingMode property of the Graphics object used to do the drawing. Области, заполненные с помощью PathGradientBrush объекта, выводятся таким же образом (псевдонимы) независимо от режима сглаживания.Areas filled using a PathGradientBrush object are rendered the same way (aliased) regardless of the smoothing mode.

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

PathGradientBrush(GraphicsPath)

Инициализирует новый экземпляр класса PathGradientBrush с указанным контуром.Initializes a new instance of the PathGradientBrush class with the specified path.

PathGradientBrush(Point[])

Инициализирует новый экземпляр класса PathGradientBrush с указанными точками.Initializes a new instance of the PathGradientBrush class with the specified points.

PathGradientBrush(Point[], WrapMode)

Инициализирует новый экземпляр класса PathGradientBrush с указанными точками и режимом переноса.Initializes a new instance of the PathGradientBrush class with the specified points and wrap mode.

PathGradientBrush(PointF[])

Инициализирует новый экземпляр класса PathGradientBrush с указанными точками.Initializes a new instance of the PathGradientBrush class with the specified points.

PathGradientBrush(PointF[], WrapMode)

Инициализирует новый экземпляр класса PathGradientBrush с указанными точками и режимом переноса.Initializes a new instance of the PathGradientBrush class with the specified points and wrap mode.

Свойства

Blend

Получает или задает объект Blend, определяющий позиции и коэффициенты, задающие настраиваемый спад для градиента.Gets or sets a Blend that specifies positions and factors that define a custom falloff for the gradient.

CenterColor

Получает или задает цвет в центре градиента контура.Gets or sets the color at the center of the path gradient.

CenterPoint

Получает или задает центральную точку градиента контура.Gets or sets the center point of the path gradient.

FocusScales

Получает или задает точку фокуса для градиентного перехода.Gets or sets the focus point for the gradient falloff.

InterpolationColors

Получает или задает объект ColorBlend, определяющий многоцветный линейный градиент.Gets or sets a ColorBlend that defines a multicolor linear gradient.

Rectangle

Получает ограничивающий прямоугольник для этого объекта PathGradientBrush.Gets a bounding rectangle for this PathGradientBrush.

SurroundColors

Получает или задает массив цветов, соответствующих точкам контура, заполняемого объектом PathGradientBrush.Gets or sets an array of colors that correspond to the points in the path this PathGradientBrush fills.

Transform

Получает или задает копию объекта Matrix, определяющего локальное геометрическое преобразование для этого объекта PathGradientBrush.Gets or sets a copy of the Matrix that defines a local geometric transform for this PathGradientBrush.

WrapMode

Получает или задает объект WrapMode, определяющий режим переноса для этого объекта PathGradientBrush.Gets or sets a WrapMode that indicates the wrap mode for this PathGradientBrush.

Методы

Clone()

Создает точную копию данного объекта PathGradientBrush.Creates an exact copy of this PathGradientBrush.

CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Унаследовано от MarshalByRefObject)
Dispose()

Освобождает все ресурсы, используемые этим объектом Brush.Releases all resources used by this Brush object.

(Унаследовано от Brush)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом Brush, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the Brush and optionally releases the managed resources.

(Унаследовано от Brush)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Унаследовано от MarshalByRefObject)
MultiplyTransform(Matrix)

Обновляет матрицу преобразования кисти с использованием произведения матрицы преобразования кисти и другой матрицы.Updates the brush's transformation matrix with the product of brush's transformation matrix multiplied by another matrix.

MultiplyTransform(Matrix, MatrixOrder)

Обновляет матрицу преобразования кисти с использованием произведения матрицы преобразования кисти и другой матрицы.Updates the brush's transformation matrix with the product of the brush's transformation matrix multiplied by another matrix.

ResetTransform()

Возвращает свойству Transform единичное значение.Resets the Transform property to identity.

RotateTransform(Single)

Поворачивает локальное геометрическое преобразование на заданную величину.Rotates the local geometric transform by the specified amount. Этот метод добавляет поворот к преобразованию.This method prepends the rotation to the transform.

RotateTransform(Single, MatrixOrder)

Поворачивает локальное геометрическое преобразование на указанную величину в заданном порядке.Rotates the local geometric transform by the specified amount in the specified order.

ScaleTransform(Single, Single)

Масштабирует локальное геометрическое преобразование на заданные величины.Scales the local geometric transform by the specified amounts. Этот метод добавляет в преобразование масштабирующую матрицу.This method prepends the scaling matrix to the transform.

ScaleTransform(Single, Single, MatrixOrder)

Масштабирует локальное геометрическое преобразование на заданные величины в указанном порядке.Scales the local geometric transform by the specified amounts in the specified order.

SetBlendTriangularShape(Single)

Создает градиент с цветом центра и линейным переходом к одному окружающему цвету.Creates a gradient with a center color and a linear falloff to one surrounding color.

SetBlendTriangularShape(Single, Single)

Создает градиент с цветом центра и линейным переходом к каждому из окружающих цветов.Creates a gradient with a center color and a linear falloff to each surrounding color.

SetNativeBrush(IntPtr)

В производном классе определяет ссылку на объект-кисть GDI+GDI+.In a derived class, sets a reference to a GDI+GDI+ brush object.

(Унаследовано от Brush)
SetSigmaBellShape(Single)

Создает градиентную кисть, которая изменяет цвет, начиная с центра контура, и заканчивая границей контура.Creates a gradient brush that changes color starting from the center of the path outward to the path's boundary. Переход от одного цвета к другому выполняется на основе колоколообразной кривой.The transition from one color to another is based on a bell-shaped curve.

SetSigmaBellShape(Single, Single)

Создает градиентную кисть, которая изменяет цвет, начиная с центра контура, и заканчивая границей контура.Creates a gradient brush that changes color starting from the center of the path outward to the path's boundary. Переход от одного цвета к другому выполняется на основе колоколообразной кривой.The transition from one color to another is based on a bell-shaped curve.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
TranslateTransform(Single, Single)

Применяет указанный сдвиг к локальному геометрическому преобразованию.Applies the specified translation to the local geometric transform. Этот метод добавляет сдвиг к преобразованию.This method prepends the translation to the transform.

TranslateTransform(Single, Single, MatrixOrder)

Применяет указанный сдвиг к локальному геометрическому преобразованию в заданном порядке.Applies the specified translation to the local geometric transform in the specified order.

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

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