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