LinearGradientBrush Класс

Определение

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

Примеры

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

Выполняет смещение локального геометрического преобразования в заданных измерениях и в указанном порядке.

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

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