LinearGradientBrush Класс

Определение

Инкапсулирует объект 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
Наследование
LinearGradientBrush

Примеры

В следующем примере создается горизонтальная ориентация 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 с указанными точками и цветами.Initializes a new instance of the LinearGradientBrush class with the specified points and colors.

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 на основе прямоугольника, начального и конечного цветов, а также ориентации.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and orientation.

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 на основе прямоугольника, начального и конечного цветов, а также угла ориентации.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 на основе прямоугольника, начального и конечного цветов, а также режима ориентации.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 на основе прямоугольника, начального и конечного цветов, а также угла ориентации.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 на основе прямоугольника, начального и конечного цветов, а также угла ориентации.Creates a new instance of the LinearGradientBrush class based on a rectangle, starting and ending colors, and an orientation angle.

Свойства

Blend

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

GammaCorrection

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

InterpolationColors

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

LinearColors

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

Rectangle

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

Transform

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

WrapMode

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

Методы

Clone()

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

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)

Умножает объект 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)

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

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

SetBlendTriangularShape(Single, Single)

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

SetNativeBrush(IntPtr)

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

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

Создает градиентный переход, основанный на колоколообразной кривой.Creates a gradient falloff based on a bell-shaped curve.

SetSigmaBellShape(Single, Single)

Создает градиентный переход, основанный на колоколообразной кривой.Creates a gradient falloff based on a bell-shaped curve.

ToString()

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

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

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

TranslateTransform(Single, Single, MatrixOrder)

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

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

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