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; компоненты цвета изменяются линейно при переходе от горизонтальной координаты 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) |
Выполняет смещение локального геометрического преобразования в заданных измерениях и в указанном порядке. |
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по