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

Представляет упорядоченную пару целочисленных координат x-и y, которая определяет точку в двухмерной плоскости.

PointF

Представляет упорядоченную пару с плавающей запятой x-и y-координат, которая определяет точку в двухмерной плоскости.

Rectangle

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

RectangleF

Хранит набор из четырех чисел с плавающей запятой, представляющих расположение и размер прямоугольника. Для более сложных функций региона используйте объект Region.

Size

Хранит упорядоченную пару целых чисел, которые указывают Height и Width.

SizeF

Хранит упорядоченную пару чисел с плавающей запятой, как правило, ширину и высоту прямоугольника.

Интерфейсы

Имя Описание
IDeviceContext

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

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

Имя Описание
ContentAlignment

Указывает выравнивание содержимого на поверхности рисования.

CopyPixelOperation

Определяет, как исходный цвет в операции копирования пикселей сочетается с целевым цветом, чтобы привести к окончательному цвету.

FontStyle

Указывает сведения о стиле, примененные к тексту.

GraphicsUnit

Задает единицу измерения для заданных данных.

KnownColor

Задает известные системные цвета.

RotateFlipType

Указывает, сколько повернуто изображение и ось, используемая для перевернутого изображения.

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+, которая поставляется в составе ОС. Некоторые Windows номера SKU, такие как 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.PointSystem.Drawing.Sizeи System.Drawing.Rectangle, можно использовать в любом приложении.

  • В .NET 5 и предыдущих версиях пакет NuGet < >System.Drawing.Common пакет NuGet работает на Windows, Linux и macOS. Однако существуют некоторые различия платформы. В Linux и macOS функция GDI+ реализована библиотекой libgdiplus . Эта библиотека не устанавливается по умолчанию в большинстве дистрибутивов Linux и не поддерживает все функции GDI+ в Windows и macOS. Существуют также платформы, где libgdiplus недоступен вообще. Чтобы использовать типы из пакета System.Drawing.Common в Linux и macOS, необходимо установить libgdiplus отдельно. Дополнительные сведения см. в статье Install .NET в Linux или Install .NET в macOS.

  • В .NET 6 и более поздних версиях пакет NuGet System.Drawing.Common пакет NuGet поддерживается только в операционных системах Windows. Дополнительные сведения см. в статье System.Drawing.Common, поддерживаемой только в Windows.

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

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