Bitmap Klasse

Definition

Kapselt eine GDI+-Bitmap, die aus den Pixeldaten für eine Grafik und deren Attributen besteht.Encapsulates a GDI+ bitmap, which consists of the pixel data for a graphics image and its attributes. Eine Bitmap wird für die Arbeit mit Bildern verwendet, die durch Pixeldaten definiert sind.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
Vererbung
Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein neues Bitmap aus einer Datei erstellt wird, wobei die GetPixel-Methode und die SetPixel-Methode verwendet werden, um das Bild neu zu erstellen.The following code example demonstrates how to construct a new Bitmap from a file, using the GetPixel and SetPixel methods to recolor the image. Außerdem werden die Eigenschaften "PixelFormat", "Width" und "Height" verwendet.It also uses the PixelFormat, Width, and Height properties.

Dieses Beispiel wurde entworfen, um mit einer Windows Forms verwendet werden, enthalten eine Label, PictureBox, und Button mit dem Namen Label1, PictureBox1, und Button1bzw.This example is designed to be used with a Windows Forms that contains a Label, PictureBox, and Button named Label1, PictureBox1, and Button1, respectively. Fügen Sie den Code in das Formular ein, und ordnen Sie die Button1_Click-Methode dem Click-Ereignis der Schaltfläche zu.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

Hinweise

Eine Bitmap besteht aus den Pixeldaten für ein Grafik Bild und seine Attribute.A bitmap consists of the pixel data for a graphics image and its attributes. Es gibt viele Standardformate zum Speichern einer Bitmap in einer Datei.There are many standard formats for saving a bitmap to a file. GDI+GDI+ unterstützt die folgenden Dateiformate: BMP, GIF, EXIF, JPG, PNG und TIFF.supports the following file formats: BMP, GIF, EXIF, JPG, PNG and TIFF. Weitere Informationen zu unterstützten Formaten finden Sie unter Typen von Bitmaps.For more information about supported formats, see Types of Bitmaps.

Sie können Bilder aus Dateien, Streams und anderen Quellen erstellen, indem Sie einen der Bitmap-Konstruktoren verwenden und Sie mit der Save-Methode in einem Stream oder im Dateisystem speichern.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. Bilder werden mithilfe der DrawImage-Methode des Graphics-Objekts auf dem Bildschirm oder in den Arbeitsspeicher gezeichnet.Images are drawn to the screen or to memory by using the DrawImage method of the Graphics object. Eine Liste der Themen zum Arbeiten mit Bilddateien finden Sie unter Arbeiten mit Bildern, Bitmaps, Symbolen und Metadatendateien.For a list of topics about working with image files, see Working with Images, Bitmaps, Icons, and Metafiles.

Hinweis

Der Zugriff auf die Bitmap-Klasse ist über Anwendungs Domänen hinweg nicht möglich.The Bitmap class is not accessible across application domains. Wenn Sie z. b. eine dynamische AppDomain erstellen und mehrere Pinsel, Stifte und Bitmaps in dieser Domäne erstellen und diese Objekte dann wieder an die Haupt Anwendungsdomäne übergeben, können Sie die Stifte und Pinsel erfolgreich verwenden.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. Wenn Sie jedoch die DrawImage-Methode aufrufen, um das gemarshallte Bitmap zu zeichnen, wird die folgende Ausnahme angezeigt.However, if you call the DrawImage method to draw the marshaled Bitmap, you receive the following exception.

Remoting kann das Feld "Natives Image" für den Typ "System. Drawing. Image" nicht finden.Remoting cannot find field "native image" on type "System.Drawing.Image".

Konstruktoren

Bitmap(Image)

Initialisiert eine neue Instanz der Bitmap-Klasse aus dem angegebenen vorhandenen Bild.Initializes a new instance of the Bitmap class from the specified existing image.

Bitmap(Image, Int32, Int32)

Initialisiert eine neue Instanz der Bitmap-Klasse aus dem angegebenen vorhandenen Bild, skaliert auf die angegebene Größe.Initializes a new instance of the Bitmap class from the specified existing image, scaled to the specified size.

Bitmap(Image, Size)

Initialisiert eine neue Instanz der Bitmap-Klasse aus dem angegebenen vorhandenen Bild, skaliert auf die angegebene Größe.Initializes a new instance of the Bitmap class from the specified existing image, scaled to the specified size.

Bitmap(Int32, Int32)

Initialisiert eine neue Instanz der Bitmap-Klasse mit der angegebenen Größe.Initializes a new instance of the Bitmap class with the specified size.

Bitmap(Int32, Int32, Graphics)

Initialisiert eine neue Instanz der Bitmap-Klasse mit der angegebenen Größe und der Auflösung des angegebenen Graphics-Objekts.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)

Initialisiert eine neue Instanz der Bitmap-Klasse mit der angegebenen Größe, dem Pixelformat und den Pixeldaten.Initializes a new instance of the Bitmap class with the specified size, pixel format, and pixel data.

Bitmap(Int32, Int32, PixelFormat)

Initialisiert eine neue Instanz der Bitmap-Klasse mit der angegebenen Größe und dem angegebenen Format.Initializes a new instance of the Bitmap class with the specified size and format.

Bitmap(Stream)

Initialisiert eine neue Instanz der Bitmap-Klasse aus dem angegebenen Stream.Initializes a new instance of the Bitmap class from the specified data stream.

Bitmap(Stream, Boolean)

Initialisiert eine neue Instanz der Bitmap-Klasse aus dem angegebenen Stream.Initializes a new instance of the Bitmap class from the specified data stream.

Bitmap(String)

Initialisiert eine neue Instanz der Bitmap-Klasse aus der angegebenen Datei.Initializes a new instance of the Bitmap class from the specified file.

Bitmap(String, Boolean)

Initialisiert eine neue Instanz der Bitmap-Klasse aus der angegebenen Datei.Initializes a new instance of the Bitmap class from the specified file.

Bitmap(Type, String)

Initialisiert eine neue Instanz der Bitmap-Klasse aus einer angegebenen Ressource.Initializes a new instance of the Bitmap class from a specified resource.

Eigenschaften

Flags

Ruft Attributflags für die Pixeldaten dieses Image ab.Gets attribute flags for the pixel data of this Image.

(Geerbt von Image)
FrameDimensionsList

Ruft ein Array von GUIDs ab, die die Abmessungen der Rahmen in diesem Image darstellen.Gets an array of GUIDs that represent the dimensions of frames within this Image.

(Geerbt von Image)
Height

Ruft die Höhe dieses Image in Pixel ab.Gets the height, in pixels, of this Image.

(Geerbt von Image)
HorizontalResolution

Ruft die horizontale Auflösung dieses Image in Pixel pro Zoll ab.Gets the horizontal resolution, in pixels per inch, of this Image.

(Geerbt von Image)
Palette

Ruft die für dieses Image verwendete Farbpalette ab oder legt diese fest.Gets or sets the color palette used for this Image.

(Geerbt von Image)
PhysicalDimension

Ruft die Breite und Höhe dieses Bilds ab.Gets the width and height of this image.

(Geerbt von Image)
PixelFormat

Ruft das Pixelformat für dieses Image ab.Gets the pixel format for this Image.

(Geerbt von Image)
PropertyIdList

Ruft IDs für die in diesem Image gespeicherten Eigenschaftenelemente ab.Gets IDs of the property items stored in this Image.

(Geerbt von Image)
PropertyItems

Ruft alle in diesem Image gespeicherten Eigenschaftenelemente (Metadaten) ab.Gets all the property items (pieces of metadata) stored in this Image.

(Geerbt von Image)
RawFormat

Ruft das Dateiformat dieses Image ab.Gets the file format of this Image.

(Geerbt von Image)
Size

Ruft die Breite und Höhe dieses Bilds in Pixel ab.Gets the width and height, in pixels, of this image.

(Geerbt von Image)
Tag

Ruft ein Objekt ab, das zusätzliche Daten zu dem Bild bereitstellt, oder legt dieses Objekt fest.Gets or sets an object that provides additional data about the image.

(Geerbt von Image)
VerticalResolution

Ruft die vertikale Auflösung dieses Image in Pixel pro Zoll ab.Gets the vertical resolution, in pixels per inch, of this Image.

(Geerbt von Image)
Width

Ruft die Breite dieses Image in Pixel ab.Gets the width, in pixels, of this Image.

(Geerbt von Image)

Methoden

Clone()

Erstellt eine genaue Kopie von dieser Image.Creates an exact copy of this 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.Creates a copy of the section of this Bitmap defined by Rectangle structure and with a specified PixelFormat enumeration.

Clone(RectangleF, PixelFormat)

Erstellt eine Kopie des Abschnitts dieser Bitmap, die mit einer angegebenen PixelFormat-Enumeration definiert wird.Creates a copy of the section of this Bitmap defined with a specified PixelFormat enumeration.

CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle von dieser Image verwendeten Ressourcen frei.Releases all resources used by this Image.

(Geerbt von Image)
Dispose(Boolean)

Gibt die von Image verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the Image and optionally releases the managed resources.

(Geerbt von Image)
Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
FromHicon(IntPtr)

Erstellt eine Bitmap aus einem Windows-Handle für ein Symbol.Creates a Bitmap from a Windows handle to an icon.

FromResource(IntPtr, String)

Erstellt eine Bitmap aus der angegebenen Windows-Ressource.Creates a Bitmap from the specified Windows resource.

GetBounds(GraphicsUnit)

Ruft die Grenzen des Bilds in der angegebenen Einheit ab.Gets the bounds of the image in the specified unit.

(Geerbt von Image)
GetEncoderParameterList(Guid)

Gibt Informationen über die Parameter zurück, die vom angegebenen Bildencoder unterstützt werden.Returns information about the parameters supported by the specified image encoder.

(Geerbt von Image)
GetFrameCount(FrameDimension)

Gibt die Anzahl der Rahmen in der angegebenen Abmessung zurück.Returns the number of frames of the specified dimension.

(Geerbt von Image)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetHbitmap()

Erstellt ein GDIGDI-Bitmapobjekt aus dieser Bitmap.Creates a GDIGDI bitmap object from this Bitmap.

GetHbitmap(Color)

Erstellt ein GDIGDI-Bitmapobjekt aus dieser Bitmap.Creates a GDIGDI bitmap object from this Bitmap.

GetHicon()

Gibt das Handle für ein Symbol zurück.Returns the handle to an icon.

GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
GetPixel(Int32, Int32)

Ruft die Farbe des angegebenen Pixels in dieser Bitmap ab.Gets the color of the specified pixel in this Bitmap.

GetPropertyItem(Int32)

Ruft das angegebene Eigenschaftenelement aus diesem Image ab.Gets the specified property item from this Image.

(Geerbt von Image)
GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr)

Gibt eine Miniaturansicht für dieses Image zurück.Returns a thumbnail for this Image.

(Geerbt von Image)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
LockBits(Rectangle, ImageLockMode, PixelFormat)

Sperrt eine Bitmap im Systemspeicher.Locks a Bitmap into system memory.

LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)

Sperrt eine Bitmap im Systemspeicher.Locks a Bitmap into system memory.

MakeTransparent()

Macht die standardmäßige transparente Farbe für diese Bitmap transparent.Makes the default transparent color transparent for this Bitmap.

MakeTransparent(Color)

Bewirkt, dass die angegebene Farbe für diese Bitmap transparent wird.Makes the specified color transparent for this Bitmap.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Geerbt von MarshalByRefObject)
RemovePropertyItem(Int32)

Entfernt das angegebene Eigenschaftenelement aus diesem Image.Removes the specified property item from this Image.

(Geerbt von Image)
RotateFlip(RotateFlipType)

Dreht und/oder kippt das Image.Rotates, flips, or rotates and flips the Image.

(Geerbt von Image)
Save(Stream, ImageCodecInfo, EncoderParameters)

Speichert dieses Bild mit den angegebenen Encoder- und Bildencoderparametern im angegebenen Stream.Saves this image to the specified stream, with the specified encoder and image encoder parameters.

(Geerbt von Image)
Save(Stream, ImageFormat)

Speichert dieses Bild im angegebenen Format im angegebenen Stream.Saves this image to the specified stream in the specified format.

(Geerbt von Image)
Save(String)

Speichert dieses Image in der angegebenen Datei oder dem Stream.Saves this Image to the specified file or stream.

(Geerbt von Image)
Save(String, ImageCodecInfo, EncoderParameters)

Speichert dieses Image mit den angegebenen Encoder- und Bildencoderparametern in der angegebenen Datei.Saves this Image to the specified file, with the specified encoder and image-encoder parameters.

(Geerbt von Image)
Save(String, ImageFormat)

Speichert dieses Image im angegebenen Format in der angegebenen Datei.Saves this Image to the specified file in the specified format.

(Geerbt von Image)
SaveAdd(EncoderParameters)

Fügt der in einem vorherigen Aufruf der Save-Methode angegebenen Datei bzw. dem Stream einen Rahmen hinzu.Adds a frame to the file or stream specified in a previous call to the Save method. Mit dieser Methode speichern Sie ausgewählte Rahmen eines Bilds mit mehreren Rahmen in einem anderen Bild mit mehreren Rahmen.Use this method to save selected frames from a multiple-frame image to another multiple-frame image.

(Geerbt von Image)
SaveAdd(Image, EncoderParameters)

Fügt der in einem vorherigen Aufruf der Save-Methode angegebenen Datei bzw. dem Stream einen Rahmen hinzu.Adds a frame to the file or stream specified in a previous call to the Save method.

(Geerbt von Image)
SelectActiveFrame(FrameDimension, Int32)

Wählt den durch die angegebene Abmessung und den Index angegebenen Rahmen aus.Selects the frame specified by the dimension and index.

(Geerbt von Image)
SetPixel(Int32, Int32, Color)

Legt die Farbe des angegebenen Pixels in dieser Bitmap fest.Sets the color of the specified pixel in this Bitmap.

SetPropertyItem(PropertyItem)

Speichert ein Eigenschaftenelement (Metadaten) in diesem Image.Stores a property item (piece of metadata) in this Image.

(Geerbt von Image)
SetResolution(Single, Single)

Legt die Auflösung für diese Bitmap fest.Sets the resolution for this Bitmap.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
UnlockBits(BitmapData)

Hebt die Sperre dieser Bitmap im Systemspeicher auf.Unlocks this Bitmap from system memory.

Explizite Schnittstellenimplementierungen

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Füllt eine SerializationInfo mit den Daten auf, die zum Serialisieren des Zielobjekts erforderlich sind.Populates a SerializationInfo with the data needed to serialize the target object.

(Geerbt von Image)

Gilt für:

Siehe auch