Image Класс

Определение

Пространство имен:

System.Drawing

Сборка:

System.Drawing.Common.dll

Исходный код:

Image.cs

Абстрактный базовый класс, предоставляющий функциональные возможности для Bitmap классов и Metafile по убыванию.

public ref class Image abstract : MarshalByRefObject, ICloneable, IDisposable, System::Runtime::Serialization::ISerializable

[System.ComponentModel.TypeConverter(typeof(System.Drawing.ImageConverter))]
[System.Serializable]
public abstract class Image : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable

[<System.ComponentModel.TypeConverter(typeof(System.Drawing.ImageConverter))>]
[<System.Serializable>]
type Image = class
    inherit MarshalByRefObject
    interface IDisposable
    interface ICloneable
    interface ISerializable

Public MustInherit Class Image
Inherits MarshalByRefObject
Implements ICloneable, IDisposable, ISerializable

Наследование

Object

MarshalByRefObject

Image

Производный

System.Drawing.Bitmap

System.Drawing.Imaging.Metafile

Атрибуты

TypeConverterAttribute SerializableAttribute

Реализации

ICloneable IDisposable ISerializable

Примеры

Следующий пример кода предназначен для использования с Windows Forms. Это обработчик события Paint . Graphics Объект передается в событие и используется для рисования изображения в форме. Код выполняет следующие действия:

• Создает изображение из файла с именем SampImag.jpg. Этот файл должен находиться в той же папке, что и исполняемый файл приложения.

• Создает точку, в которой нужно нарисовать левый верхний угол изображения.

• Рисует немасштабированное изображение в форме.

private:
   void ImageExampleForm_Paint(System::Object^  sender, System::Windows::Forms::PaintEventArgs^  e) 
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create Point for upper-left corner of image.
      Point ulCorner = Point(100,100);

      // Draw image to screen.
      e->Graphics->DrawImage( newImage, ulCorner );
   }

private void ImageExampleForm_Paint(object sender, PaintEventArgs e)
{         
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create Point for upper-left corner of image.
    Point ulCorner = new Point(100, 100);
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, ulCorner);
}

Private Sub ImageExampleForm_Paint _
    (ByVal sender As System.Object, _
    ByVal e As System.Windows.Forms.PaintEventArgs) _
    Handles MyBase.Paint


    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create Point for upper-left corner of image.
    Dim ulCorner As New Point(100, 100)

    ' Draw image to screen.
    e.Graphics.DrawImage(newImage, ulCorner)
End Sub

Комментарии

Для рисования Image в Windows Form используйте один из DrawImage методов.

Note

В .NET 6 и более поздних версиях пакет System.Drawing.Common, который включает этот тип, поддерживается только в операционных системах Windows. Использование этого типа в кроссплатформенных приложениях вызывает предупреждения во время компиляции и исключения во время выполнения. Дополнительные сведения см. в статье System.Drawing.Common, поддерживаемой только в Windows.

Свойства

Имя	Описание
Flags	Возвращает флаги атрибутов для данных пикселей этого Imageобъекта.
FrameDimensionsList	Получает массив идентификаторов GUID, представляющих размеры кадров в этом Imageобъекте.
Height	Возвращает высоту (в пикселях) этого Imageобъекта.
HorizontalResolution	Получает горизонтальное разрешение (в пикселях на дюйм) этого Image.
Palette	Возвращает или задает цветовую палитру, используемую для этого Image.
PhysicalDimension	Возвращает ширину и высоту этого изображения.
PixelFormat	Возвращает формат пикселя для этого Image.
PropertyIdList	Возвращает идентификаторы элементов свойств, хранящихся в этом файле Image.
PropertyItems	Возвращает все элементы свойств (фрагменты метаданных), хранящиеся в этом Imageфайле.
RawFormat	Возвращает формат Imageэтого файла.
Size	Возвращает ширину и высоту изображения в пикселях.
Tag	Возвращает или задает объект, предоставляющий дополнительные данные о изображении.
VerticalResolution	Получает вертикальное разрешение в пикселях на дюйм.Image
Width	Возвращает ширину (в пикселях) этого Imageпараметра.

Методы

Имя	Описание
Clone()	Создает точную копию этого Imageобъекта.
Dispose()	Освобождает все ресурсы, используемые этим Imageпараметром.
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые Image и при необходимости освобождает управляемые ресурсы.
Finalize()	Позволяет объекту пытаться освободить ресурсы и выполнять другие операции очистки перед его восстановлением сборкой мусора.
FromFile(String, Boolean)	Image Создает из указанного файла с помощью внедренных сведений об управлении цветами в этом файле.
FromFile(String)	Создает из Image указанного файла.
FromHbitmap(IntPtr, IntPtr)	Bitmap Создает от дескриптора до растрового изображения GDI и дескриптора в палитру GDI.
FromHbitmap(IntPtr)	Bitmap Создает из дескриптора в растровое изображение GDI.
FromStream(Stream, Boolean, Boolean)	Image Создает из указанного потока данных, при необходимости используя внедренные сведения об управлении цветом и проверяя данные изображения.
FromStream(Stream, Boolean)	Image Создает из указанного потока данных, при необходимости используя внедренные сведения об управлении цветами в этом потоке.
FromStream(Stream)	Создает из Image указанного потока данных.
GetBounds(GraphicsUnit)	Возвращает границы изображения в указанной единице.
GetEncoderParameterList(Guid)	Возвращает сведения о параметрах, поддерживаемых указанным кодировщиком изображений.
GetFrameCount(FrameDimension)	Возвращает количество кадров указанного измерения.
GetPixelFormatSize(PixelFormat)	Возвращает глубину цвета(в количестве битов на пиксель) указанного формата пикселей.
GetPropertyItem(Int32)	Возвращает указанный элемент свойства из этого Imageэлемента.
GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr)	Возвращает эскиз для этого Image.
IsAlphaPixelFormat(PixelFormat)	Возвращает значение, указывающее, содержит ли формат пикселя для этого Image альфа-данные.
IsCanonicalPixelFormat(PixelFormat)	Возвращает значение, указывающее, равен ли формат пикселя 32 битам на пиксель.
IsExtendedPixelFormat(PixelFormat)	Возвращает значение, указывающее, равен ли формат пикселей 64 битам на пиксель.
RemovePropertyItem(Int32)	Удаляет указанный элемент свойства из этого Imageэлемента.
RotateFlip(RotateFlipType)	Поворачивает, переворачивает или поворачивает и переворачивает Image.
Save(Stream, ImageCodecInfo, EncoderParameters)	Сохраняет это изображение в указанном потоке с указанными параметрами кодировщика и кодировщика изображений.
Save(Stream, ImageFormat)	Сохраняет это изображение в указанном потоке в указанном формате.
Save(String, ImageCodecInfo, EncoderParameters)	Сохраняет его Image в указанный файл с указанными параметрами кодировщика и кодировщика изображений.
Save(String, ImageFormat)	Сохраняет его Image в указанный файл в указанном формате.
Save(String)	Сохраняет его Image в указанном файле или потоке.
SaveAdd(EncoderParameters)	Добавляет кадр в файл или поток, указанный в предыдущем вызове Save метода. Используйте этот метод, чтобы сохранить выбранные кадры из изображения с несколькими кадрами в другой образ с несколькими кадрами.
SaveAdd(Image, EncoderParameters)	Добавляет кадр в файл или поток, указанный в предыдущем вызове Save метода.
SelectActiveFrame(FrameDimension, Int32)	Выбирает кадр, заданный измерением и индексом.
SetPropertyItem(PropertyItem)	Хранит элемент свойства (часть метаданных) в этом Imageэлементе.

Явные реализации интерфейса

Имя	Описание
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Заполняет SerializationInfo данные, необходимые для сериализации целевого объекта.

См. также раздел

• изображения, растровые изображения и метафайлы
• Работа с изображениями, растровыми изображениями, значками и метафайлами