Bitmap Klasa

Definicja

Hermetyzuje mapę bitową GDI+, która składa się z danych pikseli obrazu graficznego i jego atrybutów.Encapsulates a GDI+ bitmap, which consists of the pixel data for a graphics image and its attributes. A Bitmap jest obiektem używanym do pracy z obrazami zdefiniowanymi przez dane pikseli.A Bitmap is an object used to work with images defined by pixel data.

public ref class Bitmap sealed : System::Drawing::Image
public sealed class Bitmap : System.Drawing.Image
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public sealed class Bitmap : System.Drawing.Image
type Bitmap = class
    inherit Image
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type Bitmap = class
    inherit Image
Public NotInheritable Class Bitmap
Inherits Image
Dziedziczenie
Atrybuty

Przykłady

Poniższy przykład kodu demonstruje, jak utworzyć nowy Bitmap z pliku przy użyciu GetPixel metod i, SetPixel Aby ponownie kolorować obraz.The following code example demonstrates how to construct a new Bitmap from a file, using the GetPixel and SetPixel methods to recolor the image. Używa również PixelFormat Width właściwości, i Height .It also uses the PixelFormat, Width, and Height properties.

Ten przykład został zaprojektowany, aby można go było używać z Windows Forms, które zawierają odpowiednio, i Label PictureBox Button nazwane Label1 , PictureBox1 i 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. Wklej kod do formularza i skojarz Button1_Click metodę z Click zdarzeniem przycisku.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

Uwagi

Mapa bitowa składa się z danych pikseli obrazu graficznego i jego atrybutów.A bitmap consists of the pixel data for a graphics image and its attributes. Istnieje wiele formatów standardowych do zapisywania mapy bitowej do pliku.There are many standard formats for saving a bitmap to a file. Interfejs GDI+ obsługuje następujące formaty plików: BMP, GIF, EXIF, JPG, PNG i TIFF.GDI+ supports the following file formats: BMP, GIF, EXIF, JPG, PNG and TIFF. Aby uzyskać więcej informacji na temat obsługiwanych formatów, zobacz typy map bitowych.For more information about supported formats, see Types of Bitmaps.

Można tworzyć obrazy z plików, strumieni i innych źródeł przy użyciu jednego z Bitmap konstruktorów i zapisywać je w strumieniu lub w systemie plików przy użyciu Save metody.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. Obrazy są rysowane na ekranie lub do pamięci przy użyciu DrawImage metody Graphics obiektu.Images are drawn to the screen or to memory by using the DrawImage method of the Graphics object. Aby uzyskać listę tematów dotyczących pracy z plikami obrazów, zobacz Praca z obrazami, mapami bitowymi, ikonami i plikami.For a list of topics about working with image files, see Working with Images, Bitmaps, Icons, and Metafiles.

Uwaga

BitmapKlasa nie jest dostępna w różnych domenach aplikacji.The Bitmap class is not accessible across application domains. Jeśli na przykład utworzysz dynamiczny AppDomain i utworzysz kilka pędzli, piór i map bitowych w tej domenie, Przekaż te obiekty z powrotem do domeny głównej aplikacji, możesz pomyślnie użyć piór i pędzli.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. Jeśli jednak wywołasz DrawImage metodę, aby narysować zorganizowany Bitmap , zostanie wyświetlony następujący wyjątek.However, if you call the DrawImage method to draw the marshaled Bitmap, you receive the following exception.

Komunikacja zdalna nie może znaleźć pola "obraz natywny" w typie "System. Drawing. Image".Remoting cannot find field "native image" on type "System.Drawing.Image".

Konstruktory

Bitmap(Image)

Inicjuje nowe wystąpienie Bitmap klasy z określonego istniejącego obrazu.Initializes a new instance of the Bitmap class from the specified existing image.

Bitmap(Image, Int32, Int32)

Inicjuje nowe wystąpienie Bitmap klasy z określonego istniejącego obrazu, skalowane do określonego rozmiaru.Initializes a new instance of the Bitmap class from the specified existing image, scaled to the specified size.

Bitmap(Image, Size)

Inicjuje nowe wystąpienie Bitmap klasy z określonego istniejącego obrazu, skalowane do określonego rozmiaru.Initializes a new instance of the Bitmap class from the specified existing image, scaled to the specified size.

Bitmap(Int32, Int32)

Inicjuje nowe wystąpienie Bitmap klasy o określonym rozmiarze.Initializes a new instance of the Bitmap class with the specified size.

Bitmap(Int32, Int32, Graphics)

Inicjuje nowe wystąpienie Bitmap klasy o określonym rozmiarze i z rozdzielczością określonego Graphics obiektu.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)

Inicjuje nowe wystąpienie Bitmap klasy z określonym rozmiarem, formatem pikseli i danymi pikseli.Initializes a new instance of the Bitmap class with the specified size, pixel format, and pixel data.

Bitmap(Int32, Int32, PixelFormat)

Inicjuje nowe wystąpienie Bitmap klasy o określonym rozmiarze i formacie.Initializes a new instance of the Bitmap class with the specified size and format.

Bitmap(Stream)

Inicjuje nowe wystąpienie Bitmap klasy z określonego strumienia danych.Initializes a new instance of the Bitmap class from the specified data stream.

Bitmap(Stream, Boolean)

Inicjuje nowe wystąpienie Bitmap klasy z określonego strumienia danych.Initializes a new instance of the Bitmap class from the specified data stream.

Bitmap(String)

Inicjuje nowe wystąpienie Bitmap klasy z określonego pliku.Initializes a new instance of the Bitmap class from the specified file.

Bitmap(String, Boolean)

Inicjuje nowe wystąpienie Bitmap klasy z określonego pliku.Initializes a new instance of the Bitmap class from the specified file.

Bitmap(Type, String)

Inicjuje nowe wystąpienie Bitmap klasy z określonego zasobu.Initializes a new instance of the Bitmap class from a specified resource.

Właściwości

Flags

Pobiera flagi atrybutu dla danych pikseli Image .Gets attribute flags for the pixel data of this Image.

(Odziedziczone po Image)
FrameDimensionsList

Pobiera tablicę identyfikatorów GUID, które reprezentują wymiary ramek w tym elemencie Image .Gets an array of GUIDs that represent the dimensions of frames within this Image.

(Odziedziczone po Image)
Height

Pobiera wysokość w pikselach Image .Gets the height, in pixels, of this Image.

(Odziedziczone po Image)
HorizontalResolution

Pobiera rozdzielczość w poziomie (w pikselach na cal) Image .Gets the horizontal resolution, in pixels per inch, of this Image.

(Odziedziczone po Image)
Palette

Pobiera lub ustawia paletę kolorów użytą dla tego elementu Image .Gets or sets the color palette used for this Image.

(Odziedziczone po Image)
PhysicalDimension

Pobiera szerokość i wysokość tego obrazu.Gets the width and height of this image.

(Odziedziczone po Image)
PixelFormat

Pobiera Format piksela Image .Gets the pixel format for this Image.

(Odziedziczone po Image)
PropertyIdList

Pobiera identyfikatory elementów właściwości przechowywanych w tym elemencie Image .Gets IDs of the property items stored in this Image.

(Odziedziczone po Image)
PropertyItems

Pobiera wszystkie elementy właściwości (fragmenty metadanych) przechowywane w tym elemencie Image .Gets all the property items (pieces of metadata) stored in this Image.

(Odziedziczone po Image)
RawFormat

Pobiera format pliku Image .Gets the file format of this Image.

(Odziedziczone po Image)
Size

Pobiera szerokość i wysokość tego obrazu (w pikselach).Gets the width and height, in pixels, of this image.

(Odziedziczone po Image)
Tag

Pobiera lub ustawia obiekt, który dostarcza dodatkowe dane dotyczące obrazu.Gets or sets an object that provides additional data about the image.

(Odziedziczone po Image)
VerticalResolution

Pobiera rozdzielczość w pionie (w pikselach na cal) Image .Gets the vertical resolution, in pixels per inch, of this Image.

(Odziedziczone po Image)
Width

Pobiera szerokość w pikselach Image .Gets the width, in pixels, of this Image.

(Odziedziczone po Image)

Metody

Clone()

Tworzy dokładną kopię tego elementu Image .Creates an exact copy of this Image.

(Odziedziczone po Image)
Clone(Rectangle, PixelFormat)

Tworzy kopię sekcji tej Bitmap zdefiniowanej przez Rectangle strukturę i z określonym PixelFormat wyliczeniem.Creates a copy of the section of this Bitmap defined by Rectangle structure and with a specified PixelFormat enumeration.

Clone(RectangleF, PixelFormat)

Tworzy kopię sekcji tego obiektu Bitmap zdefiniowaną z określonym PixelFormat wyliczeniem.Creates a copy of the section of this Bitmap defined with a specified PixelFormat enumeration.

CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
Dispose()

Zwalnia wszystkie zasoby używane przez ten program Image .Releases all resources used by this Image.

(Odziedziczone po Image)
Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element Image i opcjonalnie zwalnia zasoby zarządzane.Releases the unmanaged resources used by the Image and optionally releases the managed resources.

(Odziedziczone po Image)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
FromHicon(IntPtr)

Tworzy Bitmap z dojścia systemu Windows na ikonę.Creates a Bitmap from a Windows handle to an icon.

FromResource(IntPtr, String)

Tworzy Bitmap z określonego zasobu systemu Windows.Creates a Bitmap from the specified Windows resource.

GetBounds(GraphicsUnit)

Pobiera granice obrazu w określonej jednostce.Gets the bounds of the image in the specified unit.

(Odziedziczone po Image)
GetEncoderParameterList(Guid)

Zwraca informacje o parametrach obsługiwanych przez określony koder obrazu.Returns information about the parameters supported by the specified image encoder.

(Odziedziczone po Image)
GetFrameCount(FrameDimension)

Zwraca liczbę ramek określonego wymiaru.Returns the number of frames of the specified dimension.

(Odziedziczone po Image)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetHbitmap()

Tworzy obiekt mapy bitowej GDI z tego elementu Bitmap .Creates a GDI bitmap object from this Bitmap.

GetHbitmap(Color)

Tworzy obiekt mapy bitowej GDI z tego elementu Bitmap .Creates a GDI bitmap object from this Bitmap.

GetHicon()

Zwraca uchwyt do ikony.Returns the handle to an icon.

GetLifetimeService()
Nieaktualne.

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetPixel(Int32, Int32)

Pobiera kolor określonego piksela w tym elemencie Bitmap .Gets the color of the specified pixel in this Bitmap.

GetPropertyItem(Int32)

Pobiera określony element właściwości z tego elementu Image .Gets the specified property item from this Image.

(Odziedziczone po Image)
GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr)

Zwraca miniaturę Image .Returns a thumbnail for this Image.

(Odziedziczone po Image)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()
Nieaktualne.

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
LockBits(Rectangle, ImageLockMode, PixelFormat)

Powoduje zablokowanie Bitmap do pamięci systemowej.Locks a Bitmap into system memory.

LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)

Powoduje zablokowanie Bitmap do pamięci systemowej.Locks a Bitmap into system memory.

MakeTransparent()

Sprawia, że domyślny kolor przezroczysty jest przezroczysty dla tego elementu Bitmap .Makes the default transparent color transparent for this Bitmap.

MakeTransparent(Color)

Sprawia, że określony kolor jest przezroczysty dla tego elementu Bitmap .Makes the specified color transparent for this Bitmap.

MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego MarshalByRefObject obiektu.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
RemovePropertyItem(Int32)

Usuwa określony element właściwości z tego elementu Image .Removes the specified property item from this Image.

(Odziedziczone po Image)
RotateFlip(RotateFlipType)

Obrót, przerzucanie lub obracanie i przerzucanie Image .Rotates, flips, or rotates and flips the Image.

(Odziedziczone po Image)
Save(Stream, ImageCodecInfo, EncoderParameters)

Zapisuje ten obraz do określonego strumienia przy użyciu określonych parametrów kodera i kodera obrazu.Saves this image to the specified stream, with the specified encoder and image encoder parameters.

(Odziedziczone po Image)
Save(Stream, ImageFormat)

Zapisuje ten obraz do określonego strumienia w określonym formacie.Saves this image to the specified stream in the specified format.

(Odziedziczone po Image)
Save(String)

Zapisuje to Image w określonym pliku lub strumieniu.Saves this Image to the specified file or stream.

(Odziedziczone po Image)
Save(String, ImageCodecInfo, EncoderParameters)

Zapisuje ten Image plik w określonym pliku z określonymi parametrami kodera i kodera.Saves this Image to the specified file, with the specified encoder and image-encoder parameters.

(Odziedziczone po Image)
Save(String, ImageFormat)

Zapisuje ten Image plik do określonego pliku w określonym formacie.Saves this Image to the specified file in the specified format.

(Odziedziczone po Image)
SaveAdd(EncoderParameters)

Dodaje ramkę do pliku lub strumienia określonego w poprzednim wywołaniu Save metody.Adds a frame to the file or stream specified in a previous call to the Save method. Użyj tej metody, aby zapisać wybrane ramki z obrazu z wieloma ramkami do innego obrazu z wieloma ramkami.Use this method to save selected frames from a multiple-frame image to another multiple-frame image.

(Odziedziczone po Image)
SaveAdd(Image, EncoderParameters)

Dodaje ramkę do pliku lub strumienia określonego w poprzednim wywołaniu Save metody.Adds a frame to the file or stream specified in a previous call to the Save method.

(Odziedziczone po Image)
SelectActiveFrame(FrameDimension, Int32)

Wybiera ramkę określoną przez wymiar i indeks.Selects the frame specified by the dimension and index.

(Odziedziczone po Image)
SetPixel(Int32, Int32, Color)

Ustawia kolor określonego piksela w tym elemencie Bitmap .Sets the color of the specified pixel in this Bitmap.

SetPropertyItem(PropertyItem)

Przechowuje w tym elemencie Właściwość (fragment metadanych) Image .Stores a property item (piece of metadata) in this Image.

(Odziedziczone po Image)
SetResolution(Single, Single)

Ustawia dla tego rozwiązania Bitmap .Sets the resolution for this Bitmap.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
UnlockBits(BitmapData)

Odblokowuje to Bitmap z pamięci systemowej.Unlocks this Bitmap from system memory.

Jawne implementacje interfejsu

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Wypełnia dane, SerializationInfo które są konieczne do serializacji obiektu docelowego.Populates a SerializationInfo with the data needed to serialize the target object.

(Odziedziczone po Image)

Dotyczy

Zobacz też