Image Класс

Определение

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

public ref class Image abstract : MarshalByRefObject, ICloneable, IDisposable, System::Runtime::Serialization::ISerializable
public abstract class Image : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter("System.Drawing.ImageConverter, System.Windows.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51")]
public abstract class Image : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.ImageConverter))]
public abstract class Image : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.ImageConverter))]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public abstract class Image : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
type Image = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable
[<System.ComponentModel.TypeConverter("System.Drawing.ImageConverter, System.Windows.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51")>]
type Image = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.ImageConverter))>]
type Image = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.ImageConverter))>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type Image = class
    inherit MarshalByRefObject
    interface ISerializable
    interface ICloneable
    interface IDisposable
Public MustInherit Class Image
Inherits MarshalByRefObject
Implements 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 методов.

Примечание

в .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 данными, необходимыми для сериализации целевого объекта.

Применяется к

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