LinearGradientBrush Класс

Определение

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

System.Drawing.Drawing2D

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

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

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)	Выполняет смещение локального геометрического преобразования в заданных измерениях и в указанном порядке.

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

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