Bitmap Constructors

Definitie

Initialiseert een nieuw exemplaar van de Bitmap klasse.

Overloads

Name Description
Bitmap(Image)

Initialiseert een nieuw exemplaar van de Bitmap klasse op basis van de opgegeven bestaande installatiekopieën.

Bitmap(Stream)

Initialiseert een nieuw exemplaar van de Bitmap klasse vanuit de opgegeven gegevensstroom.

Bitmap(String)

Initialiseert een nieuw exemplaar van de Bitmap klasse uit het opgegeven bestand.

Bitmap(Image, Size)

Initialiseert een nieuw exemplaar van de Bitmap klasse van de opgegeven bestaande installatiekopieën, geschaald naar de opgegeven grootte.

Bitmap(Int32, Int32)

Initialiseert een nieuw exemplaar van de Bitmap klasse met de opgegeven grootte.

Bitmap(Stream, Boolean)

Initialiseert een nieuw exemplaar van de Bitmap klasse vanuit de opgegeven gegevensstroom.

Bitmap(String, Boolean)

Initialiseert een nieuw exemplaar van de Bitmap klasse uit het opgegeven bestand.

Bitmap(Type, String)

Initialiseert een nieuw exemplaar van de Bitmap klasse van een opgegeven resource.

Bitmap(Image, Int32, Int32)

Initialiseert een nieuw exemplaar van de Bitmap klasse van de opgegeven bestaande installatiekopieën, geschaald naar de opgegeven grootte.

Bitmap(Int32, Int32, Graphics)

Initialiseert een nieuw exemplaar van de Bitmap klasse met de opgegeven grootte en met de resolutie van het opgegeven Graphics object.

Bitmap(Int32, Int32, PixelFormat)

Initialiseert een nieuw exemplaar van de Bitmap klasse met de opgegeven grootte en indeling.

Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr)

Initialiseert een nieuw exemplaar van de Bitmap klasse met de opgegeven grootte, pixelnotatie en pixelgegevens.

Bitmap(Image)

Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs

Initialiseert een nieuw exemplaar van de Bitmap klasse op basis van de opgegeven bestaande installatiekopieën.

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)

Parameters

original
Image

De Image waaruit de nieuwe Bitmapmoet worden gemaakt.

Van toepassing op

Bitmap(Stream)

Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs

Initialiseert een nieuw exemplaar van de Bitmap klasse vanuit de opgegeven gegevensstroom.

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

Parameters

stream
Stream

De gegevensstroom die wordt gebruikt om de afbeelding te laden.

Uitzonderingen

stream bevat geen afbeeldingsgegevens of is null.

– of –

stream bevat een PNG-afbeeldingsbestand met één dimensie groter dan 65.535 pixels.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een bitmap uit een stream laadt.

Dit voorbeeld is ontworpen voor gebruik met Windows Forms. Maak een formulier met een PictureBox naam PictureBox1. Plak de code in het formulier en roep de InitializeStreamBitmap methode aan vanuit de constructor- of Load gebeurtenisafhandelingsmethode van het formulier.

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

Opmerkingen

U moet de stream open houden voor de levensduur van de Bitmap.

Vanwege een beperking van de GDI+-decoder wordt er een System.ArgumentException gegenereerd als u een bitmap maakt van een .png afbeeldingsbestand met één dimensie groter dan 65.535 pixels.

Zie ook

Van toepassing op

Bitmap(String)

Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs

Initialiseert een nieuw exemplaar van de Bitmap klasse uit het opgegeven bestand.

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

Parameters

filename
String

De naam en het pad van het bitmapbestand.

Uitzonderingen

Het opgegeven bestand is niet gevonden.

Opmerkingen

De bestandsnaam en het pad kunnen relatief zijn ten opzichte van de toepassing of een absoluut pad. Gebruik deze constructor om afbeeldingen te openen met de volgende bestandsindelingen: BMP, GIF, EXIF, JPG, PNG en TIFF. Zie Typen bitmaps voor meer informatie over ondersteunde indelingen. Het bestand blijft vergrendeld totdat het Bitmap wordt verwijderd.

Zie ook

Van toepassing op

Bitmap(Image, Size)

Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs

Initialiseert een nieuw exemplaar van de Bitmap klasse van de opgegeven bestaande installatiekopieën, geschaald naar de opgegeven grootte.

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)

Parameters

original
Image

De Image waaruit de nieuwe Bitmapmoet worden gemaakt.

newSize
Size

De Size structuur die de grootte van de nieuwe Bitmapvertegenwoordigt.

Uitzonderingen

De bewerking is mislukt.

Van toepassing op

Bitmap(Int32, Int32)

Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs

Initialiseert een nieuw exemplaar van de Bitmap klasse met de opgegeven grootte.

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)

Parameters

width
Int32

De breedte, in pixels, van de nieuwe Bitmap.

height
Int32

De hoogte, in pixels, van de nieuwe Bitmap.

Uitzonderingen

De bewerking is mislukt.

Opmerkingen

Deze constructor maakt een Bitmap met een PixelFormat opsommingswaarde van Format32bppArgb.

Van toepassing op

Bitmap(Stream, Boolean)

Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs

Initialiseert een nieuw exemplaar van de Bitmap klasse vanuit de opgegeven gegevensstroom.

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
Public Sub New (stream As Stream, useIcm As Boolean)

Parameters

stream
Stream

De gegevensstroom die wordt gebruikt om de afbeelding te laden.

useIcm
Boolean

true om hiervoor kleurcorrectie Bitmapte gebruiken ; falseanders .

Uitzonderingen

stream bevat geen afbeeldingsgegevens of is null.

– of –

stream bevat een PNG-afbeeldingsbestand met één dimensie groter dan 65.535 pixels.

Opmerkingen

U moet de stream open houden voor de levensduur van de Bitmap.

Vanwege een beperking van de GDI+-decoder wordt er een System.ArgumentException gegenereerd als u een bitmap maakt van een .png afbeeldingsbestand met één dimensie groter dan 65.535 pixels.

Zie ook

Van toepassing op

Bitmap(String, Boolean)

Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs

Initialiseert een nieuw exemplaar van de Bitmap klasse uit het opgegeven bestand.

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)

Parameters

filename
String

De naam van het bitmapbestand.

useIcm
Boolean

true om hiervoor kleurcorrectie Bitmapte gebruiken ; falseanders .

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een nieuwe bitmap maakt op basis van een bestand. In het voorbeeld worden de GetPixel en SetPixel methoden gebruikt om de kleur van de afbeelding te wijzigen. De eigenschap wordt ook gebruikt PixelFormat .

Dit voorbeeld is ontworpen voor gebruik met een Windows formulier dat respectievelijk een Label, PictureBox en Button met de naam Label1, PictureBox1 en Button1. Plak de code in het formulier en koppel de Button1_Click methode aan de gebeurtenis van Click de knop.

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

Opmerkingen

Gebruik deze constructor om afbeeldingen te openen met de volgende bestandsindelingen: BMP, GIF, EXIF, JPG, PNG en TIFF. Zie Typen bitmaps voor meer informatie over ondersteunde indelingen. Het bestand blijft vergrendeld totdat het Bitmap wordt verwijderd.

Zie ook

Van toepassing op

Bitmap(Type, String)

Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs

Initialiseert een nieuw exemplaar van de Bitmap klasse van een opgegeven resource.

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

Parameters

type
Type

De klasse die wordt gebruikt om de resource te extraheren.

resource
String

De naam van de resource.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een bitmap maakt van een type en hoe u de Save methode gebruikt. Als u dit voorbeeld wilt uitvoeren, plakt u de code in een Windows formulier. De gebeurtenis van Paint het formulier afhandelen en de ConstructFromResourceSaveAsGif methode aanroepen, waarbij deze wordt doorgegeven e als 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

Opmerkingen

Deze constructor combineert de naamruimte van het opgegeven type met de tekenreeksnaam van de resource en zoekt naar een overeenkomst in het assemblymanifest. U kunt bijvoorbeeld het Button-type en Button.bmp doorgeven aan deze constructor en er wordt gezocht naar een resource met de naam System.Windows.Forms.Button.bmp.

Zie ook

Van toepassing op

Bitmap(Image, Int32, Int32)

Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs

Initialiseert een nieuw exemplaar van de Bitmap klasse van de opgegeven bestaande installatiekopieën, geschaald naar de opgegeven grootte.

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)

Parameters

original
Image

De Image waaruit de nieuwe Bitmapmoet worden gemaakt.

width
Int32

De breedte, in pixels, van de nieuwe Bitmap.

height
Int32

De hoogte, in pixels, van de nieuwe Bitmap.

Uitzonderingen

De bewerking is mislukt.

Van toepassing op

Bitmap(Int32, Int32, Graphics)

Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs

Initialiseert een nieuw exemplaar van de Bitmap klasse met de opgegeven grootte en met de resolutie van het opgegeven 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)

Parameters

width
Int32

De breedte, in pixels, van de nieuwe Bitmap.

height
Int32

De hoogte, in pixels, van de nieuwe Bitmap.

g
Graphics

Het Graphics object dat de resolutie voor het nieuwe Bitmapobject aangeeft.

Uitzonderingen

Opmerkingen

De nieuwe Bitmap die met deze methode wordt gemaakt, neemt de horizontale en verticale resolutie van respectievelijk de DpiX eigenschappen en DpiY eigenschappen van g.

Van toepassing op

Bitmap(Int32, Int32, PixelFormat)

Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs

Initialiseert een nieuw exemplaar van de Bitmap klasse met de opgegeven grootte en indeling.

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)

Parameters

width
Int32

De breedte, in pixels, van de nieuwe Bitmap.

height
Int32

De hoogte, in pixels, van de nieuwe Bitmap.

format
PixelFormat

De pixelindeling voor de nieuwe Bitmap. Hiermee moet een waarde worden opgegeven die begint met Format.

Uitzonderingen

Er wordt een PixelFormat waarde opgegeven waarvan de naam niet begint met Format. Als u bijvoorbeeld opgeeft Gdi , wordt een ArgumentException, maar Format48bppRgb niet veroorzaakt.

Van toepassing op

Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr)

Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs
Bron:
Bitmap.cs

Initialiseert een nieuw exemplaar van de Bitmap klasse met de opgegeven grootte, pixelnotatie en pixelgegevens.

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)

Parameters

width
Int32

De breedte, in pixels, van de nieuwe Bitmap.

height
Int32

De hoogte, in pixels, van de nieuwe Bitmap.

stride
Int32

Geheel getal dat de byteverschil aangeeft tussen het begin van de ene scanregel en de volgende. Dit is meestal (maar niet noodzakelijkerwijs) het aantal bytes in de pixelnotatie (bijvoorbeeld 2 voor 16 bits per pixel) vermenigvuldigd met de breedte van de bitmap. De waarde die aan deze parameter wordt doorgegeven, moet een veelvoud van vier zijn.

format
PixelFormat

De pixelindeling voor de nieuwe Bitmap. Hiermee moet een waarde worden opgegeven die begint met Format.

scan0
IntPtr

nativeint

Wijs een matrix aan van bytes die de pixelgegevens bevat.

Uitzonderingen

Er wordt een PixelFormat waarde opgegeven waarvan de naam niet begint met Format. Als u bijvoorbeeld opgeeft Gdi , wordt een ArgumentException, maar Format48bppRgb niet veroorzaakt.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr) constructor gebruikt. Dit voorbeeld is ontworpen voor gebruik met Windows Forms en vereist een PaintEventArgs parameter, een parameter van de gebeurtenis Paint.

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

Opmerkingen

De aanroeper is verantwoordelijk voor het toewijzen en vrijmaken van het geheugenblok dat is opgegeven door de scan0 parameter. Het geheugen mag echter pas worden vrijgegeven als de gerelateerde Bitmap gegevens zijn vrijgegeven.

Van toepassing op