Image Класс

Определение

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

System.Drawing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

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

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 Forms, используйте один из DrawImage методов .

Примечание

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

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

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Заполняет объект SerializationInfo данными, необходимыми для сериализации целевого объекта.

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

• Работа с растровыми и векторными изображениями с использованием классов Image, Bitmap и Metafile
• Работа с растровыми и векторными изображениями