LinearGradientBrush Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инкапсулирует Brush с линейным градиентом. Этот класс не может быть унаследован.
public ref class LinearGradientBrush sealed : System::Drawing::Brushpublic sealed class LinearGradientBrush : System.Drawing.Brushtype LinearGradientBrush = class
inherit BrushPublic NotInheritable Class LinearGradientBrush
Inherits Brush- Наследование
Примеры
В следующем примере создается горизонтальная 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 и более поздних версияхпакет
Конструкторы
| 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) |
Преобразует локальное геометрическое преобразование указанными измерениями в указанном порядке. |
