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) должен преждевременно прекратить выполнение.

Комментарии

Внимание!

Пространство System.Drawing имен имеет некоторые ограничения для определенных операционных систем и типов приложений.

  • В 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 , используются для заполнения внутренних элементов фигур.