LinearGradientBrush LinearGradientBrush LinearGradientBrush LinearGradientBrush Class

Определение

Инкапсулирует объект Brush с линейным градиентом.Encapsulates a Brush with a linear gradient. Этот класс не наследуется.This class cannot be inherited.

public ref class LinearGradientBrush sealed : System::Drawing::Brush
public sealed class LinearGradientBrush : System.Drawing.Brush
type LinearGradientBrush = class
    inherit Brush
Public NotInheritable Class LinearGradientBrush
Inherits Brush
Наследование
LinearGradientBrushLinearGradientBrushLinearGradientBrushLinearGradientBrush

Примеры

В следующем примере создается горизонтального LinearGradientBrush; цветовые компоненты линейно изменяются при переходе из горизонтальную координату 0 горизонтальную координату 200.The following example creates a horizontal LinearGradientBrush; the color components change linearly as you move from a horizontal coordinate of 0 to a horizontal coordinate of 200. Например точки, в которых первая координата на равном расстоянии от 0 до 200 будет иметь синего компонента, который находится на равном расстоянии от 0 до 255.For example, a point whose first coordinate is halfway between 0 and 200 will have a blue component that is halfway between 0 and 255. Этот пример предназначен для работы с Windows Forms.This example is designed for use with Windows Forms. В следующем примере кода предназначен для работы с Windows Forms и требует PaintEventArgs e, который является параметром PaintEventHandler.The following code example is designed for use with Windows Forms, and it requires the PaintEventArgse, which is a parameter of PaintEventHandler.

public void UseHorizontalLinearGradients(PaintEventArgs e)
{
    LinearGradientBrush linGrBrush = new LinearGradientBrush(
       new Point(0, 10),
       new Point(200, 10),
       Color.FromArgb(255, 255, 0, 0),   // Opaque red
       Color.FromArgb(255, 0, 0, 255));  // Opaque blue

    Pen pen = new Pen(linGrBrush);

    e.Graphics.DrawLine(pen, 0, 10, 200, 10);
    e.Graphics.FillEllipse(linGrBrush, 0, 30, 200, 100);
    e.Graphics.FillRectangle(linGrBrush, 0, 155, 500, 30);
}
Dim linGrBrush As New LinearGradientBrush( _
   New Point(0, 10), _
   New Point(200, 10), _
   Color.FromArgb(255, 255, 0, 0), _
   Color.FromArgb(255, 0, 0, 255))
Dim pen As New Pen(linGrBrush)

e.Graphics.DrawLine(pen, 0, 10, 200, 10)
e.Graphics.FillEllipse(linGrBrush, 0, 30, 200, 100)
e.Graphics.FillRectangle(linGrBrush, 0, 155, 500, 30)

Комментарии

Этот класс инкапсулирует двух цветовые градиенты и пользовательские многоцветный градиенты.This class encapsulates both two-color gradients and custom multicolor gradients.

Все линейные градиенты определяются вдоль линии, задается по ширине прямоугольника или две точки.All linear gradients are defined along a line specified either by the width of a rectangle or by two points.

По умолчанию линейный градиент двух цветов — равномерный горизонтальный линейный переход от начального цвета к конечному вдоль указанной строки.By default, a two-color linear gradient is an even horizontal linear blend from the starting color to the ending color along the specified line. Настроить с помощью blend шаблон Blend класс, SetSigmaBellShape методов, или SetBlendTriangularShape методы.Customize the blend pattern using the Blend class, the SetSigmaBellShape methods, or the SetBlendTriangularShape methods. Настроить направление градиента, указав LinearGradientMode перечисления или угол в конструкторе.Customize the direction of the gradient by specifying the LinearGradientMode enumeration or the angle in the constructor.

Используйте InterpolationColors свойство для создания многоцветном градиенте.Use the InterpolationColors property to create a multicolor gradient.

Transform Свойство задает локальное геометрическое преобразование, применяемое к градиенту.The Transform property specifies a local geometric transform applied to the gradient.

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

LinearGradientBrush(Point, Point, Color, Color) LinearGradientBrush(Point, Point, Color, Color) LinearGradientBrush(Point, Point, Color, Color) LinearGradientBrush(Point, Point, Color, Color)

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

LinearGradientBrush(PointF, PointF, Color, Color) LinearGradientBrush(PointF, PointF, Color, Color) LinearGradientBrush(PointF, PointF, Color, Color) LinearGradientBrush(PointF, PointF, Color, Color)

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

LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode) LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode) LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode) LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode)

Создает новый экземпляр класса LinearGradientBrush на основе прямоугольника, начального и конечного цветов, а также ориентации.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and orientation.

LinearGradientBrush(Rectangle, Color, Color, Single) LinearGradientBrush(Rectangle, Color, Color, Single) LinearGradientBrush(Rectangle, Color, Color, Single) LinearGradientBrush(Rectangle, Color, Color, Single)

Создает новый экземпляр класса LinearGradientBrush на основе прямоугольника, начального и конечного цветов, а также угла ориентации.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

LinearGradientBrush(Rectangle, Color, Color, Single, Boolean) LinearGradientBrush(Rectangle, Color, Color, Single, Boolean) LinearGradientBrush(Rectangle, Color, Color, Single, Boolean) LinearGradientBrush(Rectangle, Color, Color, Single, Boolean)

Создает новый экземпляр класса LinearGradientBrush на основе прямоугольника, начального и конечного цветов, а также угла ориентации.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode) LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode) LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode) LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode)

Создает новый экземпляр объекта LinearGradientBrush на основе прямоугольника, начального и конечного цветов, а также режима ориентации.Creates a new instance of the LinearGradientBrush based on a rectangle, starting and ending colors, and an orientation mode.

LinearGradientBrush(RectangleF, Color, Color, Single) LinearGradientBrush(RectangleF, Color, Color, Single) LinearGradientBrush(RectangleF, Color, Color, Single) LinearGradientBrush(RectangleF, Color, Color, Single)

Создает новый экземпляр класса LinearGradientBrush на основе прямоугольника, начального и конечного цветов, а также угла ориентации.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

LinearGradientBrush(RectangleF, Color, Color, Single, Boolean) LinearGradientBrush(RectangleF, Color, Color, Single, Boolean) LinearGradientBrush(RectangleF, Color, Color, Single, Boolean) LinearGradientBrush(RectangleF, Color, Color, Single, Boolean)

Создает новый экземпляр класса LinearGradientBrush на основе прямоугольника, начального и конечного цветов, а также угла ориентации.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

Свойства

Blend Blend Blend Blend

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

GammaCorrection GammaCorrection GammaCorrection GammaCorrection

Получает или задает значение, указывающее, включена ли гамма-коррекция для этого объекта LinearGradientBrush.Gets or sets a value indicating whether gamma correction is enabled for this LinearGradientBrush.

InterpolationColors InterpolationColors InterpolationColors InterpolationColors

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

LinearColors LinearColors LinearColors LinearColors

Получает или задает начальный и конечный цвета градиента.Gets or sets the starting and ending colors of the gradient.

Rectangle Rectangle Rectangle Rectangle

Получает прямоугольную область, которая определяет начальную и конечную точки градиента.Gets a rectangular region that defines the starting and ending points of the gradient.

Transform Transform Transform Transform

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

WrapMode WrapMode WrapMode WrapMode

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

Методы

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

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

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)

Умножает объект Matrix, представляющий локальное геометрическое преобразование объекта LinearGradientBrush, на указанный объект Matrix, добавляя указанный объект Matrix.Multiplies the Matrix that represents the local geometric transform of this LinearGradientBrush by the specified Matrix by prepending the specified Matrix.

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

Умножает объект Matrix, представляющий локальное геометрическое преобразование объекта LinearGradientBrush, на указанный объект Matrix в заданном порядке.Multiplies the Matrix that represents the local geometric transform of this LinearGradientBrush by the specified Matrix in the specified order.

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 linear gradient with a center color and a linear falloff to a single color on both ends.

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

Создает линейный градиент с цветом центра и линейным спадом к одному цвету на обоих концах.Creates a linear gradient with a center color and a linear falloff to a single color on both ends.

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 falloff based on a bell-shaped curve.

SetSigmaBellShape(Single, Single) SetSigmaBellShape(Single, Single) SetSigmaBellShape(Single, Single) SetSigmaBellShape(Single, Single)

Создает градиентный переход, основанный на колоколообразной кривой.Creates a gradient falloff 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)

Выполняет смещение локального геометрического преобразования в заданных измерениях.Translates the local geometric transform by the specified dimensions. Этот метод добавляет сдвиг к преобразованию.This method prepends the translation to the transform.

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

Выполняет смещение локального геометрического преобразования в заданных измерениях и в указанном порядке.Translates the local geometric transform by the specified dimensions in the specified order.

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

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