PathGradientBrush PathGradientBrush PathGradientBrush PathGradientBrush Class

Определение

Инкапсулирует объект 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.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, а скорость изменения оттенка.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(GraphicsPath) PathGradientBrush(GraphicsPath) PathGradientBrush(GraphicsPath)

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

PathGradientBrush(PointF[]) PathGradientBrush(PointF[]) PathGradientBrush(PointF[]) PathGradientBrush(PointF[])

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

PathGradientBrush(PointF[], WrapMode) PathGradientBrush(PointF[], WrapMode) PathGradientBrush(PointF[], WrapMode) PathGradientBrush(PointF[], WrapMode)

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

PathGradientBrush(Point[]) PathGradientBrush(Point[]) PathGradientBrush(Point[]) PathGradientBrush(Point[])

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

PathGradientBrush(Point[], WrapMode) PathGradientBrush(Point[], WrapMode) PathGradientBrush(Point[], WrapMode) PathGradientBrush(Point[], WrapMode)

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

Свойства

Blend Blend Blend Blend

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

CenterColor CenterColor CenterColor CenterColor

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

CenterPoint CenterPoint CenterPoint CenterPoint

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

FocusScales FocusScales FocusScales FocusScales

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

InterpolationColors InterpolationColors InterpolationColors InterpolationColors

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

Rectangle Rectangle Rectangle Rectangle

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

SurroundColors SurroundColors SurroundColors SurroundColors

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

Transform Transform Transform Transform

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

WrapMode WrapMode WrapMode WrapMode

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

Методы

Clone() Clone() Clone() Clone()

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

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

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

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

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

(Inherited from Brush)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

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

(Inherited from Brush)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

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

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

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

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
MultiplyTransform(Matrix) MultiplyTransform(Matrix) MultiplyTransform(Matrix) MultiplyTransform(Matrix)

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

MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder)

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

ResetTransform() ResetTransform() ResetTransform() ResetTransform()

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

RotateTransform(Single) RotateTransform(Single) RotateTransform(Single) RotateTransform(Single)

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

RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder)

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

ScaleTransform(Single, Single) ScaleTransform(Single, Single) ScaleTransform(Single, Single) 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) ScaleTransform(Single, Single, MatrixOrder) ScaleTransform(Single, Single, MatrixOrder) ScaleTransform(Single, Single, MatrixOrder)

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

SetBlendTriangularShape(Single) SetBlendTriangularShape(Single) SetBlendTriangularShape(Single) SetBlendTriangularShape(Single)

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

SetBlendTriangularShape(Single, Single) SetBlendTriangularShape(Single, Single) SetBlendTriangularShape(Single, Single) SetBlendTriangularShape(Single, Single)

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

SetNativeBrush(IntPtr) SetNativeBrush(IntPtr) SetNativeBrush(IntPtr) SetNativeBrush(IntPtr)

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

(Inherited from Brush)
SetSigmaBellShape(Single) SetSigmaBellShape(Single) SetSigmaBellShape(Single) 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) SetSigmaBellShape(Single, Single) SetSigmaBellShape(Single, Single) 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() ToString() ToString() ToString()

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

(Inherited from Object)
TranslateTransform(Single, Single) TranslateTransform(Single, Single) TranslateTransform(Single, Single) TranslateTransform(Single, Single)

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

TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder)

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

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

Дополнительно