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