LinearGradientBrush Класс

Определение

Пространство имен:

System.Drawing.Drawing2D

Сборка:

System.Drawing.Common.dll

Исходный код:

LinearGradientBrush.cs

Инкапсулирует объект Brush с линейным градиентом. Этот класс не может быть унаследован.

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

Наследование

Object

MarshalByRefObject

Brush

LinearGradientBrush

Примеры

В следующем примере создается горизонтальное значение; компоненты цвета изменяются линейно при переходе от горизонтальной LinearGradientBrushкоординаты от 0 до горизонтальной координаты 200. Например, точка, первая координата которой находится на полпути между 0 и 200, будет иметь синий компонент, который находится на полпути от 0 до 255. Этот пример предназначен для использования с Windows Forms. Следующий пример кода предназначен для использования с Windows Forms и требуется PaintEventArgseпараметр .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)

Комментарии

Этот класс инкапсулирует двухцветные градиенты и пользовательские многоцветные градиенты.

Все линейные градиенты определяются вдоль линии, указанной шириной прямоугольника или двумя точками.

По умолчанию двухцветный линейный градиент — это даже горизонтальная линейная смесь от начального цвета до конечного цвета вдоль указанной линии. Настройте шаблон смешения с помощью Blend класса, SetSigmaBellShape методов или SetBlendTriangularShape методов. Настройте направление градиента, указав LinearGradientMode перечисление или угол в конструкторе.

InterpolationColors Используйте свойство для создания многоцветного градиента.

Свойство Transform задает локальное геометрическое преобразование, примененное к градиенту.

Заметка

В .NET 6 и более поздних версиях пакет System.Drawing.Common, который включает этот тип, поддерживается только в операционных системах Windows. Использование этого типа в кроссплатформенных приложениях вызывает предупреждения во время компиляции и исключения во время выполнения. Дополнительные сведения см. в статье System.Drawing.Common, поддерживаемой только в Windows.

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

Имя	Описание
LinearGradientBrush(Point, Point, Color, Color)	Инициализирует новый экземпляр LinearGradientBrush класса с указанными точками и цветами.
LinearGradientBrush(PointF, PointF, Color, Color)	Инициализирует новый экземпляр LinearGradientBrush класса с указанными точками и цветами.
LinearGradientBrush(Rectangle, Color, Color, LinearGradientMode)	Создает новый экземпляр класса на основе прямоугольника, начального и конечного LinearGradientBrush цветов и ориентации.
LinearGradientBrush(Rectangle, Color, Color, Single, Boolean)	Создает новый экземпляр класса на основе прямоугольника, начального и конечного LinearGradientBrush цветов и угла ориентации.
LinearGradientBrush(Rectangle, Color, Color, Single)	Создает новый экземпляр класса на основе прямоугольника, начального и конечного LinearGradientBrush цветов и угла ориентации.
LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode)	Создает новый экземпляр LinearGradientBrush на основе прямоугольника, начального и конечного цветов, а также режима ориентации.
LinearGradientBrush(RectangleF, Color, Color, Single, Boolean)	Создает новый экземпляр класса на основе прямоугольника, начального и конечного LinearGradientBrush цветов и угла ориентации.
LinearGradientBrush(RectangleF, Color, Color, Single)	Создает новый экземпляр класса на основе прямоугольника, начального и конечного LinearGradientBrush цветов и угла ориентации.

Свойства

Имя	Описание
Blend	Возвращает или задает позицию Blend и факторы, определяющие настраиваемое отключение для градиента.
GammaCorrection	Возвращает или задает значение, указывающее, включена ли для этого LinearGradientBrushгамма-коррекция.
InterpolationColors	Возвращает или задает объект, определяющий ColorBlend многоцветный линейный градиент.
LinearColors	Возвращает или задает начальные и конечные цвета градиента.
Rectangle	Возвращает прямоугольную область, которая определяет начальные и конечные точки градиента.
Transform	Получает или задает копию Matrix , которая определяет локальное геометрическое преобразование для этого LinearGradientBrush.
WrapMode	Возвращает или задает перечисление WrapMode , указывающее режим оболочки для этого LinearGradientBrush.

Методы

Имя	Описание
Clone()	Создает точную копию этого LinearGradientBrushобъекта.
Dispose()	Освобождает все ресурсы, используемые этим Brush объектом. (Унаследовано от Brush)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые Brush и при необходимости освобождает управляемые ресурсы. (Унаследовано от Brush)
MultiplyTransform(Matrix, MatrixOrder)	Умножает Matrix значение, представляющее локальное геометрическое преобразование этого LinearGradientBrush на указанный Matrix в указанном порядке.
MultiplyTransform(Matrix)	Умножает Matrix значение, представляющее локальное геометрическое преобразование этого LinearGradientBrush , за счет заданного Matrix путем предустановки указанного Matrix.
ResetTransform()	Сбрасывает свойство на Transform удостоверение.
RotateTransform(Single, MatrixOrder)	Поворот локального геометрического преобразования по указанному количеству в указанном порядке.
RotateTransform(Single)	Поворот локального геометрического преобразования по указанному количеству. Этот метод добавляет поворот к преобразованию.
ScaleTransform(Single, Single, MatrixOrder)	Масштабирует локальное геометрическое преобразование по указанным значениям в указанном порядке.
ScaleTransform(Single, Single)	Масштабирует локальное геометрическое преобразование по указанным значениям. Этот метод добавляет матрицу масштабирования к преобразованию.
SetBlendTriangularShape(Single, Single)	Создает линейный градиент с цветом центра и линейным откатом к одному цвету на обоих концах.
SetBlendTriangularShape(Single)	Создает линейный градиент с цветом центра и линейным откатом к одному цвету на обоих концах.
SetNativeBrush(IntPtr)	В производном классе задает ссылку на объект Кисти GDI+. (Унаследовано от Brush)
SetSigmaBellShape(Single, Single)	Создает градиентное падение на основе кривой колокола.
SetSigmaBellShape(Single)	Создает градиентное падение на основе кривой колокола.
TranslateTransform(Single, Single, MatrixOrder)	Преобразует локальное геометрическое преобразование указанными измерениями в указанном порядке.
TranslateTransform(Single, Single)	Преобразует локальное геометрическое преобразование указанными измерениями. Этот метод добавляет преобразование в преобразование.

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

• Практическое руководство. Создание линейного градиента