Bitmap Bitmap Bitmap Bitmap Class

Определение

Инкапсулирует точечный рисунок GDI+, состоящий из данных пикселей графического изображения и атрибутов рисунка.Encapsulates a GDI+ bitmap, which consists of the pixel data for a graphics image and its attributes. Объект Bitmap используется для работы с изображениями, определяемыми данными пикселей.A Bitmap is an object used to work with images defined by pixel data.

public ref class Bitmap sealed : System::Drawing::Image
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public sealed class Bitmap : System.Drawing.Image
type Bitmap = class
    inherit Image
Public NotInheritable Class Bitmap
Inherits Image
Наследование
Атрибуты

Примеры

В следующем примере кода показано, как создать новый Bitmap из файла, с помощью GetPixel и SetPixel методы Перекрасить изображение.The following code example demonstrates how to construct a new Bitmap from a file, using the GetPixel and SetPixel methods to recolor the image. Он также использует PixelFormat, Width, и Height свойства.It also uses the PixelFormat, Width, and Height properties.

Этот пример предназначен для использования с формами Windows, который содержит Label, PictureBox, и Button с именем Label1, PictureBox1, и Button1, соответственно.This example is designed to be used with a Windows Forms that contains a Label, PictureBox, and Button named Label1, PictureBox1, and Button1, respectively. Вставьте код в форму и связать Button1_Click метод с помощью кнопки Click событий.Paste the code into the form and associate the Button1_Click method with the button's Click event.

private:
   Bitmap^ image1;
   void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      try
      {
         
         // Retrieve the image.
         image1 = gcnew Bitmap( "C:\\Documents and Settings\\All Users\\"
         "Documents\\My Music\\music.bmp",true );
         int x;
         int y;
         
         // Loop through the images pixels to reset color.
         for ( x = 0; x < image1->Width; x++ )
         {
            for ( y = 0; y < image1->Height; y++ )
            {
               Color pixelColor = image1->GetPixel( x, y );
               Color newColor = Color::FromArgb( pixelColor.R, 0, 0 );
               image1->SetPixel( x, y, newColor );

            }

         }
         
         // Set the PictureBox to display the image.
         PictureBox1->Image = image1;
         
         // Display the pixel format in Label1.
         Label1->Text = String::Format( "Pixel format: {0}", image1->PixelFormat );
      }
      catch ( ArgumentException^ ) 
      {
         MessageBox::Show( "There was an error."
         "Check the path to the image file." );
      }

   }
Bitmap image1;

private void Button1_Click(System.Object sender, System.EventArgs e)
{

    try
    {
        // Retrieve the image.
        image1 = new Bitmap(@"C:\Documents and Settings\All Users\" 
            + @"Documents\My Music\music.bmp", true);

        int x, y;

        // Loop through the images pixels to reset color.
        for(x=0; x<image1.Width; x++)
        {
            for(y=0; y<image1.Height; y++)
            {
                Color pixelColor = image1.GetPixel(x, y);
                Color newColor = Color.FromArgb(pixelColor.R, 0, 0);
                image1.SetPixel(x, y, newColor);
            }
        }

        // Set the PictureBox to display the image.
        PictureBox1.Image = image1;

        // Display the pixel format in Label1.
        Label1.Text = "Pixel format: "+image1.PixelFormat.ToString();

    }
    catch(ArgumentException)
    {
        MessageBox.Show("There was an error." +
            "Check the path to the image file.");
    }
}
Dim image1 As Bitmap

Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click

    Try
        ' Retrieve the image.
        image1 = New Bitmap( _
            "C:\Documents and Settings\All Users\Documents\My Music\music.bmp", _
            True)

        Dim x, y As Integer

        ' Loop through the images pixels to reset color.
        For x = 0 To image1.Width - 1
            For y = 0 To image1.Height - 1
                Dim pixelColor As Color = image1.GetPixel(x, y)
                Dim newColor As Color = _
                    Color.FromArgb(pixelColor.R, 0, 0)
                image1.SetPixel(x, y, newColor)
            Next
        Next

        ' Set the PictureBox to display the image.
        PictureBox1.Image = image1

        ' Display the pixel format in Label1.
        Label1.Text = "Pixel format: " + image1.PixelFormat.ToString()

    Catch ex As ArgumentException
        MessageBox.Show("There was an error." _
            & "Check the path to the image file.")
    End Try
End Sub

Комментарии

Битовая карта состоит из данных пикселей графического изображения и его атрибуты.A bitmap consists of the pixel data for a graphics image and its attributes. Существует множество стандартных форматов для сохранения в файл растрового изображения.There are many standard formats for saving a bitmap to a file. GDI+GDI+ поддерживает следующие форматы файлов: BMP, GIF, EXIF, JPG, PNG и TIFF.supports the following file formats: BMP, GIF, EXIF, JPG, PNG and TIFF. Дополнительные сведения о поддерживаемых форматах см. в разделе типы точечных рисунков.For more information about supported formats, see Types of Bitmaps.

Можно создать образы из файлы, потоки и другие источники с помощью одного из Bitmap конструкторы и сохранять их в поток или в файловой системе с Save метод.You can create images from files, streams, and other sources by using one of the Bitmap constructors and save them to a stream or to the file system with the Save method. Изображения отображаются на экране или в память с помощью DrawImage метод Graphics объекта.Images are drawn to the screen or to memory by using the DrawImage method of the Graphics object. Список разделов, посвященных работе с файлами изображений, см. в разделе работа с изображения, точечные рисунки, значки и метафайлы.For a list of topics about working with image files, see Working with Images, Bitmaps, Icons, and Metafiles.

Примечание

Bitmap Класс между доменами приложений недоступен.The Bitmap class is not accessible across application domains. Например, если создать динамический AppDomain и создать несколько кисти, перья и точечные рисунки в этот домен, а затем передайте эти объекты обратно в домен основного приложения, можно успешно использовать перья и кисти.For example, if you create a dynamic AppDomain and create several brushes, pens, and bitmaps in that domain, then pass these objects back to the main application domain, you can successfully use the pens and brushes. Тем не менее при вызове метода DrawImage метод для отображения маршалированного Bitmap, возникает следующее исключение.However, if you call the DrawImage method to draw the marshaled Bitmap, you receive the following exception.

Удаленное взаимодействие не удается найти поле «образов в машинном коде» в типе «System.Drawing.Image».Remoting cannot find field "native image" on type "System.Drawing.Image".

Конструкторы

Bitmap(Image) Bitmap(Image) Bitmap(Image) Bitmap(Image)

Инициализирует новый экземпляр класса Bitmap из указанного существующего изображения.Initializes a new instance of the Bitmap class from the specified existing image.

Bitmap(Image, Int32, Int32) Bitmap(Image, Int32, Int32) Bitmap(Image, Int32, Int32) Bitmap(Image, Int32, Int32)

Инициализирует новый экземпляр класса Bitmap из указанного существующего изображения, масштабированного до заданного размера.Initializes a new instance of the Bitmap class from the specified existing image, scaled to the specified size.

Bitmap(Image, Size) Bitmap(Image, Size) Bitmap(Image, Size) Bitmap(Image, Size)

Инициализирует новый экземпляр класса Bitmap из указанного существующего изображения, масштабированного до заданного размера.Initializes a new instance of the Bitmap class from the specified existing image, scaled to the specified size.

Bitmap(Int32, Int32) Bitmap(Int32, Int32) Bitmap(Int32, Int32) Bitmap(Int32, Int32)

Инициализирует новый экземпляр класса Bitmap с заданным размером.Initializes a new instance of the Bitmap class with the specified size.

Bitmap(Int32, Int32, Graphics) Bitmap(Int32, Int32, Graphics) Bitmap(Int32, Int32, Graphics) Bitmap(Int32, Int32, Graphics)

Инициализирует новый экземпляр класса Bitmap с заданным размером и с разрешением указанного объекта Graphics.Initializes a new instance of the Bitmap class with the specified size and with the resolution of the specified Graphics object.

Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr) Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr) Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr) Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr)

Инициализирует новый экземпляр класса Bitmap с заданным размером, форматом и данными пикселей.Initializes a new instance of the Bitmap class with the specified size, pixel format, and pixel data.

Bitmap(Int32, Int32, PixelFormat) Bitmap(Int32, Int32, PixelFormat) Bitmap(Int32, Int32, PixelFormat) Bitmap(Int32, Int32, PixelFormat)

Инициализирует новый экземпляр класса Bitmap с заданными значениями размера и формата.Initializes a new instance of the Bitmap class with the specified size and format.

Bitmap(Stream) Bitmap(Stream) Bitmap(Stream) Bitmap(Stream)

Инициализация нового экземпляра класса Bitmap из указанного потока данных.Initializes a new instance of the Bitmap class from the specified data stream.

Bitmap(Stream, Boolean) Bitmap(Stream, Boolean) Bitmap(Stream, Boolean) Bitmap(Stream, Boolean)

Инициализация нового экземпляра класса Bitmap из указанного потока данных.Initializes a new instance of the Bitmap class from the specified data stream.

Bitmap(String) Bitmap(String) Bitmap(String) Bitmap(String)

Инициализирует новый экземпляр класса Bitmap из указанного файла.Initializes a new instance of the Bitmap class from the specified file.

Bitmap(String, Boolean) Bitmap(String, Boolean) Bitmap(String, Boolean) Bitmap(String, Boolean)

Инициализирует новый экземпляр класса Bitmap из указанного файла.Initializes a new instance of the Bitmap class from the specified file.

Bitmap(Type, String) Bitmap(Type, String) Bitmap(Type, String) Bitmap(Type, String)

Инициализирует новый экземпляр класса Bitmap из указанного ресурса.Initializes a new instance of the Bitmap class from a specified resource.

Методы

Clone() Clone() Clone() Clone()

Создает точную копию данного объекта Image.Creates an exact copy of this Image.

(Inherited from Image)
Clone(Rectangle, PixelFormat) Clone(Rectangle, PixelFormat) Clone(Rectangle, PixelFormat) Clone(Rectangle, PixelFormat)

Создает копию раздела этого объекта Bitmap, определяемого структурой Rectangle и с указанным перечислением PixelFormat.Creates a copy of the section of this Bitmap defined by Rectangle structure and with a specified PixelFormat enumeration.

Clone(RectangleF, PixelFormat) Clone(RectangleF, PixelFormat) Clone(RectangleF, PixelFormat) Clone(RectangleF, PixelFormat)

Создает копию части этого изображения Bitmap, определяемого заданным перечислением PixelFormat.Creates a copy of the section of this Bitmap defined with a specified PixelFormat enumeration.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Освобождает все ресурсы, используемые этим объектом Image.Releases all resources used by this Image.

(Inherited from Image)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом Image, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the Image and optionally releases the managed resources.

(Inherited from Image)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FromHicon(IntPtr) FromHicon(IntPtr) FromHicon(IntPtr) FromHicon(IntPtr)

Создает изображение Bitmap для значка из дескриптора Windows.Creates a Bitmap from a Windows handle to an icon.

FromResource(IntPtr, String) FromResource(IntPtr, String) FromResource(IntPtr, String) FromResource(IntPtr, String)

Создает изображение Bitmap из указанного ресурса Windows.Creates a Bitmap from the specified Windows resource.

GetBounds(GraphicsUnit) GetBounds(GraphicsUnit) GetBounds(GraphicsUnit) GetBounds(GraphicsUnit)

Возвращает границы изображения в указанных единицах измерения.Gets the bounds of the image in the specified unit.

(Inherited from Image)
GetEncoderParameterList(Guid) GetEncoderParameterList(Guid) GetEncoderParameterList(Guid) GetEncoderParameterList(Guid)

Возвращает информацию о параметрах, поддерживаемых указанным кодировщиком изображения.Returns information about the parameters supported by the specified image encoder.

(Inherited from Image)
GetFrameCount(FrameDimension) GetFrameCount(FrameDimension) GetFrameCount(FrameDimension) GetFrameCount(FrameDimension)

Возвращает количество кадров указанного размера.Returns the number of frames of the specified dimension.

(Inherited from Image)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetHbitmap() GetHbitmap() GetHbitmap() GetHbitmap()

Создает объект точечного рисунка GDIGDI из данного изображения Bitmap.Creates a GDIGDI bitmap object from this Bitmap.

GetHbitmap(Color) GetHbitmap(Color) GetHbitmap(Color) GetHbitmap(Color)

Создает объект точечного рисунка GDIGDI из данного изображения Bitmap.Creates a GDIGDI bitmap object from this Bitmap.

GetHicon() GetHicon() GetHicon() GetHicon()

Возвращает дескриптор для значка.Returns the handle to an icon.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetPixel(Int32, Int32) GetPixel(Int32, Int32) GetPixel(Int32, Int32) GetPixel(Int32, Int32)

Возвращает цвет указанного пикселя в этом изображении Bitmap.Gets the color of the specified pixel in this Bitmap.

GetPropertyItem(Int32) GetPropertyItem(Int32) GetPropertyItem(Int32) GetPropertyItem(Int32)

Возвращает указанный элемент свойства из объекта Image.Gets the specified property item from this Image.

(Inherited from Image)
GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr) GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr) GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr) GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr)

Возвращает эскиз для этого объекта Image.Returns a thumbnail for this Image.

(Inherited from Image)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
LockBits(Rectangle, ImageLockMode, PixelFormat) LockBits(Rectangle, ImageLockMode, PixelFormat) LockBits(Rectangle, ImageLockMode, PixelFormat) LockBits(Rectangle, ImageLockMode, PixelFormat)

Блокирует объект Bitmap в системной памяти.Locks a Bitmap into system memory.

LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData) LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData) LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData) LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)

Блокирует объект Bitmap в оперативной памяти.Locks a Bitmap into system memory

MakeTransparent() MakeTransparent() MakeTransparent() MakeTransparent()

Делает прозрачным прозрачный цвет по умолчанию для этого элемента Bitmap.Makes the default transparent color transparent for this Bitmap.

MakeTransparent(Color) MakeTransparent(Color) MakeTransparent(Color) MakeTransparent(Color)

Делает заданный цвет прозрачным для данного изображения Bitmap.Makes the specified color transparent for this Bitmap.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
RemovePropertyItem(Int32) RemovePropertyItem(Int32) RemovePropertyItem(Int32) RemovePropertyItem(Int32)

Удаляет указанный элемент свойства из этого Image.Removes the specified property item from this Image.

(Inherited from Image)
RotateFlip(RotateFlipType) RotateFlip(RotateFlipType) RotateFlip(RotateFlipType) RotateFlip(RotateFlipType)

Поворачивает, зеркально отражает, либо поворачивает и зеркально отражает объект Image.Rotates, flips, or rotates and flips the Image.

(Inherited from Image)
Save(Stream, ImageCodecInfo, EncoderParameters) Save(Stream, ImageCodecInfo, EncoderParameters) Save(Stream, ImageCodecInfo, EncoderParameters) Save(Stream, ImageCodecInfo, EncoderParameters)

Сохраняет данное изображение в указанный поток с заданным кодировщиком и определенными параметрами кодировщика изображения.Saves this image to the specified stream, with the specified encoder and image encoder parameters.

(Inherited from Image)
Save(Stream, ImageFormat) Save(Stream, ImageFormat) Save(Stream, ImageFormat) Save(Stream, ImageFormat)

Сохраняет данное изображение в указанный поток в указанном формате.Saves this image to the specified stream in the specified format.

(Inherited from Image)
Save(String) Save(String) Save(String) Save(String)

Сохраняет объект Image в указанный файл или поток.Saves this Image to the specified file or stream.

(Inherited from Image)
Save(String, ImageCodecInfo, EncoderParameters) Save(String, ImageCodecInfo, EncoderParameters) Save(String, ImageCodecInfo, EncoderParameters) Save(String, ImageCodecInfo, EncoderParameters)

Сохраняет объект Image в указанный файл с заданным кодировщиком и определенными параметрами кодировщика изображения.Saves this Image to the specified file, with the specified encoder and image-encoder parameters.

(Inherited from Image)
Save(String, ImageFormat) Save(String, ImageFormat) Save(String, ImageFormat) Save(String, ImageFormat)

Сохраняет объект Image в указанный файл в указанном формате.Saves this Image to the specified file in the specified format.

(Inherited from Image)
SaveAdd(EncoderParameters) SaveAdd(EncoderParameters) SaveAdd(EncoderParameters) SaveAdd(EncoderParameters)

Добавляет кадр в файл или поток, указанный в предыдущем вызове метода Save.Adds a frame to the file or stream specified in a previous call to the Save method. Используйте данный метод для сохранения выбранных кадров из многокадрового изображения в другое многокадровое изображение.Use this method to save selected frames from a multiple-frame image to another multiple-frame image.

(Inherited from Image)
SaveAdd(Image, EncoderParameters) SaveAdd(Image, EncoderParameters) SaveAdd(Image, EncoderParameters) SaveAdd(Image, EncoderParameters)

Добавляет кадр в файл или поток, указанный в предыдущем вызове метода Save.Adds a frame to the file or stream specified in a previous call to the Save method.

(Inherited from Image)
SelectActiveFrame(FrameDimension, Int32) SelectActiveFrame(FrameDimension, Int32) SelectActiveFrame(FrameDimension, Int32) SelectActiveFrame(FrameDimension, Int32)

Выделяет кадр, определяемый размером и индексом.Selects the frame specified by the dimension and index.

(Inherited from Image)
SetPixel(Int32, Int32, Color) SetPixel(Int32, Int32, Color) SetPixel(Int32, Int32, Color) SetPixel(Int32, Int32, Color)

Задает цвет указанного пикселя в этом объекте Bitmap.Sets the color of the specified pixel in this Bitmap.

SetPropertyItem(PropertyItem) SetPropertyItem(PropertyItem) SetPropertyItem(PropertyItem) SetPropertyItem(PropertyItem)

Сохраняет элемент свойства (часть метаданных) в Image.Stores a property item (piece of metadata) in this Image.

(Inherited from Image)
SetResolution(Single, Single) SetResolution(Single, Single) SetResolution(Single, Single) SetResolution(Single, Single)

Задает разрешение для этого изображения Bitmap.Sets the resolution for this Bitmap.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)
UnlockBits(BitmapData) UnlockBits(BitmapData) UnlockBits(BitmapData) UnlockBits(BitmapData)

Разблокирует это изображение Bitmap из оперативной памяти.Unlocks this Bitmap from system memory.

Свойства

Flags Flags Flags Flags

Возвращает флаги атрибутов для пиксельных данных этого объекта Image.Gets attribute flags for the pixel data of this Image.

(Inherited from Image)
FrameDimensionsList FrameDimensionsList FrameDimensionsList FrameDimensionsList

Возвращает массив идентификаторов GUID, представляющих размеры кадров в объекте Image.Gets an array of GUIDs that represent the dimensions of frames within this Image.

(Inherited from Image)
Height Height Height Height

Возвращает высоту объекта Image в пикселях.Gets the height, in pixels, of this Image.

(Inherited from Image)
HorizontalResolution HorizontalResolution HorizontalResolution HorizontalResolution

Возвращает горизонтальное разрешение объекта Image в пикселях на дюйм.Gets the horizontal resolution, in pixels per inch, of this Image.

(Inherited from Image)
Palette Palette Palette Palette

Возвращает или задает палитру цветов, используемую для объекта Image.Gets or sets the color palette used for this Image.

(Inherited from Image)
PhysicalDimension PhysicalDimension PhysicalDimension PhysicalDimension

Возвращает ширину и высоту данного изображения.Gets the width and height of this image.

(Inherited from Image)
PixelFormat PixelFormat PixelFormat PixelFormat

Возвращает формат пикселей для этого объекта Image.Gets the pixel format for this Image.

(Inherited from Image)
PropertyIdList PropertyIdList PropertyIdList PropertyIdList

Возвращает идентификаторы элементов свойств, хранящихся в объекте Image.Gets IDs of the property items stored in this Image.

(Inherited from Image)
PropertyItems PropertyItems PropertyItems PropertyItems

Возвращает все элементы свойств (части метаданных), хранящихся в объекте Image.Gets all the property items (pieces of metadata) stored in this Image.

(Inherited from Image)
RawFormat RawFormat RawFormat RawFormat

Возвращает формат файла этого объекта Image.Gets the file format of this Image.

(Inherited from Image)
Size Size Size Size

Возвращает ширину и высоту изображения в пикселях.Gets the width and height, in pixels, of this image.

(Inherited from Image)
Tag Tag Tag Tag

Возвращает или задает объект, предоставляющий дополнительные данные об изображении.Gets or sets an object that provides additional data about the image.

(Inherited from Image)
VerticalResolution VerticalResolution VerticalResolution VerticalResolution

Возвращает вертикальное разрешение объекта Image в пикселях на дюйм.Gets the vertical resolution, in pixels per inch, of this Image.

(Inherited from Image)
Width Width Width Width

Возвращает ширину объекта Image в пикселях.Gets the width, in pixels, of this Image.

(Inherited from Image)

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

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Заполняет объект SerializationInfo данными, необходимыми для сериализации целевого объекта.Populates a SerializationInfo with the data needed to serialize the target object.

(Inherited from Image)

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

Дополнительно