Bitmap Classe

Definizione

Spazio dei nomi:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Pacchetto:: System.Drawing.Common v11.0.0-preview.3.26207.106

Origine:: Bitmap.cs

Origine:: Bitmap.cs

Origine:: Bitmap.cs

Origine:: Bitmap.cs

Origine:: Bitmap.cs

Origine:: Bitmap.cs

Origine:: Bitmap.cs

Origine:: Bitmap.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Incapsula una bitmap GDI+ costituita dai dati pixel per un'immagine grafica e i relativi attributi. Un Bitmap oggetto è un oggetto utilizzato per lavorare con immagini definite dai dati pixel.

public ref class Bitmap sealed : System::Drawing::Image

[System.Serializable]
public sealed class Bitmap : System.Drawing.Image

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class Bitmap : System.Drawing.Image

public sealed class Bitmap : System.Drawing.Image

[<System.Serializable>]
type Bitmap = class
    inherit Image

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Bitmap = class
    inherit Image

type Bitmap = class
    inherit Image

Public NotInheritable Class Bitmap
Inherits Image

Ereditarietà: Object

MarshalByRefObject

Image
Bitmap

Attributi: SerializableAttribute ComVisibleAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come costruire un nuovo Bitmap oggetto da un file usando i GetPixel metodi e SetPixel per ricolorare l'immagine. Usa anche le PixelFormatproprietà , Widthe Height .

Questo esempio è progettato per essere usato con windows Form che contiene rispettivamente un Labeloggetto , PictureBoxe Button denominato Label1, PictureBox1e Button1. Incollare il codice nel form e associare il Button1_Click metodo all'evento del Click pulsante.

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

Una bitmap è costituita dai dati pixel per un'immagine grafica e dai relativi attributi. Esistono molti formati standard per salvare una bitmap in un file. GDI+ supporta i formati di file seguenti: BMP, GIF, EXIF, JPG, PNG e TIFF. Per altre informazioni sui formati supportati, vedere Tipi di bitmap.

È possibile creare immagini da file, flussi e altre origini usando uno dei Bitmap costruttori e salvarle in un flusso o nel file system con il Save metodo . Le immagini vengono disegnate sullo schermo o in memoria usando il DrawImage metodo dell'oggetto Graphics . Per un elenco di argomenti sull'uso dei file di immagine, vedere Uso di immagini, bitmap, icone e metafile.

Note

In .NET 6 e versioni successive il pacchetto System.Drawing.Common, che include questo tipo, è supportato solo nei sistemi operativi Windows. L'uso di questo tipo nelle app multipiattaforma causa avvisi in fase di compilazione ed eccezioni in fase di esecuzione. Per altre informazioni, vedere System.Drawing.Common supportato solo in Windows.

Note

La Bitmap classe non è accessibile tra domini applicazione. Ad esempio, se si crea un oggetto dinamico AppDomain e si creano diversi pennelli, penne e bitmap in tale dominio, quindi passare di nuovo questi oggetti al dominio applicazione principale, è possibile usare correttamente le penne e i pennelli. Tuttavia, se si chiama il DrawImage metodo per disegnare il marshalling Bitmap, si riceve l'eccezione seguente:

La comunicazione remota non è in grado di trovare il campo "immagine nativa" nel tipo "System.Drawing.Image".

Costruttori

Nome	Descrizione
Bitmap(Image, Int32, Int32)	Inizializza una nuova istanza della Bitmap classe dall'immagine esistente specificata, ridimensionata in base alle dimensioni specificate.
Bitmap(Image, Size)	Inizializza una nuova istanza della Bitmap classe dall'immagine esistente specificata, ridimensionata in base alle dimensioni specificate.
Bitmap(Image)	Inizializza una nuova istanza della Bitmap classe dall'immagine esistente specificata.
Bitmap(Int32, Int32, Graphics)	Inizializza una nuova istanza della Bitmap classe con le dimensioni specificate e con la risoluzione dell'oggetto specificato Graphics .
Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr)	Inizializza una nuova istanza della Bitmap classe con le dimensioni, il formato pixel e i dati pixel specificati.
Bitmap(Int32, Int32, PixelFormat)	Inizializza una nuova istanza della Bitmap classe con le dimensioni e il formato specificati.
Bitmap(Int32, Int32)	Inizializza una nuova istanza della Bitmap classe con le dimensioni specificate.
Bitmap(Stream, Boolean)	Inizializza una nuova istanza della Bitmap classe dal flusso di dati specificato.
Bitmap(Stream)	Inizializza una nuova istanza della Bitmap classe dal flusso di dati specificato.
Bitmap(String, Boolean)	Inizializza una nuova istanza della Bitmap classe dal file specificato.
Bitmap(String)	Inizializza una nuova istanza della Bitmap classe dal file specificato.
Bitmap(Type, String)	Inizializza una nuova istanza della Bitmap classe da una risorsa specificata.

Proprietà

Nome	Descrizione
Flags	Ottiene i flag di attributo per i dati pixel di questo Imageoggetto . (Ereditato da Image)
FrameDimensionsList	Ottiene una matrice di GUID che rappresentano le dimensioni dei fotogrammi all'interno di questo Imageoggetto . (Ereditato da Image)
Height	Ottiene l'altezza, in pixel, di questo Imageoggetto . (Ereditato da Image)
HorizontalResolution	Ottiene la risoluzione orizzontale, espressa in pixel per pollice, di questo Imageoggetto . (Ereditato da Image)
Palette	Ottiene o imposta la tavolozza dei colori utilizzata per l'oggetto Image. (Ereditato da Image)
PhysicalDimension	Ottiene la larghezza e l'altezza dell'immagine. (Ereditato da Image)
PixelFormat	Ottiene il formato pixel per questo Imageoggetto . (Ereditato da Image)
PropertyIdList	Ottiene gli ID degli elementi della proprietà archiviati in questo Imageoggetto . (Ereditato da Image)
PropertyItems	Ottiene tutti gli elementi della proprietà (parti di metadati) archiviati in questo Imageoggetto . (Ereditato da Image)
RawFormat	Ottiene il formato di file dell'oggetto Image. (Ereditato da Image)
Size	Ottiene la larghezza e l'altezza, in pixel, di questa immagine. (Ereditato da Image)
Tag	Ottiene o imposta un oggetto che fornisce dati aggiuntivi sull'immagine. (Ereditato da Image)
VerticalResolution	Ottiene la risoluzione verticale, espressa in pixel per pollice, di questo Imageoggetto . (Ereditato da Image)
Width	Ottiene la larghezza, in pixel, di questo Imageoggetto . (Ereditato da Image)

Metodi

Nome	Descrizione
ApplyEffect(Effect, Rectangle)	Modifica la bitmap applicando l'oggetto specificato `effect`.
Clone()	Crea una copia esatta di questo Imageoggetto . (Ereditato da Image)
Clone(Rectangle, PixelFormat)	Crea una copia della sezione di definita Bitmap dalla Rectangle struttura e con un'enumerazione specificata PixelFormat .
Clone(RectangleF, PixelFormat)	Crea una copia della sezione di definita Bitmap con un'enumerazione specificata PixelFormat .
ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single)	Converte la bitmap nell'oggetto specificato `format` utilizzando l'oggetto specificato `ditherType`. I dati pixel originali vengono sostituiti con il nuovo formato.
ConvertFormat(PixelFormat)	Converte la bitmap nell'oggetto specificato `format`. I dati pixel originali vengono sostituiti con il nuovo formato.
CreateObjRef(Type)	Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia tutte le risorse usate da questo Imageoggetto . (Ereditato da Image)
Dispose(Boolean)	Rilascia le risorse non gestite usate da Image e, facoltativamente, rilascia le risorse gestite. (Ereditato da Image)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FromHicon(IntPtr)	Crea un oggetto Bitmap da un handle di Windows a un'icona.
FromResource(IntPtr, String)	Crea un oggetto Bitmap dalla risorsa di Windows specificata.
GetBounds(GraphicsUnit)	Ottiene i limiti dell'immagine nell'unità specificata. (Ereditato da Image)
GetEncoderParameterList(Guid)	Restituisce informazioni sui parametri supportati dal codificatore di immagini specificato. (Ereditato da Image)
GetFrameCount(FrameDimension)	Restituisce il numero di fotogrammi della dimensione specificata. (Ereditato da Image)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetHbitmap()	Crea un oggetto bitmap GDI da questo Bitmapoggetto .
GetHbitmap(Color)	Crea un oggetto bitmap GDI da questo Bitmapoggetto .
GetHicon()	Restituisce l'handle a un'icona.
GetLifetimeService()	Obsoleti. Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
GetPixel(Int32, Int32)	Ottiene il colore del pixel specificato in questo Bitmapoggetto .
GetPropertyItem(Int32)	Ottiene l'elemento della proprietà specificato da questo Imageoggetto . (Ereditato da Image)
GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr)	Restituisce un'anteprima per l'oggetto Image. (Ereditato da Image)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Obsoleti. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)	Blocca un oggetto Bitmap nella memoria di sistema.
LockBits(Rectangle, ImageLockMode, PixelFormat)	Blocca un oggetto Bitmap nella memoria di sistema.
MakeTransparent()	Rende trasparente il colore trasparente predefinito per questo Bitmapoggetto .
MakeTransparent(Color)	Rende trasparente il colore specificato per questo Bitmapoggetto .
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (Ereditato da MarshalByRefObject)
RemovePropertyItem(Int32)	Rimuove l'elemento della proprietà specificato da questo Imageoggetto . (Ereditato da Image)
RotateFlip(RotateFlipType)	Ruota, capovolge o ruota e capovolge l'oggetto Image. (Ereditato da Image)
Save(Stream, ImageCodecInfo, EncoderParameters)	Salva questa immagine nel flusso specificato, con i parametri del codificatore e del codificatore di immagini specificati. (Ereditato da Image)
Save(Stream, ImageFormat)	Salva questa immagine nel flusso specificato nel formato specificato. (Ereditato da Image)
Save(String, ImageCodecInfo, EncoderParameters)	Salva questo valore Image nel file specificato, con i parametri del codificatore e del codificatore di immagini specificati. (Ereditato da Image)
Save(String, ImageFormat)	Salva questo Image valore nel file specificato nel formato specificato. (Ereditato da Image)
Save(String)	Salva l'oggetto Image nel file o nel flusso specificato. (Ereditato da Image)
SaveAdd(EncoderParameters)	Aggiunge un frame al file o al flusso specificato in una chiamata precedente al Save metodo . Usare questo metodo per salvare i fotogrammi selezionati da un'immagine a più fotogrammi in un'altra immagine con più fotogrammi. (Ereditato da Image)
SaveAdd(Image, EncoderParameters)	Aggiunge un frame al file o al flusso specificato in una chiamata precedente al Save metodo . (Ereditato da Image)
SelectActiveFrame(FrameDimension, Int32)	Seleziona il frame specificato dalla dimensione e dall'indice. (Ereditato da Image)
SetPixel(Int32, Int32, Color)	Imposta il colore del pixel specificato in questo Bitmapoggetto .
SetPropertyItem(PropertyItem)	Archivia un elemento della proprietà (parte di metadati) in questo Imageoggetto . (Ereditato da Image)
SetResolution(Single, Single)	Imposta la risoluzione per l'oggetto Bitmap.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
UnlockBits(BitmapData)	Sblocca questo valore Bitmap dalla memoria di sistema.

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Popola un SerializationInfo oggetto con i dati necessari per serializzare l'oggetto di destinazione. (Ereditato da Image)

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?