LinearGradientBrush Класс

Определение

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

System.Drawing.Drawing2D

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v9.0.0-preview.6.24327.6

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

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)	Создает новый экземпляр класса LinearGradientBrush на основе прямоугольника, начального и конечного цветов и угла ориентации.
LinearGradientBrush(Rectangle, Color, Color, Single, Boolean)	Создает новый экземпляр класса LinearGradientBrush на основе прямоугольника, начального и конечного цветов и угла ориентации.
LinearGradientBrush(RectangleF, Color, Color, LinearGradientMode)	Создает новый экземпляр LinearGradientBrush на основе прямоугольника, начального и конечного цветов и режима ориентации.
LinearGradientBrush(RectangleF, Color, Color, Single)	Создает новый экземпляр класса LinearGradientBrush на основе прямоугольника, начального и конечного цветов и угла ориентации.
LinearGradientBrush(RectangleF, Color, Color, Single, Boolean)	Создает новый экземпляр класса LinearGradientBrush на основе прямоугольника, начального и конечного цветов и угла ориентации.

Свойства

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

Методы

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

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

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