Bitmap Bitmap Bitmap Bitmap Constructors

Definizione

Overload

Bitmap(Image) Bitmap(Image) Bitmap(Image) Bitmap(Image)

Inizializza una nuova istanza della classe Bitmap a partire dall'immagine esistente.Initializes a new instance of the Bitmap class from the specified existing image.

Bitmap(Stream) Bitmap(Stream) Bitmap(Stream)

Inizializza una nuova istanza della classe Bitmap dal flusso dei dati specificato.Initializes a new instance of the Bitmap class from the specified data stream.

Bitmap(String) Bitmap(String) Bitmap(String) Bitmap(String)

Inizializza una nuova istanza della classe Bitmap dal file specificato.Initializes a new instance of the Bitmap class from the specified file.

Bitmap(Image, Size) Bitmap(Image, Size) Bitmap(Image, Size) Bitmap(Image, Size)

Inizializza una nuova istanza della classe Bitmap dall'immagine specificata esistente, adattata in base alle dimensioni indicate.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)

Inizializza una nuova istanza della classe Bitmap con le dimensioni specificate.Initializes a new instance of the Bitmap class with the specified size.

Bitmap(Stream, Boolean) Bitmap(Stream, Boolean) Bitmap(Stream, Boolean)

Inizializza una nuova istanza della classe Bitmap dal flusso dei dati specificato.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)

Inizializza una nuova istanza della classe Bitmap dal file specificato.Initializes a new instance of the Bitmap class from the specified file.

Bitmap(Type, String) Bitmap(Type, String) Bitmap(Type, String)

Inizializza una nuova istanza della classe Bitmap da una risorsa specificata.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)

Inizializza una nuova istanza della classe Bitmap dall'immagine specificata esistente, adattata in base alle dimensioni indicate.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)

Inizializza una nuova istanza della classe Bitmap con le dimensioni specificate e la risoluzione dell'oggetto Graphics indicato.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)

Inizializza una nuova istanza della classe Bitmap con le dimensioni e il formato specificati.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)

Inizializza una nuova istanza della classe Bitmap con le dimensioni, il formato pixel e i dati pixel specificati.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)

Inizializza una nuova istanza della classe Bitmap a partire dall'immagine esistente.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)

Parametri

original
Image Image Image Image

Oggetto Image da cui creare il nuovo oggetto Bitmap.The Image from which to create the new Bitmap.

Bitmap(Stream) Bitmap(Stream) Bitmap(Stream)

Inizializza una nuova istanza della classe Bitmap dal flusso dei dati specificato.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

Parametri

stream
Stream Stream Stream Stream

Flusso di dati utilizzato per caricare l'immagine.The data stream used to load the image.

Eccezioni

stream non contiene dati di immagine o è null.stream does not contain image data or is null.

-oppure--or- stream contiene un file di immagine PNG con una singola dimensione superiore a 65.535 pixel.stream contains a PNG image file with a single dimension greater than 65,535 pixels.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come caricare una bitmap da un flusso.The following code example demonstrates how to load a bitmap from a stream.

Questo esempio è progettato per essere usato con Windows Forms.This example is designed to be used with Windows Forms. Creare un modulo che contenga un PictureBox denominato PictureBox1.Create a form that contains a PictureBox named PictureBox1. Incollare il codice nel form e chiamare il metodo InitializeStreamBitmap dal costruttore del form o dal metodo di gestione degli eventi Load.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

Commenti

È necessario lasciare aperto il flusso per la durata del Bitmap.You must keep the stream open for the lifetime of the Bitmap.

A causa di una limitazione del decodificatore GDI+GDI+, viene generata una System.ArgumentException se si costruisce una bitmap da un file di immagine con estensione png con una singola dimensione maggiore di 65.535 pixel.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.

Vedi anche

Bitmap(String) Bitmap(String) Bitmap(String) Bitmap(String)

Inizializza una nuova istanza della classe Bitmap dal file specificato.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)

Parametri

filename
String String String String

Nome e percorso del file bitmap.The bitmap file name and path.

Eccezioni

Il file specificato non è stato trovato.The specified file is not found.

Commenti

Il nome e il percorso del file possono essere relativi all'applicazione o a un percorso assoluto.The file name and path can be relative to the application or an absolute path. Utilizzare questo costruttore per aprire immagini con i formati di file seguenti: BMP, GIF, EXIF, JPG, PNG e TIFF.Use this constructor to open images with the following file formats: BMP, GIF, EXIF, JPG, PNG and TIFF. Per ulteriori informazioni sui formati supportati, vedere tipi di bitmap.For more information about supported formats, see Types of Bitmaps. Il file rimane bloccato fino a quando non viene eliminato il Bitmap.The file remains locked until the Bitmap is disposed.

Vedi anche

Bitmap(Image, Size) Bitmap(Image, Size) Bitmap(Image, Size) Bitmap(Image, Size)

Inizializza una nuova istanza della classe Bitmap dall'immagine specificata esistente, adattata in base alle dimensioni indicate.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)

Parametri

original
Image Image Image Image

Oggetto Image da cui creare il nuovo oggetto Bitmap.The Image from which to create the new Bitmap.

newSize
Size Size Size Size

Struttura Size che rappresenta le dimensioni del nuovo oggetto Bitmap.The Size structure that represent the size of the new Bitmap.

Eccezioni

Operazione non riuscita.The operation failed.

Bitmap(Int32, Int32) Bitmap(Int32, Int32) Bitmap(Int32, Int32) Bitmap(Int32, Int32)

Inizializza una nuova istanza della classe Bitmap con le dimensioni specificate.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)

Parametri

width
Int32 Int32 Int32 Int32

Larghezza, in pixel, del nuovo oggetto Bitmap.The width, in pixels, of the new Bitmap.

height
Int32 Int32 Int32 Int32

Altezza, in pixel, del nuovo oggetto Bitmap.The height, in pixels, of the new Bitmap.

Eccezioni

Operazione non riuscita.The operation failed.

Commenti

Questo costruttore crea un Bitmap con un valore di enumerazione PixelFormat di Format32bppArgb.This constructor creates a Bitmap with a PixelFormat enumeration value of Format32bppArgb.

Bitmap(Stream, Boolean) Bitmap(Stream, Boolean) Bitmap(Stream, Boolean)

Inizializza una nuova istanza della classe Bitmap dal flusso dei dati specificato.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

Parametri

stream
Stream Stream Stream Stream

Flusso di dati utilizzato per caricare l'immagine.The data stream used to load the image.

useIcm
Boolean Boolean Boolean Boolean

true per utilizzare la correzione dei colori per questo oggetto Bitmap; in caso contrario, false.true to use color correction for this Bitmap; otherwise, false.

Eccezioni

stream non contiene dati di immagine o è null.stream does not contain image data or is null.

In alternativa-or- stream contiene un file di immagine PNG con una singola dimensione superiore a 65.535 pixel.stream contains a PNG image file with a single dimension greater than 65,535 pixels.

Commenti

È necessario lasciare aperto il flusso per la durata del Bitmap.You must keep the stream open for the lifetime of the Bitmap.

A causa di una limitazione del decodificatore GDI+GDI+, viene generata una System.ArgumentException se si costruisce una bitmap da un file di immagine con estensione png con una singola dimensione maggiore di 65.535 pixel.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.

Vedi anche

Bitmap(String, Boolean) Bitmap(String, Boolean) Bitmap(String, Boolean) Bitmap(String, Boolean)

Inizializza una nuova istanza della classe Bitmap dal file specificato.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)

Parametri

filename
String String String String

Nome del file bitmap.The name of the bitmap file.

useIcm
Boolean Boolean Boolean Boolean

true per utilizzare la correzione dei colori per questo oggetto Bitmap; in caso contrario, false.true to use color correction for this Bitmap; otherwise, false.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come creare una nuova bitmap da un file.The following code example demonstrates how to construct a new bitmap from a file. Nell'esempio vengono utilizzati i metodi GetPixel e SetPixel per ricolorare l'immagine.The example uses the GetPixel and SetPixel methods to recolor the image. USA anche la proprietà PixelFormat.It also uses the PixelFormat property.

Questo esempio è progettato per essere usato con un Windows Form che contiene una Label, PictureBox e Button denominate rispettivamente Label1, PictureBox1 e Button1.This example is designed to be used with a Windows Form that contains a Label, PictureBox and Button named Label1, PictureBox1 and Button1, respectively. Incollare il codice nel form e associare il metodo Button1_Click con l'evento Click del pulsante.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

Commenti

Utilizzare questo costruttore per aprire immagini con i formati di file seguenti: BMP, GIF, EXIF, JPG, PNG e TIFF.Use this constructor to open images with the following file formats: BMP, GIF, EXIF, JPG, PNG and TIFF. Per ulteriori informazioni sui formati supportati, vedere tipi di bitmap.For more information about supported formats, see Types of Bitmaps. Il file rimane bloccato fino a quando non viene eliminato il Bitmap.The file remains locked until the Bitmap is disposed.

Sicurezza

SecurityPermission
per chiamare codice non gestito.for calling into unmanaged code. Enumerazione correlata: UnmanagedCodeRelated enumeration: UnmanagedCode

Vedi anche

Bitmap(Type, String) Bitmap(Type, String) Bitmap(Type, String)

Inizializza una nuova istanza della classe Bitmap da una risorsa specificata.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

Parametri

type
Type Type Type Type

Classe utilizzata per estrarre la risorsa.The class used to extract the resource.

resource
String String String String

Nome della risorsa.The name of the resource.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come costruire una bitmap da un tipo e come utilizzare il metodo Save.The following code example demonstrates how to construct a bitmap from a type, and how to use the Save method. Per eseguire questo esempio, incollare il codice in un Windows Form.To run this example, paste the code into a Windows Form. Gestire l'evento Paint del form e chiamare il metodo ConstructFromResourceSaveAsGif, passando e come PaintEventArgsHandle 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

Commenti

Questo costruttore combina lo spazio dei nomi del tipo specificato con il nome di stringa della risorsa e cerca una corrispondenza nel manifesto dell'assembly.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. Ad esempio, è possibile passare il tipo Button e Button.bmp a questo costruttore e cercherà una risorsa denominata System.Windows.Forms.Button.bmp.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.

Vedi anche

Bitmap(Image, Int32, Int32) Bitmap(Image, Int32, Int32) Bitmap(Image, Int32, Int32) Bitmap(Image, Int32, Int32)

Inizializza una nuova istanza della classe Bitmap dall'immagine specificata esistente, adattata in base alle dimensioni indicate.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)

Parametri

original
Image Image Image Image

Image da cui creare il nuovo Bitmap.The Image from which to create the new Bitmap.

width
Int32 Int32 Int32 Int32

Larghezza, in pixel, del nuovo oggetto Bitmap.The width, in pixels, of the new Bitmap.

height
Int32 Int32 Int32 Int32

Altezza, in pixel, del nuovo oggetto Bitmap.The height, in pixels, of the new Bitmap.

Eccezioni

Operazione non riuscita.The operation failed.

Bitmap(Int32, Int32, Graphics) Bitmap(Int32, Int32, Graphics) Bitmap(Int32, Int32, Graphics) Bitmap(Int32, Int32, Graphics)

Inizializza una nuova istanza della classe Bitmap con le dimensioni specificate e la risoluzione dell'oggetto Graphics indicato.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)

Parametri

width
Int32 Int32 Int32 Int32

Larghezza, in pixel, del nuovo oggetto Bitmap.The width, in pixels, of the new Bitmap.

height
Int32 Int32 Int32 Int32

Altezza, in pixel, del nuovo oggetto Bitmap.The height, in pixels, of the new Bitmap.

g
Graphics Graphics Graphics Graphics

Oggetto Graphics che specifica la risoluzione del nuovo oggetto Bitmap.The Graphics object that specifies the resolution for the new Bitmap.

Eccezioni

Commenti

Il nuovo Bitmap creato da questo metodo prende la risoluzione orizzontale e verticale rispettivamente dalle proprietà DpiX e DpiY di g.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)

Inizializza una nuova istanza della classe Bitmap con le dimensioni e il formato specificati.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)

Parametri

width
Int32 Int32 Int32 Int32

Larghezza, in pixel, del nuovo oggetto Bitmap.The width, in pixels, of the new Bitmap.

height
Int32 Int32 Int32 Int32

Altezza, in pixel, del nuovo oggetto Bitmap.The height, in pixels, of the new Bitmap.

format
PixelFormat PixelFormat PixelFormat PixelFormat

Formato pixel per il nuovo oggetto Bitmap.The pixel format for the new Bitmap. Deve specificare un valore che inizia con Format.This must specify a value that begins with Format.

Eccezioni

Viene specificato un valore PixelFormat il cui nome non inizia con Format.A PixelFormat value is specified whose name does not start with Format. Ad esempio, specificare Gdi, provocherà un ArgumentException, al contrario di Format48bppRgb.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)

Inizializza una nuova istanza della classe Bitmap con le dimensioni, il formato pixel e i dati pixel specificati.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)

Parametri

width
Int32 Int32 Int32 Int32

Larghezza, in pixel, del nuovo oggetto Bitmap.The width, in pixels, of the new Bitmap.

height
Int32 Int32 Int32 Int32

Altezza, in pixel, del nuovo oggetto Bitmap.The height, in pixels, of the new Bitmap.

stride
Int32 Int32 Int32 Int32

Integer che specifica l'offset di byte tra l'inizio di una linea di digitalizzazione e la successiva.Integer that specifies the byte offset between the beginning of one scan line and the next. In genere, ma non necessariamente, rappresenta il numero di byte in formato di pixel (ad esempio, 2 x 16 bit per pixel) moltiplicato per la larghezza della 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. Il valore passato a questo parametro deve essere un multiplo di quattro.The value passed to this parameter must be a multiple of four.

format
PixelFormat PixelFormat PixelFormat PixelFormat

Formato pixel per il nuovo oggetto Bitmap.The pixel format for the new Bitmap. Deve specificare un valore che inizia con Format.This must specify a value that begins with Format.

scan0
IntPtr IntPtr IntPtr IntPtr

Puntatore a una matrice di byte in cui sono contenuti i dati del record.Pointer to an array of bytes that contains the pixel data.

Eccezioni

Viene specificato un valore PixelFormat il cui nome non inizia con Format.A PixelFormat value is specified whose name does not start with Format. Ad esempio, specificare Gdi, provocherà un ArgumentException, al contrario di Format48bppRgb.For example, specifying Gdi will cause an ArgumentException, but Format48bppRgb will not.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il costruttore Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr).The following code example shows how to use the Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr) constructor. Questo esempio è progettato per essere usato con Windows Forms e richiede un parametro PaintEventArgs, che è un parametro dell'evento Paint.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

Commenti

Il chiamante è responsabile dell'allocazione e della liberazione del blocco di memoria specificato dal parametro scan0.The caller is responsible for allocating and freeing the block of memory specified by the scan0 parameter. Tuttavia, la memoria non deve essere rilasciata finché non viene rilasciato il Bitmap correlato.However, the memory should not be released until the related Bitmap is released.

Sicurezza

SecurityPermission
per chiamare codice non gestito.for calling into unmanaged code. Enumerazione correlata: UnmanagedCodeRelated enumeration: UnmanagedCode

Si applica a