System.Drawing Пространство имен

Ссылка

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет доступ к основным графическим функциям GDI+. Пространства System.Drawing.Drawing2Dимен , System.Drawing.Imagingи System.Drawing.Text предоставляют более расширенные функциональные возможности. Ограничения см. в разделе Примечания.

Классы

Bitmap	Инкапсулирует точечный рисунок GDI+, состоящий из данных пикселей графического изображения и атрибутов рисунка. Объект Bitmap используется для работы с изображениями, определяемыми данными пикселей.
BitmapSuffixInSameAssemblyAttribute	Указывает, что при интерпретации объявлений ToolboxBitmapAttribute, сборка должна искать указанные ресурсы во той же сборке, но со значением конфигурации BitmapSuffix добавленным к объявленному имени файла.
BitmapSuffixInSatelliteAssemblyAttribute	Указывает, что при интерпретации объявлений ToolboxBitmapAttribute сборка должна искать указанные ресурсы во вспомогательной сборке, но со значением конфигурации BitmapSuffix, добавленным к объявленному имени файла.
Brush	Определяет объекты, которые используются для заливки внутри графических фигур, таких как прямоугольники, эллипсы, круги, многоугольники и дорожки.
Brushes	Кисти для каждого из стандартных цветов. Этот класс не наследуется.
BufferedGraphics	Предоставляет графический буфер для двойной буферизации.
BufferedGraphicsContext	Предоставляет методы создания графических буферов, которые могут использоваться для двойной буферизации.
BufferedGraphicsManager	Предоставляет доступ к объекту основного контекста буферизованной графики для домена приложения.
ColorConverter	Преобразует цвета одного типа данных в другой. Доступ к данному классу осуществляется с помощью объекта TypeDescriptor.
ColorTranslator	Преобразует цвета в структуры GDI+ Color и из них. Этот класс не наследуется.
Font	Определяет конкретный формат текста, включая начертание шрифта, его размер и атрибуты стиля. Этот класс не наследуется.
FontConverter	Преобразует объекты Font из одного типа данных в другой.
FontConverter.FontNameConverter	FontConverter.FontNameConverter — преобразователь типа, который используется для преобразования имени шрифта в другие различные представления и обратно.
FontConverter.FontUnitConverter	Преобразует единицы шрифта в другие типы единиц и обратно.
FontFamily	Определяет группу гарнитур шрифта со схожим базовым макетом и определенными различиями в стиле. Этот класс не наследуется.
Graphics	Инкапсулирует поверхность рисования GDI+. Этот класс не наследуется.
Icon	Представляет значок Windows, который является точечным рисунком небольшого размера и используется для представления объекта. Значки можно считать прозрачными точечными рисунками, хотя их размер определяется системой.
IconConverter	Преобразует объект Icon из одного типа данных в другой. Доступ к данному классу осуществляется с помощью объекта TypeDescriptor.
Image	Абстрактный базовый класс, который предоставляет функциональные возможности для производных классов Bitmap и Metafile.
ImageAnimator	Анимирует изображение, в котором есть кадры на основе времени.
ImageConverter	ImageConverter — класс, который может использоваться для преобразования объектов Image из одного типа данных в другой тип данных. Доступ к данному классу осуществляется с помощью объекта TypeDescriptor.
ImageFormatConverter	ImageFormatConverter — класс, который может использоваться для преобразования объектов ImageFormat из одного типа данных в другой тип данных. Доступ к данному классу осуществляется с помощью объекта TypeDescriptor.
Pen	Определяет объект, используемый для рисования прямых линий и кривых. Этот класс не наследуется.
Pens	Перья для всех стандартных цветов. Этот класс не наследуется.
PointConverter	Преобразует объект Point из одного типа данных в другой.
RectangleConverter	Преобразует прямоугольники из одного типа данных в другой. Доступ к данному классу осуществляется с помощью объекта TypeDescriptor.
Region	Описывает внутреннюю часть графической формы, состоящей из прямоугольников и контуров. Этот класс не наследуется.
SizeConverter	Класс SizeConverter используется для преобразования одного типа данных в другой. Доступ к данному классу осуществляется с помощью объекта TypeDescriptor.
SizeFConverter	Преобразует объекты SizeF из одного типа в другой.
SolidBrush	Определяет кисть одного цвета. Кисти используются для заливки графических фигур, таких как прямоугольники, эллипсы, круги, многоугольники и контуры. Этот класс не наследуется.
StringFormat	Инкапсулирует сведения о структуре текста (например выравнивание, ориентация и позиции табуляции), операции с отображением (такие как вставка многоточия и замена национальных цифр) и возможности OpenType. Этот класс не наследуется.
SystemBrushes	Каждое из свойств класса SystemBrushes является объектом SolidBrush, который представляет собой цвет элемента изображения Windows.
SystemColors	Каждое свойство класса SystemColors является структурой Color, которая представляет собой цвет элемента изображения Windows.
SystemFonts	Задает шрифты, используемые для отображения текста в графических элементах Windows.
SystemIcons	Каждое свойство класса SystemIcons является объектом Icon для стандартных значков, используемых в системе Windows. Этот класс не наследуется.
SystemPens	Каждое свойство класса SystemPens является объектом Pen, то есть цветом элемента изображения Windows шириной 1 пиксель.
TextureBrush	Каждое свойство класса TextureBrush является объектом Brush, использующим изображение для заливки внутренней части формы. Этот класс не наследуется.
ToolboxBitmapAttribute	Позволяет задать значок для представления элемента управления в контейнере, таком как конструктор форм Microsoft Visual Studio.

Структуры

CharacterRange	Определяет диапазон позиций символа в пределах строки.
Color	Представляет цвета в терминах каналов альфа, красного, зеленого и синего (ARGB).
Point	Представляет упорядоченную пару целых чисел — координат Х и Y, определяющую точку на двумерной плоскости.
PointF	Представляет упорядоченную пару координат Х и Y с плавающей запятой, определяющую точку на двумерной плоскости.
Rectangle	Содержит набор из четырех целых чисел, определяющих расположение и размер прямоугольника.
RectangleF	Содержит набор из четырех чисел с плавающей запятой, определяющих расположение и размер прямоугольника. Для расширения функций области используйте объект Region.
Size	Сохраняет упорядоченную пару целых чисел, указывающих Height и Width.
SizeF	Содержит упорядоченную пару чисел с плавающей запятой, обычно ширину и высоту прямоугольника.

Интерфейсы

IDeviceContext

Определяет методы получения и освобождения существующего дескриптора контекста устройства Windows.

Перечисления

ContentAlignment	Устанавливает выравнивание содержимого на поверхности рисунка.
CopyPixelOperation	Определяет, как цвет источника в операции копирования пикселя объединяется с цветом назначения для получения окончательного цвета.
FontStyle	Задает сведения о стиле, применяемые к тексту.
GraphicsUnit	Задает единицу измерения для заданных данных.
KnownColor	Задает известные системные цвета.
RotateFlipType	Задает величину поворота изображения и ось для зеркального отражения рисунка.
StockIconId	Предоставляет идентификаторы значков для использования с GetStockIcon(StockIconId, StockIconOptions).
StockIconOptions	Предоставляет параметры для использования с GetStockIcon(StockIconId, StockIconOptions).
StringAlignment	Определяет выравнивание строки текста относительно прямоугольника размещения.
StringDigitSubstitute	Перечисление StringDigitSubstitute указывает, как заменять знаки в строке в соответствии с местом проживания или языком пользователя.
StringFormatFlags	Указывает сведения об отображении и размещении строк текста.
StringTrimming	Указывает, как удалить знаки из строки, которая не полностью помещается в форму структуры.
StringUnit	Указывает единицы измерения для строки текста.

Делегаты

Graphics.DrawImageAbort	Предоставляет метод обратного вызова, используемый в случае, когда метод DrawImage должен преждевременно отменить выполнение и прекратить рисование изображения.
Graphics.EnumerateMetafileProc	Предоставляет метод обратного вызова для метода EnumerateMetafile.
Image.GetThumbnailImageAbort	Предоставляет метод обратного вызова, позволяющий определить, когда метод GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr) должен преждевременно прекратить выполнение.

В Windows System.Drawing зависит от собственной библиотеки GDI+, которая поставляется в составе ОС. Некоторые номера SKU Windows, такие как Windows Server Core или Windows Nano, не включают эту собственную библиотеку в составе ОПЕРАЦИОННОй системы. Если вы используете это пространство имен и не удается загрузить библиотеку, во время выполнения будут создаваться исключения.
Некоторые типы в System.Drawing пространстве имен используют GDI+, который не поддерживается в службах Windows, ASP.NET Core и ASP.NET приложениях. Эти типы находятся в пакете NuGet System.Drawing.Common и включают System.Drawing.Bitmap и System.Drawing.Font. Однако примитивные типы в пространстве имен, такие как System.Drawing.Color, System.Drawing.Size, System.Drawing.Pointи System.Drawing.Rectangle, можно использовать в любом приложении.
В .NET 5 и предыдущих версиях пакет NuGet System.Drawing.Common работает в Windows, Linux и macOS. Однако существуют некоторые различия между платформами. В Linux и macOS функциональность GDI+ реализуется библиотекой libgdiplus). Эта библиотека не устанавливается по умолчанию в большинстве дистрибутивов Linux и не поддерживает все функции GDI+ в Windows и macOS. Существуют также платформы, где libgdiplus недоступен вообще. Чтобы использовать типы из пакета System.Drawing.Common в Linux и macOS, необходимо установить libgdiplus отдельно. Дополнительные сведения см. в разделах Установка .NET в Linux или Установка .NET в macOS.
В .NET 6 и более поздних версиях пакет NuGet System.Drawing.Common поддерживается только в операционных системах Windows. Дополнительные сведения см . в статье System.Drawing.Common, поддерживаемая только в Windows.

Если вы не можете использовать System.Drawing с приложением, рекомендуемые варианты: ImageSharp, SkiaSharp, Компоненты образов Windows и Microsoft.Maui.Graphics.

Класс Graphics предоставляет методы для рисования на устройстве отображения. Такие классы, как Rectangle и инкапсулируют Point примитивы GDI+. Класс Pen используется для рисования линий и кривых, а классы, производные от абстрактного класса Brush , используются для заполнения внутренних элементов фигур.

Поделиться через