Bitmap Bitmap Bitmap Bitmap Constructors

Definition

Überlädt

Bitmap(Image) Bitmap(Image) Bitmap(Image) 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(Stream) Bitmap(Stream) 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(String) Bitmap(String) Bitmap(String) 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(Image, Size) Bitmap(Image, Size) Bitmap(Image, 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) Bitmap(Int32, Int32) Bitmap(Int32, Int32) 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(Stream, Boolean) Bitmap(Stream, Boolean) 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, Boolean) Bitmap(String, Boolean) Bitmap(String, Boolean) 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) Bitmap(Type, String) 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.

Bitmap(Image, Int32, Int32) Bitmap(Image, Int32, Int32) Bitmap(Image, Int32, Int32) 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(Int32, Int32, Graphics) Bitmap(Int32, Int32, Graphics) Bitmap(Int32, Int32, Graphics) 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, PixelFormat) Bitmap(Int32, Int32, PixelFormat) Bitmap(Int32, Int32, PixelFormat) 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(Int32, Int32, Int32, PixelFormat, IntPtr) Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr) Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr) 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(Image) Bitmap(Image) Bitmap(Image) 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.

public:
 Bitmap(System::Drawing::Image ^ original);
public Bitmap (System.Drawing.Image original);
new System.Drawing.Bitmap : System.Drawing.Image -> System.Drawing.Bitmap
Public Sub New (original As Image)

Parameter

original
Image Image Image Image

Der Image, aus dem die neue Bitmap erstellt werden soll.The Image from which to create the new Bitmap.

Bitmap(Stream) Bitmap(Stream) 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.

public:
 Bitmap(System::IO::Stream ^ stream);
public Bitmap (System.IO.Stream stream);
new System.Drawing.Bitmap : System.IO.Stream -> System.Drawing.Bitmap

Parameter

stream
Stream Stream Stream Stream

Der zum Laden des Bildes verwendete Datenstream.The data stream used to load the image.

Ausnahmen

stream enthält keine Bilddaten oder ist null.stream does not contain image data or is null.

- oder --or- stream enthält eine eindimensionale PNG-Bilddatei, deren Umfang 65.535 Pixel überschreitet.stream contains a PNG image file with a single dimension greater than 65,535 pixels.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Bitmap aus einem Stream geladen wird.The following code example demonstrates how to load a bitmap from a stream.

Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert.This example is designed to be used with Windows Forms. Erstellen Sie ein Formular, das PictureBox ein PictureBox1mit dem Namen enthält.Create a form that contains a PictureBox named PictureBox1. Fügen Sie den Code in das Formular ein, InitializeStreamBitmap und nennen Sie die-Methode aus dem Load Konstruktor des Formulars oder der Ereignis Behandlungsmethode.Paste the code into the form and call the InitializeStreamBitmap method from the form's constructor or Load event-handling method.

void InitializeStreamBitmap()
{
   try
   {
      System::Net::WebRequest^ request = System::Net::WebRequest::Create( "http://www.microsoft.com//h/en-us/r/ms_masthead_ltr.gif" );
      System::Net::WebResponse^ response = request->GetResponse();
      System::IO::Stream^ responseStream = response->GetResponseStream();
      Bitmap^ bitmap2 = gcnew Bitmap( responseStream );
      PictureBox1->Image = bitmap2;
   }
   catch ( System::Net::WebException^ ) 
   {
      MessageBox::Show( "There was an error opening the image file."
      "Check the URL" );
   }

}
private void InitializeStreamBitmap()
{
    try
    {
        System.Net.WebRequest request = 
            System.Net.WebRequest.Create(
            "http://www.microsoft.com//h/en-us/r/ms_masthead_ltr.gif");
        System.Net.WebResponse response = request.GetResponse();
        System.IO.Stream responseStream = 
            response.GetResponseStream();
        Bitmap bitmap2 = new Bitmap(responseStream);
        PictureBox1.Image = bitmap2;

    }
    catch(System.Net.WebException)
    {
        MessageBox.Show("There was an error opening the image file."
           + "Check the URL");
    }
}
Private Sub InitializeStreamBitmap()
    Try
        Dim request As System.Net.WebRequest = _
            System.Net.WebRequest.Create( _
            "http://www.microsoft.com//h/en-us/r/ms_masthead_ltr.gif")
        Dim response As System.Net.WebResponse = request.GetResponse()
        Dim responseStream As System.IO.Stream = response.GetResponseStream()
        Dim bitmap2 As New Bitmap(responseStream)
        PictureBox1.Image = bitmap2

    Catch ex As System.Net.WebException
        MessageBox.Show("There was an error opening the image file. Check the URL")
    End Try
End Sub

Hinweise

Der Stream muss für die Lebensdauer von Bitmapgeöffnet bleiben.You must keep the stream open for the lifetime of the Bitmap.

Aufgrund einer Einschränkung des Decoders GDI+GDI+ wird eine System.ArgumentException ausgelöst, wenn Sie eine Bitmap aus einer PNG-Bilddatei mit einer einzelnen Dimension erstellen, die größer als 65.535 Pixel ist.Due to a limitation of the GDI+GDI+ decoder, an System.ArgumentException is thrown if you construct a bitmap from a .png image file with a single dimension greater than 65,535 pixels.

Siehe auch

Bitmap(String) Bitmap(String) Bitmap(String) 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.

public:
 Bitmap(System::String ^ filename);
public Bitmap (string filename);
new System.Drawing.Bitmap : string -> System.Drawing.Bitmap
Public Sub New (filename As String)

Parameter

filename
String String String String

Der Dateiname und Pfad der Bitmapdatei.The bitmap file name and path.

Ausnahmen

Die angegebene Datei wurde nicht gefunden.The specified file is not found.

Hinweise

Der Dateiname und der Pfad können relativ zur Anwendung oder als absoluter Pfad sein.The file name and path can be relative to the application or an absolute path. Verwenden Sie diesen Konstruktor, um Bilder mit den folgenden Dateiformaten zu öffnen: BMP, GIF, EXIF, JPG, PNG und TIFF.Use this constructor to open images with 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. Die Datei bleibt gesperrt, bis Bitmap der verworfen wird.The file remains locked until the Bitmap is disposed.

Siehe auch

Bitmap(Image, Size) Bitmap(Image, Size) Bitmap(Image, 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.

public:
 Bitmap(System::Drawing::Image ^ original, System::Drawing::Size newSize);
public Bitmap (System.Drawing.Image original, System.Drawing.Size newSize);
new System.Drawing.Bitmap : System.Drawing.Image * System.Drawing.Size -> System.Drawing.Bitmap
Public Sub New (original As Image, newSize As Size)

Parameter

original
Image Image Image Image

Der Image, aus dem die neue Bitmap erstellt werden soll.The Image from which to create the new Bitmap.

newSize
Size Size Size Size

Die Size-Struktur, die die Größe der neuen Bitmap darstellt.The Size structure that represent the size of the new Bitmap.

Ausnahmen

Fehler bei diesem Vorgang.The operation failed.

Bitmap(Int32, Int32) Bitmap(Int32, Int32) Bitmap(Int32, Int32) 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.

public:
 Bitmap(int width, int height);
public Bitmap (int width, int height);
new System.Drawing.Bitmap : int * int -> System.Drawing.Bitmap
Public Sub New (width As Integer, height As Integer)

Parameter

width
Int32 Int32 Int32 Int32

Die Breite der neuen Bitmap in Pixel.The width, in pixels, of the new Bitmap.

height
Int32 Int32 Int32 Int32

Die Höhe der neuen Bitmap in Pixel.The height, in pixels, of the new Bitmap.

Ausnahmen

Fehler bei diesem Vorgang.The operation failed.

Hinweise

Dieser Konstruktor erstellt ein Bitmap -Element PixelFormat mit einem-Enumerationswert von Format32bppArgb.This constructor creates a Bitmap with a PixelFormat enumeration value of Format32bppArgb.

Bitmap(Stream, Boolean) Bitmap(Stream, Boolean) 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.

public:
 Bitmap(System::IO::Stream ^ stream, bool useIcm);
public Bitmap (System.IO.Stream stream, bool useIcm);
new System.Drawing.Bitmap : System.IO.Stream * bool -> System.Drawing.Bitmap

Parameter

stream
Stream Stream Stream Stream

Der zum Laden des Bildes verwendete Datenstream.The data stream used to load the image.

useIcm
Boolean Boolean Boolean Boolean

true, wenn für diese Bitmap Farbkorrektur verwendet werden soll, andernfalls false.true to use color correction for this Bitmap; otherwise, false.

Ausnahmen

stream enthält keine Bilddaten oder ist null.stream does not contain image data or is null.

- oder --or- stream enthält eine eindimensionale PNG-Bilddatei, deren Umfang 65.535 Pixel überschreitet.stream contains a PNG image file with a single dimension greater than 65,535 pixels.

Hinweise

Der Stream muss für die Lebensdauer von Bitmapgeöffnet bleiben.You must keep the stream open for the lifetime of the Bitmap.

Aufgrund einer Einschränkung des Decoders GDI+GDI+ wird eine System.ArgumentException ausgelöst, wenn Sie eine Bitmap aus einer PNG-Bilddatei mit einer einzelnen Dimension erstellen, die größer als 65.535 Pixel ist.Due to a limitation of the GDI+GDI+ decoder, an System.ArgumentException is thrown if you construct a bitmap from a .png image file with a single dimension greater than 65,535 pixels.

Siehe auch

Bitmap(String, Boolean) Bitmap(String, Boolean) Bitmap(String, Boolean) 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.

public:
 Bitmap(System::String ^ filename, bool useIcm);
public Bitmap (string filename, bool useIcm);
new System.Drawing.Bitmap : string * bool -> System.Drawing.Bitmap
Public Sub New (filename As String, useIcm As Boolean)

Parameter

filename
String String String String

Der Name der Bitmapdatei.The name of the bitmap file.

useIcm
Boolean Boolean Boolean Boolean

true, wenn für diese Bitmap Farbkorrektur verwendet werden soll, andernfalls false.true to use color correction for this Bitmap; otherwise, false.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine neue Bitmap aus einer Datei erstellen.The following code example demonstrates how to construct a new bitmap from a file. In diesem Beispiel werden GetPixel die SetPixel -Methode und die-Methode verwendet, um das Bild neu zuThe example uses the GetPixel and SetPixel methods to recolor the image. Außerdem wird die PixelFormat -Eigenschaft verwendet.It also uses the PixelFormat property.

Dieses Beispiel wurde entworfen, um mit einem Windows-Formular 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 Form that contains a Label, PictureBox and Button named Label1, PictureBox1 and Button1, respectively. Fügen Sie den Code in das Formular ein, Button1_Click und ordnen Sie die Methode Click dem-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

Verwenden Sie diesen Konstruktor, um Bilder mit den folgenden Dateiformaten zu öffnen: BMP, GIF, EXIF, JPG, PNG und TIFF.Use this constructor to open images with 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. Die Datei bleibt gesperrt, bis Bitmap der verworfen wird.The file remains locked until the Bitmap is disposed.

Sicherheit

SecurityPermission
zum Aufrufen von nicht verwaltetem Code.for calling into unmanaged code. Verwandte Enumeration:UnmanagedCodeRelated enumeration: UnmanagedCode

Siehe auch

Bitmap(Type, String) Bitmap(Type, String) 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.

public:
 Bitmap(Type ^ type, System::String ^ resource);
public Bitmap (Type type, string resource);
new System.Drawing.Bitmap : Type * string -> System.Drawing.Bitmap

Parameter

type
Type Type Type Type

Die Klasse, mit der die Ressource extrahiert wird.The class used to extract the resource.

resource
String String String String

Der Name der Ressource.The name of the resource.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine Bitmap aus einem-Typ erstellen und wie Sie Save die-Methode verwenden.The following code example demonstrates how to construct a bitmap from a type, and how to use the Save method. Fügen Sie den Code in ein Windows Form ein, um dieses Beispiel auszuführen.To run this example, paste the code into a Windows Form. Behandeln Sie das- Paint Ereignis des Formulars, ConstructFromResourceSaveAsGif und nennen Sie e die-Methode, indem Sie alsPaintEventArgsHandle the form's Paint event and call the ConstructFromResourceSaveAsGif method, passing e as PaintEventArgs

private:
    void ConstructFromResourceSaveAsGif(PaintEventArgs^ e)
    {
        // Construct a bitmap from the button image resource.
        Bitmap^ bmp1 = gcnew Bitmap(Button::typeid, "Button.bmp");
        String^ savePath =  
            Environment::GetEnvironmentVariable("TEMP") + "\\Button.bmp";

        try
        {
            // Save the image as a GIF.
            bmp1->Save(savePath, System::Drawing::Imaging::ImageFormat::Gif);
        }
        catch (IOException^)
        {
            // Carry on regardless
        }

        // Construct a new image from the GIF file.
        Bitmap^ bmp2 = nullptr;
        if (File::Exists(savePath))
        {
            bmp2 = gcnew Bitmap(savePath);
        }

        // Draw the two images.
        e->Graphics->DrawImage(bmp1, Point(10, 10));

        // If bmp1 did not save to disk, bmp2 may be null
        if (bmp2 != nullptr)
        {
            e->Graphics->DrawImage(bmp2, Point(10, 40));
        }

        // Dispose of the image files.
        delete bmp1;
        if (bmp2 != nullptr)
        {
            delete bmp2;
        }
    }
private void ConstructFromResourceSaveAsGif(PaintEventArgs e)
{

    // Construct a bitmap from the button image resource.
    Bitmap bmp1 = new Bitmap(typeof(Button), "Button.bmp");

    // Save the image as a GIF.
    bmp1.Save("c:\\button.gif", System.Drawing.Imaging.ImageFormat.Gif);

    // Construct a new image from the GIF file.
    Bitmap bmp2 = new Bitmap("c:\\button.gif");

    // Draw the two images.
    e.Graphics.DrawImage(bmp1, new Point(10, 10));
    e.Graphics.DrawImage(bmp2, new Point(10, 40));

    // Dispose of the image files.
    bmp1.Dispose();
    bmp2.Dispose();
}
Private Sub ConstructFromResourceSaveAsGif(ByVal e As PaintEventArgs)

    ' Construct a bitmap from the button image resource.
    Dim bmp1 As New Bitmap(GetType(Button), "Button.bmp")

    ' Save the image as a GIF.
    bmp1.Save("c:\button.gif", System.Drawing.Imaging.ImageFormat.Gif)

    ' Construct a new image from the GIF file.
    Dim bmp2 As New Bitmap("c:\button.gif")

    ' Draw the two images.
    e.Graphics.DrawImage(bmp1, New Point(10, 10))
    e.Graphics.DrawImage(bmp2, New Point(10, 40))

    ' Dispose of the image files.
    bmp1.Dispose()
    bmp2.Dispose()
End Sub

Hinweise

Dieser Konstruktor kombiniert den Namespace des angegebenen Typs mit dem Zeichen folgen Namen der Ressource und sucht im Assemblymanifest nach einer Entsprechung.This constructor combines the namespace of the given type with the string name of the resource and looks for a match in the assembly manifest. Beispielsweise können Sie den Button -Typ und Button.bmp an diesen Konstruktor übergeben, und es wird nach einer Ressource mit System.Windows.Forms.Button.bmpdem Namen gesucht.For example you can pass in the Button type and Button.bmp to this constructor and it will look for a resource named System.Windows.Forms.Button.bmp.

Siehe auch

Bitmap(Image, Int32, Int32) Bitmap(Image, Int32, Int32) Bitmap(Image, Int32, Int32) 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.

public:
 Bitmap(System::Drawing::Image ^ original, int width, int height);
public Bitmap (System.Drawing.Image original, int width, int height);
new System.Drawing.Bitmap : System.Drawing.Image * int * int -> System.Drawing.Bitmap
Public Sub New (original As Image, width As Integer, height As Integer)

Parameter

original
Image Image Image Image

Der Image, aus dem die neue Bitmap erstellt werden soll.The Image from which to create the new Bitmap.

width
Int32 Int32 Int32 Int32

Die Breite der neuen Bitmap in Pixel.The width, in pixels, of the new Bitmap.

height
Int32 Int32 Int32 Int32

Die Höhe der neuen Bitmap in Pixel.The height, in pixels, of the new Bitmap.

Ausnahmen

Fehler bei diesem Vorgang.The operation failed.

Bitmap(Int32, Int32, Graphics) Bitmap(Int32, Int32, Graphics) Bitmap(Int32, Int32, Graphics) 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.

public:
 Bitmap(int width, int height, System::Drawing::Graphics ^ g);
public Bitmap (int width, int height, System.Drawing.Graphics g);
new System.Drawing.Bitmap : int * int * System.Drawing.Graphics -> System.Drawing.Bitmap
Public Sub New (width As Integer, height As Integer, g As Graphics)

Parameter

width
Int32 Int32 Int32 Int32

Die Breite der neuen Bitmap in Pixel.The width, in pixels, of the new Bitmap.

height
Int32 Int32 Int32 Int32

Die Höhe der neuen Bitmap in Pixel.The height, in pixels, of the new Bitmap.

g
Graphics Graphics Graphics Graphics

Das Graphics-Objekt, das die Auflösung für die neue Bitmap angibt.The Graphics object that specifies the resolution for the new Bitmap.

Ausnahmen

Hinweise

Die neue Bitmap , diese Methode erstellt akzeptiert die horizontale und vertikale Auflösung aus der DpiX und DpiY Eigenschaften gbzw.The new Bitmap that this method creates takes its horizontal and vertical resolution from the DpiX and DpiY properties of g, respectively.

Bitmap(Int32, Int32, PixelFormat) Bitmap(Int32, Int32, PixelFormat) Bitmap(Int32, Int32, PixelFormat) 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.

public:
 Bitmap(int width, int height, System::Drawing::Imaging::PixelFormat format);
public Bitmap (int width, int height, System.Drawing.Imaging.PixelFormat format);
new System.Drawing.Bitmap : int * int * System.Drawing.Imaging.PixelFormat -> System.Drawing.Bitmap
Public Sub New (width As Integer, height As Integer, format As PixelFormat)

Parameter

width
Int32 Int32 Int32 Int32

Die Breite der neuen Bitmap in Pixel.The width, in pixels, of the new Bitmap.

height
Int32 Int32 Int32 Int32

Die Höhe der neuen Bitmap in Pixel.The height, in pixels, of the new Bitmap.

format
PixelFormat PixelFormat PixelFormat PixelFormat

Das Pixelformat für die neue Bitmap.The pixel format for the new Bitmap. Dies muss einen Wert angeben, der mit Format beginnt.This must specify a value that begins with Format.

Ausnahmen

Ein PixelFormat-Wert wird angegeben, dessen Name nicht mit Format beginnt.A PixelFormat value is specified whose name does not start with Format. Die Angabe von Gdi verursacht z. B. eine ArgumentException, Format48bppRgb hingegen nicht.For example, specifying Gdi will cause an ArgumentException, but Format48bppRgb will not.

Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr) Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr) Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr) 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.

public:
 Bitmap(int width, int height, int stride, System::Drawing::Imaging::PixelFormat format, IntPtr scan0);
public Bitmap (int width, int height, int stride, System.Drawing.Imaging.PixelFormat format, IntPtr scan0);
new System.Drawing.Bitmap : int * int * int * System.Drawing.Imaging.PixelFormat * nativeint -> System.Drawing.Bitmap
Public Sub New (width As Integer, height As Integer, stride As Integer, format As PixelFormat, scan0 As IntPtr)

Parameter

width
Int32 Int32 Int32 Int32

Die Breite der neuen Bitmap in Pixel.The width, in pixels, of the new Bitmap.

height
Int32 Int32 Int32 Int32

Die Höhe der neuen Bitmap in Pixel.The height, in pixels, of the new Bitmap.

stride
Int32 Int32 Int32 Int32

Ganze Zahl, die den Byteoffset zwischen dem Anfang einer Scanzeile und der nächsten angibt.Integer that specifies the byte offset between the beginning of one scan line and the next. Dabei handelt es sich normalerweise (aber nicht zwingend) um die Anzahl von Bytes im Pixelformat (z. B. 2 für 16 Bits pro Pixel) multipliziert mit der Breite der Bitmap.This is usually (but not necessarily) the number of bytes in the pixel format (for example, 2 for 16 bits per pixel) multiplied by the width of the bitmap. Der an diesen Parameter übergebene Wert muss ein Vielfaches von 4 sein.The value passed to this parameter must be a multiple of four.

format
PixelFormat PixelFormat PixelFormat PixelFormat

Das Pixelformat für die neue Bitmap.The pixel format for the new Bitmap. Dies muss einen Wert angeben, der mit Format beginnt.This must specify a value that begins with Format.

scan0
IntPtr IntPtr IntPtr IntPtr

Zeiger auf ein Array von Bytes, das die Pixeldaten enthält.Pointer to an array of bytes that contains the pixel data.

Ausnahmen

Ein PixelFormat-Wert wird angegeben, dessen Name nicht mit Format beginnt.A PixelFormat value is specified whose name does not start with Format. Die Angabe von Gdi verursacht z. B. eine ArgumentException, Format48bppRgb hingegen nicht.For example, specifying Gdi will cause an ArgumentException, but Format48bppRgb will not.

Beispiele

Im folgenden Codebeispiel wird die Verwendung des Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr) -Konstruktors veranschaulicht.The following code example shows how to use the Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr) constructor. Dieses Beispiel ist für die PaintEventArgs Paint Verwendung mit Windows Forms konzipiert und erfordert einen-Parameter, bei dem es sich um einen Parameter des-Ereignisses handelt.This example is designed to be used with Windows Forms and requires a PaintEventArgs parameter, which is a parameter of the Paint event.

private void BitmapConstructorEx(PaintEventArgs e)
{

    // Create a bitmap.
    Bitmap bmp = new Bitmap("c:\\fakePhoto.jpg");
    
   // Retrieve the bitmap data from the bitmap.
    System.Drawing.Imaging.BitmapData bmpData = bmp.LockBits(new Rectangle(0, 0, bmp.Width, bmp.Height), 
        ImageLockMode.ReadOnly, bmp.PixelFormat);

    //Create a new bitmap.
    Bitmap newBitmap = new Bitmap(200, 200, bmpData.Stride, bmp.PixelFormat, bmpData.Scan0);

    bmp.UnlockBits(bmpData);

    // Draw the new bitmap.
    e.Graphics.DrawImage(newBitmap, 10, 10);

}
Private Sub BitmapConstructorEx(ByVal e As PaintEventArgs)

    ' Create a bitmap.
    Dim bmp As New Bitmap("c:\fakePhoto.jpg")

    ' Retrieve the bitmap data from the bitmap.
    Dim bmpData As System.Drawing.Imaging.BitmapData = bmp.LockBits(New Rectangle(0, 0, bmp.Width, bmp.Height), _
        ImageLockMode.ReadOnly, bmp.PixelFormat)

    'Create a new bitmap.
    Dim newBitmap As New Bitmap(200, 200, bmpData.Stride, bmp.PixelFormat, bmpData.Scan0)

    bmp.UnlockBits(bmpData)

    ' Draw the new bitmap.
    e.Graphics.DrawImage(newBitmap, 10, 10)

End Sub

Hinweise

Der Aufrufer ist für das zuordnen und Freigeben des Speicherblocks zuständig, scan0 der durch den-Parameter angegeben wird.The caller is responsible for allocating and freeing the block of memory specified by the scan0 parameter. Der Arbeitsspeicher sollte jedoch erst freigegeben werden, wenn Bitmap die zugehörige freigegeben wurde.However, the memory should not be released until the related Bitmap is released.

Sicherheit

SecurityPermission
zum Aufrufen von nicht verwaltetem Code.for calling into unmanaged code. Verwandte Enumeration:UnmanagedCodeRelated enumeration: UnmanagedCode

Gilt für: