Bitmap Klasa

Definicja

Przestrzeń nazw:

System.Drawing

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Source:

Bitmap.cs

Hermetyzuje mapę bitową GDI+ składającą się z danych pikseli dla obrazu graficznego i jego atrybutów. Obiekt Bitmap jest obiektem używanym do pracy z obrazami zdefiniowanymi przez dane pikseli.

public ref class Bitmap sealed : System::Drawing::Image

[System.Serializable]
public sealed class Bitmap : System.Drawing.Image

[<System.Serializable>]
type Bitmap = class
    inherit Image

Public NotInheritable Class Bitmap
Inherits Image

Dziedziczenie

Object

MarshalByRefObject

Image

Bitmap

Atrybuty

SerializableAttribute

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć nowy Bitmap element z pliku przy użyciu GetPixel metod i SetPixel w celu ponownego kolorowania obrazu. Używa również PixelFormatwłaściwości , Widthi Height .

Ten przykład jest przeznaczony do użycia z Windows Forms, który zawiera Labelodpowiednio , PictureBoxi Button o nazwie Label1, PictureBox1i Button1. Wklej kod do formularza i skojarz metodę Button1_Click ze zdarzeniem przycisku Click .

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 dla obrazu graficznego i jego atrybutów. Istnieje wiele standardowych formatów zapisywania mapy bitowej w pliku. GDI+ obsługuje następujące formaty plików: BMP, GIF, EXIF, JPG, PNG i TIFF. Aby uzyskać więcej informacji na temat obsługiwanych formatów, zobacz Typy map bitowych.

Obrazy można tworzyć na podstawie 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 za Save pomocą metody . Obrazy są rysowane na ekranie lub w pamięci przy użyciu DrawImage metody Graphics obiektu. Aby uzyskać listę tematów dotyczących pracy z plikami obrazów, zobacz Praca z obrazami, mapami bitowymi, ikonami i metaplikami.

Uwaga

W programie .NET 6 i nowszych wersjach pakiet System.Drawing.Common, który obejmuje ten typ, jest obsługiwany tylko w systemach operacyjnych Windows. Użycie tego typu w aplikacjach międzyplatformowych powoduje ostrzeżenia w czasie kompilacji i wyjątki czasu wykonywania. Aby uzyskać więcej informacji, zobacz System.Drawing.Common only supported on Windows (Obsługiwane tylko w systemie Windows).

Uwaga

Klasa Bitmap nie jest dostępna w domenach aplikacji. Jeśli na przykład utworzysz dynamiczną AppDomain i utworzysz kilka pędzli, piór i map bitowych w tej domenie, przekaż te obiekty z powrotem do głównej domeny aplikacji, możesz pomyślnie użyć piór i pędzli. Jeśli jednak wywołasz metodę DrawImage , aby narysować marshaled Bitmap, otrzymasz następujący wyjątek:

Komunikacja zdalna nie może odnaleźć pola "obraz natywny" w typie "System.Drawing.Image".

Konstruktory

Bitmap(Image)	Inicjuje Bitmap nowe wystąpienie klasy z określonego istniejącego obrazu.
Bitmap(Image, Int32, Int32)	Inicjuje nowe wystąpienie Bitmap klasy z określonego istniejącego obrazu, skalowane do określonego rozmiaru.
Bitmap(Image, Size)	Inicjuje nowe wystąpienie Bitmap klasy z określonego istniejącego obrazu, skalowane do określonego rozmiaru.
Bitmap(Int32, Int32)	Inicjuje Bitmap nowe wystąpienie klasy o określonym rozmiarze.
Bitmap(Int32, Int32, Graphics)	Inicjuje nowe wystąpienie Bitmap klasy o określonym rozmiarze i rozdzielczości określonego Graphics obiektu.
Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr)	Inicjuje Bitmap nowe wystąpienie klasy z określonym rozmiarem, formatem pikseli i danymi pikseli.
Bitmap(Int32, Int32, PixelFormat)	Inicjuje Bitmap nowe wystąpienie klasy o określonym rozmiarze i formacie.
Bitmap(Stream)	Inicjuje Bitmap nowe wystąpienie klasy z określonego strumienia danych.
Bitmap(Stream, Boolean)	Inicjuje Bitmap nowe wystąpienie klasy z określonego strumienia danych.
Bitmap(String)	Inicjuje Bitmap nowe wystąpienie klasy z określonego pliku.
Bitmap(String, Boolean)	Inicjuje Bitmap nowe wystąpienie klasy z określonego pliku.
Bitmap(Type, String)	Inicjuje Bitmap nowe wystąpienie klasy z określonego zasobu.

Właściwości

Flags	Pobiera flagi atrybutów dla danych pikseli tego Imageelementu . (Odziedziczone po Image)
FrameDimensionsList	Pobiera tablicę identyfikatorów GUID reprezentujących wymiary ramek w tym Imageobiekcie . (Odziedziczone po Image)
Height	Pobiera wysokość w pikselach tego Imageelementu . (Odziedziczone po Image)
HorizontalResolution	Pobiera rozdzielczość poziomą w pikselach na cal tego Imageelementu . (Odziedziczone po Image)
Palette	Pobiera lub ustawia paletę kolorów używaną dla tego Imageelementu . (Odziedziczone po Image)
PhysicalDimension	Pobiera szerokość i wysokość tego obrazu. (Odziedziczone po Image)
PixelFormat	Pobiera format pikseli dla tego Imagepliku . (Odziedziczone po Image)
PropertyIdList	Pobiera identyfikatory elementów właściwości przechowywanych w tym Imageobiekcie . (Odziedziczone po Image)
PropertyItems	Pobiera wszystkie elementy właściwości (elementy metadanych) przechowywane w tym Imagepliku . (Odziedziczone po Image)
RawFormat	Pobiera format pliku tego Imagepliku . (Odziedziczone po Image)
Size	Pobiera szerokość i wysokość obrazu w pikselach. (Odziedziczone po Image)
Tag	Pobiera lub ustawia obiekt, który udostępnia dodatkowe dane dotyczące obrazu. (Odziedziczone po Image)
VerticalResolution	Pobiera rozdzielczość pionową w pikselach na cal tego Image. (Odziedziczone po Image)
Width	Pobiera szerokość w pikselach tego Imageelementu . (Odziedziczone po Image)

Metody

Clone()	Tworzy dokładną kopię tego elementu Image. (Odziedziczone po Image)
Clone(Rectangle, PixelFormat)	Tworzy kopię sekcji zdefiniowanej Bitmap przez Rectangle strukturę i z określonym PixelFormat wyliczeniem.
Clone(RectangleF, PixelFormat)	Tworzy kopię sekcji zdefiniowanej Bitmap przy użyciu określonego PixelFormat wyliczenia.
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszystkie zasoby używane przez ten Imageprogram . (Odziedziczone po Image)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element Image i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po Image)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
FromHicon(IntPtr)	Tworzy obiekt Bitmap na podstawie uchwytu systemu Windows do ikony.
FromResource(IntPtr, String)	Tworzy obiekt Bitmap na podstawie określonego zasobu systemu Windows.
GetBounds(GraphicsUnit)	Pobiera granice obrazu w określonej lekcji. (Odziedziczone po Image)
GetEncoderParameterList(Guid)	Zwraca informacje o parametrach obsługiwanych przez określony koder obrazu. (Odziedziczone po Image)
GetFrameCount(FrameDimension)	Zwraca liczbę ramek określonego wymiaru. (Odziedziczone po Image)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetHbitmap()	Tworzy obiekt mapy bitowej GDI na podstawie tego Bitmapobiektu .
GetHbitmap(Color)	Tworzy obiekt mapy bitowej GDI na podstawie tego Bitmapobiektu .
GetHicon()	Zwraca uchwyt do ikony.
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetPixel(Int32, Int32)	Pobiera kolor określonego piksela w tym Bitmapobiekcie .
GetPropertyItem(Int32)	Pobiera określony element właściwości z tego Imageelementu . (Odziedziczone po Image)
GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr)	Zwraca miniaturę dla tego .Image (Odziedziczone po Image)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
LockBits(Rectangle, ImageLockMode, PixelFormat)	Blokuje pamięć systemową Bitmap .
LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)	Blokuje pamięć systemową Bitmap .
MakeTransparent()	Powoduje, że domyślny przezroczysty kolor jest przezroczysty dla tego Bitmapelementu .
MakeTransparent(Color)	Sprawia, że określony kolor jest przezroczysty dla tego Bitmapelementu .
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
RemovePropertyItem(Int32)	Usuwa określony element właściwości z tego Imageelementu . (Odziedziczone po Image)
RotateFlip(RotateFlipType)	Obraca, przerzuca lub obraca i odwraca obiekt Image. (Odziedziczone po Image)
Save(Stream, ImageCodecInfo, EncoderParameters)	Zapisuje ten obraz w określonym strumieniu z określonymi parametrami kodera i kodera obrazu. (Odziedziczone po Image)
Save(Stream, ImageFormat)	Zapisuje ten obraz w określonym strumieniu w określonym formacie. (Odziedziczone po Image)
Save(String)	Zapisuje to Image w określonym pliku lub strumieniu. (Odziedziczone po Image)
Save(String, ImageCodecInfo, EncoderParameters)	Zapisuje to Image w określonym pliku z określonym koderem i parametrami kodera obrazu. (Odziedziczone po Image)
Save(String, ImageFormat)	Zapisuje to Image w określonym pliku w określonym formacie. (Odziedziczone po Image)
SaveAdd(EncoderParameters)	Dodaje ramkę do pliku lub strumienia określonego w poprzednim wywołaniu Save metody . Użyj tej metody, aby zapisać wybrane ramki z obrazu z wieloma ramkami do innego obrazu z wieloma ramkami. (Odziedziczone po Image)
SaveAdd(Image, EncoderParameters)	Dodaje ramkę do pliku lub strumienia określonego w poprzednim wywołaniu Save metody . (Odziedziczone po Image)
SelectActiveFrame(FrameDimension, Int32)	Wybiera ramkę określoną przez wymiar i indeks. (Odziedziczone po Image)
SetPixel(Int32, Int32, Color)	Ustawia kolor określonego piksela w tym Bitmapobiekcie .
SetPropertyItem(PropertyItem)	Przechowuje element właściwości (element metadanych) w tym Imageobiekcie . (Odziedziczone po Image)
SetResolution(Single, Single)	Ustawia rozwiązanie dla tego Bitmapparametru .
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
UnlockBits(BitmapData)	Odblokowuje to Bitmap z pamięci systemowej.

Jawne implementacje interfejsu

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Wypełnia element SerializationInfo danymi wymaganymi do serializacji obiektu docelowego. (Odziedziczone po Image)

Zobacz też

• PictureBox
• Obrazy, mapy bitowe i metapliki
• Praca z obrazami, mapami bitowymi, ikonami i metaplikami