Bitmap Klasse

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Quelle:

Bitmap.cs

Kapselt eine GDI+-Bitmap, die aus den Pixeldaten für eine Grafik und deren Attributen besteht. Eine Bitmap wird für die Arbeit mit Bildern verwendet, die durch Pixeldaten definiert sind.

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

Vererbung

Object

MarshalByRefObject

Image

Bitmap

Attribute

SerializableAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der GetPixel Methoden und SetPixel ein neues Bitmap Bild aus einer Datei erstellen. Außerdem werden die PixelFormatEigenschaften , Widthund Height verwendet.

Dieses Beispiel wurde entworfen, um mit einer Windows Forms verwendet werden, enthalten eine Label, PictureBox, und Button mit dem Namen Label1, PictureBox1, und Button1bzw. Fügen Sie den Code in das Formular ein, und ordnen Sie die Button1_Click Methode dem Ereignis der Schaltfläche Click zu.

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

Hinweise

Eine Bitmap besteht aus den Pixeldaten für ein Grafikbild und den zugehörigen Attributen. Es gibt viele Standardformate zum Speichern einer Bitmap in einer Datei. GDI+ unterstützt die folgenden Dateiformate: BMP, GIF, EXIF, JPG, PNG und TIFF. Weitere Informationen zu unterstützten Formaten finden Sie unter Bitmaptypen.

Sie können Bilder aus Dateien, Streams und anderen Quellen erstellen, indem Sie einen der Bitmap Konstruktoren verwenden und sie mit der -Methode in einem Stream oder im Save Dateisystem speichern. Bilder werden mithilfe der -Methode des Objekts auf den Bildschirm oder in den DrawImageGraphics Arbeitsspeicher gezeichnet. Eine Liste mit Themen zum Arbeiten mit Bilddateien finden Sie unter Arbeiten mit Bildern, Bitmaps, Symbolen und Metadateien.

Hinweis

In .NET 6 und höheren Versionen wird das System.Drawing.Common-Paket, das diesen Typ enthält, nur unter Windows-Betriebssystemen unterstützt. Die Verwendung dieses Typs in plattformübergreifenden Apps führt zu Kompilierzeitwarnungen und Laufzeitausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common wird nur unter Windows unterstützt.

Hinweis

Auf die Bitmap -Klasse kann nicht über Anwendungsdomänen hinweg zugegriffen werden. Wenn Sie beispielsweise eine dynamische AppDomain Erstellen und mehrere Pinsel, Stifte und Bitmaps in dieser Domäne erstellen, übergeben Sie diese Objekte dann wieder an die Standard Anwendungsdomäne, können Sie die Stifte und Pinsel erfolgreich verwenden. Wenn Sie jedoch die DrawImage Methode aufrufen, um das Gemarst Bitmapzu zeichnen, erhalten Sie die folgende Ausnahme:

Remoting kann das Feld "natives Bild" für den Typ "System.Drawing.Image" nicht finden.

Konstruktoren

Bitmap(Image)	Initialisiert eine neue Instanz der Bitmap-Klasse aus dem angegebenen vorhandenen Bild.
Bitmap(Image, Int32, Int32)	Initialisiert eine neue Instanz der Bitmap-Klasse aus dem angegebenen vorhandenen Bild, skaliert auf die angegebene Größe.
Bitmap(Image, Size)	Initialisiert eine neue Instanz der Bitmap-Klasse aus dem angegebenen vorhandenen Bild, skaliert auf die angegebene Größe.
Bitmap(Int32, Int32)	Initialisiert eine neue Instanz der Bitmap-Klasse mit der angegebenen Größe.
Bitmap(Int32, Int32, Graphics)	Initialisiert eine neue Instanz der Bitmap-Klasse mit der angegebenen Größe und der Auflösung des angegebenen Graphics-Objekts.
Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr)	Initialisiert eine neue Instanz der Bitmap-Klasse mit der angegebenen Größe, dem Pixelformat und den Pixeldaten.
Bitmap(Int32, Int32, PixelFormat)	Initialisiert eine neue Instanz der Bitmap-Klasse mit der angegebenen Größe und dem angegebenen Format.
Bitmap(Stream)	Initialisiert eine neue Instanz der Bitmap-Klasse aus dem angegebenen Stream.
Bitmap(Stream, Boolean)	Initialisiert eine neue Instanz der Bitmap-Klasse aus dem angegebenen Stream.
Bitmap(String)	Initialisiert eine neue Instanz der Bitmap-Klasse aus der angegebenen Datei.
Bitmap(String, Boolean)	Initialisiert eine neue Instanz der Bitmap-Klasse aus der angegebenen Datei.
Bitmap(Type, String)	Initialisiert eine neue Instanz der Bitmap-Klasse aus einer angegebenen Ressource.

Eigenschaften

Flags	Ruft Attributflags für die Pixeldaten dieses Image ab. (Geerbt von Image)
FrameDimensionsList	Ruft ein Array von GUIDs ab, die die Abmessungen der Rahmen in diesem Image darstellen. (Geerbt von Image)
Height	Ruft die Höhe dieses Image in Pixel ab. (Geerbt von Image)
HorizontalResolution	Ruft die horizontale Auflösung dieses Image in Pixel pro Zoll ab. (Geerbt von Image)
Palette	Ruft die für dieses Image verwendete Farbpalette ab oder legt diese fest. (Geerbt von Image)
PhysicalDimension	Ruft die Breite und Höhe dieses Bilds ab. (Geerbt von Image)
PixelFormat	Ruft das Pixelformat für dieses Image ab. (Geerbt von Image)
PropertyIdList	Ruft IDs für die in diesem Image gespeicherten Eigenschaftenelemente ab. (Geerbt von Image)
PropertyItems	Ruft alle in diesem Image gespeicherten Eigenschaftenelemente (Metadaten) ab. (Geerbt von Image)
RawFormat	Ruft das Dateiformat dieses Image ab. (Geerbt von Image)
Size	Ruft die Breite und Höhe dieses Bilds in Pixel ab. (Geerbt von Image)
Tag	Ruft ein Objekt ab, das zusätzliche Daten zu dem Bild bereitstellt, oder legt dieses Objekt fest. (Geerbt von Image)
VerticalResolution	Ruft die vertikale Auflösung dieses Image in Pixel pro Zoll ab. (Geerbt von Image)
Width	Ruft die Breite dieses Image in Pixel ab. (Geerbt von Image)

Methoden

Clone()	Erstellt eine genaue Kopie von dieser Image. (Geerbt von Image)
Clone(Rectangle, PixelFormat)	Erstellt eine Kopie des Abschnitts dieser Bitmap, die durch die Rectangle-Struktur definiert wird, mit einer angegebenen PixelFormat-Enumeration.
Clone(RectangleF, PixelFormat)	Erstellt eine Kopie des Abschnitts dieser Bitmap, die mit einer angegebenen PixelFormat-Enumeration definiert wird.
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle von dieser Image verwendeten Ressourcen frei. (Geerbt von Image)
Dispose(Boolean)	Gibt die von Image verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von Image)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
FromHicon(IntPtr)	Erstellt eine Bitmap aus einem Windows-Handle für ein Symbol.
FromResource(IntPtr, String)	Erstellt eine Bitmap aus der angegebenen Windows-Ressource.
GetBounds(GraphicsUnit)	Ruft die Grenzen des Bilds in der angegebenen Einheit ab. (Geerbt von Image)
GetEncoderParameterList(Guid)	Gibt Informationen über die Parameter zurück, die vom angegebenen Bildencoder unterstützt werden. (Geerbt von Image)
GetFrameCount(FrameDimension)	Gibt die Anzahl der Rahmen in der angegebenen Abmessung zurück. (Geerbt von Image)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetHbitmap()	Erstellt ein GDI-Bitmapobjekt aus diesem Bitmap.
GetHbitmap(Color)	Erstellt ein GDI-Bitmapobjekt aus diesem Bitmap.
GetHicon()	Gibt das Handle für ein Symbol zurück.
GetLifetimeService()	Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetPixel(Int32, Int32)	Ruft die Farbe des angegebenen Pixels in dieser Bitmap ab.
GetPropertyItem(Int32)	Ruft das angegebene Eigenschaftenelement aus diesem Image ab. (Geerbt von Image)
GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr)	Gibt eine Miniaturansicht für dieses Image zurück. (Geerbt von Image)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
LockBits(Rectangle, ImageLockMode, PixelFormat)	Sperrt eine Bitmap im Systemspeicher.
LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)	Sperrt eine Bitmap im Systemspeicher.
MakeTransparent()	Macht die standardmäßige transparente Farbe für diese Bitmap transparent.
MakeTransparent(Color)	Bewirkt, dass die angegebene Farbe für diese Bitmap transparent wird.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
RemovePropertyItem(Int32)	Entfernt das angegebene Eigenschaftenelement aus diesem Image. (Geerbt von Image)
RotateFlip(RotateFlipType)	Dreht und/oder kippt das Image. (Geerbt von Image)
Save(Stream, ImageCodecInfo, EncoderParameters)	Speichert dieses Bild mit den angegebenen Encoder- und Bildencoderparametern im angegebenen Stream. (Geerbt von Image)
Save(Stream, ImageFormat)	Speichert dieses Bild im angegebenen Format im angegebenen Stream. (Geerbt von Image)
Save(String)	Speichert dieses Image in der angegebenen Datei oder dem Stream. (Geerbt von Image)
Save(String, ImageCodecInfo, EncoderParameters)	Speichert dieses Image mit den angegebenen Encoder- und Bildencoderparametern in der angegebenen Datei. (Geerbt von Image)
Save(String, ImageFormat)	Speichert dieses Image im angegebenen Format in der angegebenen Datei. (Geerbt von Image)
SaveAdd(EncoderParameters)	Fügt der in einem vorherigen Aufruf der Save-Methode angegebenen Datei bzw. dem Stream einen Rahmen hinzu. Mit dieser Methode speichern Sie ausgewählte Rahmen eines Bilds mit mehreren Rahmen in einem anderen Bild mit mehreren Rahmen. (Geerbt von Image)
SaveAdd(Image, EncoderParameters)	Fügt der in einem vorherigen Aufruf der Save-Methode angegebenen Datei bzw. dem Stream einen Rahmen hinzu. (Geerbt von Image)
SelectActiveFrame(FrameDimension, Int32)	Wählt den durch die angegebene Abmessung und den Index angegebenen Rahmen aus. (Geerbt von Image)
SetPixel(Int32, Int32, Color)	Legt die Farbe des angegebenen Pixels in dieser Bitmap fest.
SetPropertyItem(PropertyItem)	Speichert ein Eigenschaftenelement (Metadaten) in diesem Image. (Geerbt von Image)
SetResolution(Single, Single)	Legt die Auflösung für diese Bitmap fest.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
UnlockBits(BitmapData)	Hebt die Sperre dieser Bitmap im Systemspeicher auf.

Explizite Schnittstellenimplementierungen

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Füllt eine SerializationInfo mit den Daten auf, die zum Serialisieren des Zielobjekts erforderlich sind. (Geerbt von Image)

Weitere Informationen

• PictureBox
• Bilder, Bitmaps und Metadateien
• Arbeiten mit Bildern, Bitmaps, Symbolen und Metadateien