Bitmap Classe

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Origine:

Bitmap.cs

Incapsula una bitmap GDI+ costituita dai dati pixel di un'immagine e dai relativi attributi. Bitmap è un oggetto utilizzato per operare 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>]
type Bitmap = class
    inherit Image

Public NotInheritable Class Bitmap
Inherits Image

Ereditarietà

Object

MarshalByRefObject

Image

Bitmap

Attributi

SerializableAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come costruire un nuovo Bitmap 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 un Windows Forms che contiene rispettivamente , Labele denominato PictureBox1Label1, PictureBoxe ButtonButton1, . Incollare il codice nel modulo 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 salvarli in un flusso o nel file system con il Save metodo . Le immagini vengono disegnate sullo schermo o sulla memoria usando il DrawImage metodo dell'oggetto Graphics . Per un elenco di argomenti relativi all'uso dei file di immagine, vedere Uso di immagini, bitmap, icone e metafile.

Nota

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 e eccezioni in fase di esecuzione. Per altre informazioni, vedere System.Drawing.Common supportato solo in Windows.

Nota

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, passare di nuovo questi oggetti al dominio dell'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

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

Proprietà

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

Metodi

Clone()	Crea una copia esatta di questo Image. (Ereditato da Image)
Clone(Rectangle, PixelFormat)	Crea una copia della sezione dell'oggetto Bitmap definita dalla struttura Rectangle e con un'enumerazione PixelFormat specificata.
Clone(RectangleF, PixelFormat)	Crea una copia della sezione di questo oggetto Bitmap definita con un'enumerazione PixelFormat specificata.
CreateObjRef(Type)	Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
Dispose()	Rilascia tutte le risorse usate da questa classe Image. (Ereditato da Image)
Dispose(Boolean)	Rilascia le risorse non gestite usate da Image e, facoltativamente, 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 per un'icona.
FromResource(IntPtr, String)	Crea un oggetto Bitmap dalla risorsa di Windows specificata.
GetBounds(GraphicsUnit)	Ottiene i limiti dell'immagine nell'unità di misura specificata. (Ereditato da Image)
GetEncoderParameterList(Guid)	Restituisce informazioni sui parametri supportati dal codificatore di immagini specificato. (Ereditato da Image)
GetFrameCount(FrameDimension)	Restituisce il numero dei 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 per un'icona.
GetLifetimeService()	Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
GetPixel(Int32, Int32)	Ottiene il colore del pixel specificato in questo oggetto Bitmap.
GetPropertyItem(Int32)	Ottiene l'elemento di proprietà specificato da questo oggetto Image. (Ereditato da Image)
GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr)	Restituisce un'anteprima di questo oggetto Image. (Ereditato da Image)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
LockBits(Rectangle, ImageLockMode, PixelFormat)	Blocca un oggetto Bitmap nella memoria di sistema.
LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)	Blocca un oggetto Bitmap nella memoria di sistema.
MakeTransparent()	Rende trasparente il colore predefinito per l'oggetto Bitmap.
MakeTransparent(Color)	Rende trasparente il colore specificato per l'oggetto Bitmap.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
RemovePropertyItem(Int32)	Rimuove da questo oggetto Image l'elemento di proprietà specificato. (Ereditato da Image)
RotateFlip(RotateFlipType)	Ruota, capovolge o ruota e capovolge Image. (Ereditato da Image)
Save(Stream, ImageCodecInfo, EncoderParameters)	Salva questa immagine nel flusso specificato, con i parametri di codificatore specificato e codificatore di immagini. (Ereditato da Image)
Save(Stream, ImageFormat)	Salva questa immagine nel flusso e nel formato specificati. (Ereditato da Image)
Save(String)	Salva questo oggetto Image nel file o flusso specificato. (Ereditato da Image)
Save(String, ImageCodecInfo, EncoderParameters)	Salva l'immagine Image nel file specificato, con i parametri di codificatore specificato e di codificatore di immagini. (Ereditato da Image)
Save(String, ImageFormat)	Salva questo oggetto Image nel file e nel formato specificati. (Ereditato da Image)
SaveAdd(EncoderParameters)	Aggiunge un fotogramma al file o al flusso specificato in una precedente chiamata al metodo Save. Usare questo metodo per salvare i fotogrammi selezionati da un'immagine a più fotogrammi in un'altra immagine a più fotogrammi. (Ereditato da Image)
SaveAdd(Image, EncoderParameters)	Aggiunge un fotogramma al file o al flusso specificato in una precedente chiamata al metodo Save. (Ereditato da Image)
SelectActiveFrame(FrameDimension, Int32)	Seleziona il fotogramma specificato in base alla dimensione e all'indice. (Ereditato da Image)
SetPixel(Int32, Int32, Color)	Imposta il colore del pixel specificato in questo oggetto Bitmap.
SetPropertyItem(PropertyItem)	Archivia un elemento di proprietà (porzione di metadati) in questo oggetto Image. (Ereditato da Image)
SetResolution(Single, Single)	Imposta la risoluzione per questo oggetto Bitmap.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
UnlockBits(BitmapData)	Sblocca l'oggetto Bitmap dalla memoria di sistema.

Implementazioni dell'interfaccia esplicita

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Popola un oggetto SerializationInfo con i dati necessari per serializzare l'oggetto di destinazione. (Ereditato da Image)

Vedi anche

• PictureBox
• Immagini, bitmap e metafile
• Utilizzo di immagini, bitmap, icone e metafile