Bitmap Classe

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Source:

Bitmap.cs

Encapsule une bitmap GDI+, composée des données de pixels d’une image graphique et de ses attributs. Bitmap est un objet utilisé pour manipuler des images définies par des données de pixels.

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

Héritage

Object

MarshalByRefObject

Image

Bitmap

Attributs

SerializableAttribute

Exemples

L’exemple de code suivant montre comment construire un nouveau Bitmap à partir d’un fichier, à l’aide des GetPixel méthodes et SetPixel pour recolorer l’image. Il utilise également les PixelFormatpropriétés , Widthet Height .

Cet exemple est conçu pour être utilisé avec un Windows Forms qui contient respectivement , LabelPictureBox, et Button nommé Label1, PictureBox1et , et Button1. Collez le code dans le formulaire et associez la Button1_Click méthode à l’événement du Click bouton.

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

Remarques

Une bitmap se compose des données de pixels d’une image graphique et de ses attributs. Il existe de nombreux formats standard pour enregistrer une bitmap dans un fichier. GDI+ prend en charge les formats de fichiers suivants : BMP, GIF, EXIF, JPG, PNG et TIFF. Pour plus d’informations sur les formats pris en charge, consultez Types de bitmaps.

Vous pouvez créer des images à partir de fichiers, de flux et d’autres sources à l’aide de l’un Bitmap des constructeurs et les enregistrer dans un flux ou dans le système de fichiers avec la Save méthode . Les images sont dessinées vers l’écran ou dans la mémoire à l’aide de la DrawImage méthode de l’objet Graphics . Pour obtenir la liste des rubriques sur l’utilisation des fichiers image, consultez Utilisation d’images, bitmaps, icônes et métafichiers.

Notes

Dans .NET 6 et versions ultérieures, le package System.Drawing.Common, qui inclut ce type, est uniquement pris en charge sur les systèmes d’exploitation Windows. L’utilisation de ce type dans les applications multiplateformes entraîne des avertissements au moment de la compilation et des exceptions au moment de l’exécution. Pour plus d’informations, consultez System.Drawing.Common uniquement pris en charge sur Windows.

Notes

La Bitmap classe n’est pas accessible entre les domaines d’application. Par exemple, si vous créez une dynamique AppDomain et créez plusieurs pinceaux, stylets et bitmaps dans ce domaine, puis que vous transmettez ces objets au domaine d’application main, vous pouvez utiliser correctement les stylets et les pinceaux. Toutefois, si vous appelez la DrawImage méthode pour dessiner le marshalé Bitmap, vous recevez l’exception suivante :

La communication à distance ne trouve pas le champ « image native » sur le type « System.Drawing.Image ».

Constructeurs

Bitmap(Image)	Initialise une nouvelle instance de la classe Bitmap à partir de l'image existante spécifiée.
Bitmap(Image, Int32, Int32)	Initialise une nouvelle instance de la classe Bitmap à partir de l'image existante spécifiée, ajustée à la taille spécifiée.
Bitmap(Image, Size)	Initialise une nouvelle instance de la classe Bitmap à partir de l'image existante spécifiée, ajustée à la taille spécifiée.
Bitmap(Int32, Int32)	Initialise une nouvelle instance de la classe Bitmap avec la taille spécifiée.
Bitmap(Int32, Int32, Graphics)	Initialise une nouvelle instance de la classe Bitmap avec la taille spécifiée et la résolution de l'objet Graphics spécifié.
Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr)	Initialise une nouvelle instance de la classe Bitmap avec la taille ainsi que le format et les données de pixels spécifiés.
Bitmap(Int32, Int32, PixelFormat)	Initialise une nouvelle instance de la classe Bitmap avec la taille et le format spécifiés.
Bitmap(Stream)	Initialise une nouvelle instance de la classe Bitmap à partir du flux de données spécifié.
Bitmap(Stream, Boolean)	Initialise une nouvelle instance de la classe Bitmap à partir du flux de données spécifié.
Bitmap(String)	Initialise une nouvelle instance de la classe Bitmap à partir du fichier spécifié.
Bitmap(String, Boolean)	Initialise une nouvelle instance de la classe Bitmap à partir du fichier spécifié.
Bitmap(Type, String)	Initialise une nouvelle instance de la classe Bitmap à partir d'une ressource spécifiée.

Propriétés

Flags	Obtient des indicateurs d'attribut pour les données de pixels de ce Image. (Hérité de Image)
FrameDimensionsList	Obtient un tableau de GUID qui représentent les dimensions des frames dans ce Image. (Hérité de Image)
Height	Obtient la hauteur, en pixels, de cet objet Image. (Hérité de Image)
HorizontalResolution	Obtient la résolution horizontale, en pixels par pouce, de ce Image. (Hérité de Image)
Palette	Obtient ou définit la palette de couleurs de ce Image. (Hérité de Image)
PhysicalDimension	Obtient la largeur et la hauteur de cette image. (Hérité de Image)
PixelFormat	Obtient le format de pixel de ce Image. (Hérité de Image)
PropertyIdList	Obtient les ID des éléments de propriété stockés dans ce Image. (Hérité de Image)
PropertyItems	Obtient tous les éléments de propriété (métadonnées) stockés dans ce Image. (Hérité de Image)
RawFormat	Obtient le format de fichier de cette Image. (Hérité de Image)
Size	Obtient la largeur et la hauteur de cette image en pixels. (Hérité de Image)
Tag	Obtient ou définit un objet qui contient des données supplémentaires sur l'image. (Hérité de Image)
VerticalResolution	Obtient la résolution verticale, en pixels par pouce, de ce Image. (Hérité de Image)
Width	Obtient la largeur, en pixels, de cet objet Image. (Hérité de Image)

Méthodes

Clone()	Crée une copie exacte de Image. (Hérité de Image)
Clone(Rectangle, PixelFormat)	Crée une copie de la section de ce Bitmap définie par la structure Rectangle, avec une énumération PixelFormat spécifiée.
Clone(RectangleF, PixelFormat)	Crée une copie d'une section de ce Bitmap définie à l'aide d'une énumération PixelFormat spécifiée.
CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par ce Image. (Hérité de Image)
Dispose(Boolean)	Libère les ressources non managées utilisées par Image et libère éventuellement les ressources managées. (Hérité de Image)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
FromHicon(IntPtr)	Crée un Bitmap à partir du handle Windows d'une icône.
FromResource(IntPtr, String)	Crée un Bitmap à partir de la ressource Windows spécifiée.
GetBounds(GraphicsUnit)	Obtient les limites de l'image dans l'unité spécifiée. (Hérité de Image)
GetEncoderParameterList(Guid)	Retourne des informations sur les paramètres pris en charge par l'encodeur d'image spécifié. (Hérité de Image)
GetFrameCount(FrameDimension)	Retourne le nombre de frames de la dimension spécifiée. (Hérité de Image)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetHbitmap()	Crée un objet bitmap GDI à partir de ce Bitmap.
GetHbitmap(Color)	Crée un objet bitmap GDI à partir de ce Bitmap.
GetHicon()	Retourne le handle d'une icône.
GetLifetimeService()	Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetPixel(Int32, Int32)	Obtient la couleur du pixel spécifié dans ce Bitmap.
GetPropertyItem(Int32)	Obtient l'élément de propriété spécifié à partir de ce Image. (Hérité de Image)
GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr)	Retourne la miniature de ce Image. (Hérité de Image)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
LockBits(Rectangle, ImageLockMode, PixelFormat)	Verrouille Bitmap dans la mémoire système.
LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)	Verrouille Bitmap dans la mémoire système.
MakeTransparent()	Rend transparente la couleur transparente par défaut pour ce Bitmap.
MakeTransparent(Color)	Rend transparente la couleur spécifiée de ce Bitmap.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
RemovePropertyItem(Int32)	Supprime l'élément de propriété spécifié de ce Image. (Hérité de Image)
RotateFlip(RotateFlipType)	Fait pivoter ou retourne Image, ou le fait pivoter en le retournant. (Hérité de Image)
Save(Stream, ImageCodecInfo, EncoderParameters)	Enregistre cette image dans le flux spécifié, avec l'encodeur et les paramètres d'encodeur d'image définis. (Hérité de Image)
Save(Stream, ImageFormat)	Enregistre cette image dans le fichier spécifié au format spécifié. (Hérité de Image)
Save(String)	Enregistre ce Image dans le fichier ou le flux spécifié. (Hérité de Image)
Save(String, ImageCodecInfo, EncoderParameters)	Enregistre ce Image dans le fichier spécifié, avec l'encodeur et les paramètres d'encodeur d'image définis. (Hérité de Image)
Save(String, ImageFormat)	Enregistre ce Image dans le fichier spécifié au format spécifié. (Hérité de Image)
SaveAdd(EncoderParameters)	Ajoute un frame au fichier ou au flux spécifié dans un appel précédent à la méthode Save. Utilisez cette méthode pour enregistrer les frames sélectionnés d'une image à plusieurs frames dans une autre image à plusieurs frames. (Hérité de Image)
SaveAdd(Image, EncoderParameters)	Ajoute un frame au fichier ou au flux spécifié dans un appel précédent à la méthode Save. (Hérité de Image)
SelectActiveFrame(FrameDimension, Int32)	Sélectionne le frame spécifié par la dimension et l'index. (Hérité de Image)
SetPixel(Int32, Int32, Color)	Définit la couleur du pixel spécifié dans ce Bitmap.
SetPropertyItem(PropertyItem)	Stocke un élément de propriété (métadonnées) dans cet objet Image. (Hérité de Image)
SetResolution(Single, Single)	Définit la résolution de ce Bitmap.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
UnlockBits(BitmapData)	Déverrouille ce Bitmap dans la mémoire système.

Implémentations d’interfaces explicites

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Remplit SerializationInfo avec les données nécessaires pour sérialiser l'objet cible. (Hérité de Image)

Voir aussi

• PictureBox
• Images, bitmaps et métafichiers
• Utilisation des images, bitmaps, icônes et métafichiers