Bitmap Třída

Definice

Obor názvů:

System.Drawing

Sestavení:

System.Drawing.Common.dll

Zdroj:

Bitmap.cs

Zapouzdřuje rastrový obrázek GDI+, který se skládá z obrazových bodů grafického obrázku a jeho atributů. A Bitmap je objekt, který slouží k práci s obrázky definovanými daty 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

Dědičnost

Object

MarshalByRefObject

Image

Bitmap

Atributy

SerializableAttribute

Příklady

Následující příklad kódu ukazuje, jak vytvořit nový Bitmap ze souboru pomocí GetPixel a SetPixel metod k přebarvení obrázku. Používá také PixelFormat, Widtha Height vlastnosti.

Tento příklad je navržený tak, aby se používal s Windows Forms, který obsahuje objekty Label, PictureBoxa Button pojmenované Label1, PictureBox1a Button1v uvedeném pořadí. Vložte kód do formuláře a přidružte Button1_Click metodu k události tlačítka Click .

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

Poznámky

Rastrový obrázek se skládá z dat pixelů grafického obrázku a jeho atributů. Existuje mnoho standardních formátů pro uložení rastrového obrázku do souboru. GDI+ podporuje následující formáty souborů: BMP, GIF, EXIF, JPG, PNG a TIFF. Další informace o podporovaných formátech naleznete v tématu Typy rastrových obrázků.

Obrázky můžete vytvářet ze souborů, datových proudů a dalších zdrojů pomocí jednoho z Bitmap konstruktorů a uložit je do datového proudu nebo do systému souborů pomocí Save metody. Obrázky se nakreslují na obrazovku nebo do paměti pomocí DrawImage metody objektu Graphics . Seznam témat o práci se soubory obrázků najdete v tématu Práce s obrázky, rastry, ikony a metasoubory.

Note

V .NET 6 a novějších verzích je balíček System.Drawing.Common, který obsahuje tento typ, podporován pouze v operačních systémech Windows. Použití tohoto typu v multiplatformních aplikacích způsobuje upozornění v době kompilace a výjimky za běhu. Další informace naleznete v tématu System.Drawing.Common podporován pouze ve Windows.

Note

Třída Bitmap není přístupná napříč doménami aplikace. Pokud například vytvoříte dynamický AppDomain a vytvoříte v této doméně několik štětců, per a rastrových obrázků, předáte tyto objekty zpět do hlavní aplikační domény, můžete úspěšně použít pera a štětce. Pokud však zavoláte metodu DrawImage pro vykreslení zařazování Bitmap, obdržíte následující výjimku:

Vzdálené komunikace nemůže najít pole "nativní image" typu System.Drawing.Image.

Konstruktory

Name	Description
Bitmap(Image, Int32, Int32)	Inicializuje novou instanci Bitmap třídy ze zadané existující image škálované na zadanou velikost.
Bitmap(Image, Size)	Inicializuje novou instanci Bitmap třídy ze zadané existující image škálované na zadanou velikost.
Bitmap(Image)	Inicializuje novou instanci Bitmap třídy ze zadané existující image.
Bitmap(Int32, Int32, Graphics)	Inicializuje novou instanci Bitmap třídy se zadanou velikostí a rozlišení zadaného Graphics objektu.
Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr)	Inicializuje novou instanci Bitmap třídy se zadanou velikostí, formátem pixelů a daty pixelů.
Bitmap(Int32, Int32, PixelFormat)	Inicializuje novou instanci Bitmap třídy se zadanou velikostí a formátem.
Bitmap(Int32, Int32)	Inicializuje novou instanci Bitmap třídy se zadanou velikostí.
Bitmap(Stream, Boolean)	Inicializuje novou instanci Bitmap třídy ze zadaného datového proudu.
Bitmap(Stream)	Inicializuje novou instanci Bitmap třídy ze zadaného datového proudu.
Bitmap(String, Boolean)	Inicializuje novou instanci Bitmap třídy ze zadaného souboru.
Bitmap(String)	Inicializuje novou instanci Bitmap třídy ze zadaného souboru.
Bitmap(Type, String)	Inicializuje novou instanci Bitmap třídy ze zadaného prostředku.

Vlastnosti

Name	Description
Flags	Získá příznaky atributů pro pixelová data tohoto Image. (Zděděno od Image)
FrameDimensionsList	Získá pole identifikátorů GUID, které představují dimenze rámců v tomto Image. (Zděděno od Image)
Height	Získá výšku v pixelech tohoto Image. (Zděděno od Image)
HorizontalResolution	Získá vodorovné rozlišení v pixelech na paleč tohoto Image. (Zděděno od Image)
Palette	Získá nebo nastaví barevnou paletu použitou pro toto Image. (Zděděno od Image)
PhysicalDimension	Získá šířku a výšku tohoto obrázku. (Zděděno od Image)
PixelFormat	Získá pixel formát pro tento Image. (Zděděno od Image)
PropertyIdList	Získá ID položek vlastnosti uložené v tomto Image. (Zděděno od Image)
PropertyItems	Získá všechny položky vlastnosti (části metadat) uložené v tomto Image. (Zděděno od Image)
RawFormat	Získá formát souboru tohoto Image. (Zděděno od Image)
Size	Získá šířku a výšku tohoto obrázku v pixelech. (Zděděno od Image)
Tag	Získá nebo nastaví objekt, který poskytuje další data o obrázku. (Zděděno od Image)
VerticalResolution	Získá svislé rozlišení v pixelech na paleč, z tohoto Image. (Zděděno od Image)
Width	Získá šířku v pixelech tohoto Image. (Zděděno od Image)

Metody

Name	Description
ApplyEffect(Effect, Rectangle)	Změní rastrový obrázek použitím daného effectobrázku .
Clone()	Vytvoří přesnou kopii tohoto Imagesouboru . (Zděděno od Image)
Clone(Rectangle, PixelFormat)	Vytvoří kopii oddílu definovaného Bitmap strukturou Rectangle a se zadaným PixelFormat výčtem.
Clone(RectangleF, PixelFormat)	Vytvoří kopii oddílu tohoto Bitmap definovaného se zadaným PixelFormat výčtem.
ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single)	Převede rastrový obrázek na zadaný format pomocí daného ditherType. Původní pixelová data se nahradí novým formátem.
ConvertFormat(PixelFormat)	Převede rastrový obrázek na zadaný format. Původní pixelová data se nahradí novým formátem.
Dispose()	Uvolní všechny prostředky používané tímto Imagenástrojem . (Zděděno od Image)
Dispose(Boolean)	Uvolní nespravované prostředky používané Image a volitelně uvolní spravované prostředky. (Zděděno od Image)
FromHicon(IntPtr)	Bitmap Vytvoří z úchytu systému Windows ikonu.
FromResource(IntPtr, String)	Bitmap Vytvoří ze zadaného prostředku Windows.
GetBounds(GraphicsUnit)	Získá hranice obrázku v zadané jednotce. (Zděděno od Image)
GetEncoderParameterList(Guid)	Vrátí informace o parametrech podporovaných zadaným kodérem obrázků. (Zděděno od Image)
GetFrameCount(FrameDimension)	Vrátí početsnímkůchchchch (Zděděno od Image)
GetHbitmap()	Vytvoří objekt rastrového obrázku GDI z tohoto Bitmapobjektu .
GetHbitmap(Color)	Vytvoří objekt rastrového obrázku GDI z tohoto Bitmapobjektu .
GetHicon()	Vrátí úchyt na ikonu.
GetPixel(Int32, Int32)	Získá barvu zadaného pixelu v tomto Bitmap.
GetPropertyItem(Int32)	Získá zadanou položku vlastnosti z tohoto Image. (Zděděno od Image)
GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr)	Vrátí miniaturu pro toto Image. (Zděděno od Image)
LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)	Uzamkne systémovou Bitmap paměť.
LockBits(Rectangle, ImageLockMode, PixelFormat)	Uzamkne systémovou Bitmap paměť.
MakeTransparent()	Zprůhlední výchozí průhledná barva .Bitmap
MakeTransparent(Color)	Zprůhlední zadaná barva pro tento Bitmapparametr .
RemovePropertyItem(Int32)	Odebere zadanou položku vlastnosti z tohoto Imageobjektu . (Zděděno od Image)
RotateFlip(RotateFlipType)	Otočí, překlopí nebo otočí a překlopí Image. (Zděděno od Image)
Save(Stream, ImageCodecInfo, EncoderParameters)	Uloží tento obrázek do zadaného datového proudu se zadanými parametry kodéru a kodéru obrázků. (Zděděno od Image)
Save(Stream, ImageFormat)	Uloží tento obrázek do zadaného datového proudu v zadaném formátu. (Zděděno od Image)
Save(String, ImageCodecInfo, EncoderParameters)	Uloží ho Image do zadaného souboru se zadanými parametry kodéru a kodéru obrázků. (Zděděno od Image)
Save(String, ImageFormat)	Uloží ho Image do zadaného souboru v zadaném formátu. (Zděděno od Image)
Save(String)	Uloží ho Image do zadaného souboru nebo datového proudu. (Zděděno od Image)
SaveAdd(EncoderParameters)	Přidá rámeček do souboru nebo datového proudu zadaného v předchozím volání Save metody. Tato metoda slouží k uložení vybraných snímků z obrázku s více snímky do jiného obrázku s více snímky. (Zděděno od Image)
SaveAdd(Image, EncoderParameters)	Přidá rámeček do souboru nebo datového proudu zadaného v předchozím volání Save metody. (Zděděno od Image)
SelectActiveFrame(FrameDimension, Int32)	Vybere rámeček určený dimenzí a indexem. (Zděděno od Image)
SetPixel(Int32, Int32, Color)	Nastaví barvu zadaného pixelu v tomto Bitmap.
SetPropertyItem(PropertyItem)	Ukládá položku vlastnosti (část metadat) v tomto Imagesouboru . (Zděděno od Image)
SetResolution(Single, Single)	Nastaví rozlišení pro toto Bitmap.
UnlockBits(BitmapData)	Odemkne to Bitmap ze systémové paměti.

Explicitní implementace rozhraní

Name	Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Naplní SerializationInfo data potřebná k serializaci cílového objektu. (Zděděno od Image)

Viz také

• PictureBox
• obrázky, rastrové obrázky a metasoubory
• Práce s Obrázky, Rastrovými Obrázky, Ikonami a Metasoubory