Bitmap Třída

Definice

Obor názvů:

System.Drawing

Sestavení:

System.Drawing.Common.dll

Balíček:

System.Drawing.Common v8.0.0

Zdroj:

Bitmap.cs

Zapouzdří rastrový obrázek GDI+, který se skládá z obrazových dat grafického obrázku a jeho atributů. A Bitmap je objekt, který se používá k práci s obrázky definovanými pixelovými daty.

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 metod a SetPixel přebarvit obrázek. Používá PixelFormattaké vlastnosti , Widtha Height .

Tento příklad je navržený tak, aby se používal s model Windows Forms, která obsahuje Label, PictureBoxa Button s názvem Label1, PictureBox1a Button1. Vložte kód do formuláře a přidružte metodu Button1_Click 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 obrazových dat 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ů.

Pomocí jednoho z Bitmap konstruktorů můžete vytvořit obrázky ze souborů, datových proudů a dalších zdrojů a uložit je do streamu nebo do systému souborů pomocí Save metody . Obrázky jsou nakresleny na obrazovku nebo do paměti pomocí DrawImage metody objektu Graphics . Seznam témat týkajících se práce se soubory obrázků najdete v tématu Práce s obrázky, rastrovými obrázky, ikonami a metasoubory.

Poznámka

V rozhraní .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í na kompilaci a výjimky za běhu. Další informace najdete v tématu System.Drawing.Common podporované pouze ve Windows.

Poznámka

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

Při vzdálené komunikace nelze najít pole nativního obrázku pro typ System.Drawing.Image.

Konstruktory

Bitmap(Image)	Inicializuje novou instanci Bitmap třídy ze zadané existující image.
Bitmap(Image, Int32, Int32)	Inicializuje novou instanci Bitmap třídy ze zadané existující image se škálováním na zadanou velikost.
Bitmap(Image, Size)	Inicializuje novou instanci Bitmap třídy ze zadané existující image se škálováním na zadanou velikost.
Bitmap(Int32, Int32)	Inicializuje novou instanci Bitmap třídy se zadanou velikostí.
Bitmap(Int32, Int32, Graphics)	Inicializuje novou instanci Bitmap třídy se zadanou velikostí a rozlišením zadaného Graphics objektu.
Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr)	Inicializuje novou instanci Bitmap třídy se zadanou velikostí, formátem pixelů a pixelovými daty.
Bitmap(Int32, Int32, PixelFormat)	Inicializuje novou instanci Bitmap třídy se zadanou velikostí a formátem.
Bitmap(Stream)	Inicializuje novou instanci Bitmap třídy ze zadaného datového streamu.
Bitmap(Stream, Boolean)	Inicializuje novou instanci Bitmap třídy ze zadaného datového streamu.
Bitmap(String)	Inicializuje novou instanci Bitmap třídy ze zadaného souboru.
Bitmap(String, Boolean)	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

Flags	Získá příznaky atributu pro pixel data tohoto Image. (Zděděno od Image)
FrameDimensionsList	Získá pole identifikátorů GUID, které představují rozměry rámců v rámci tohoto Imageobjektu . (Zděděno od Image)
Height	Získá výšku v pixelech tohoto Imageobjektu . (Zděděno od Image)
HorizontalResolution	Získá vodorovné rozlišení v pixelech na paleci tohoto Imageobjektu . (Zděděno od Image)
Palette	Získá nebo nastaví paletu barev použitou pro tento Imageobjekt . (Zděděno od Image)
PhysicalDimension	Získá šířku a výšku tohoto obrázku. (Zděděno od Image)
PixelFormat	Získá formát pixel pro tento Image. (Zděděno od Image)
PropertyIdList	Získá ID položek vlastností uložených v tomto Imagesouboru . (Zděděno od Image)
PropertyItems	Získá všechny položky vlastnosti (části metadat) uložené v tomto Imageobjektu . (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 v pixelech tohoto obrázku. (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 paleci tohoto Imageobjektu . (Zděděno od Image)
Width	Získá šířku v pixelech tohoto Imageobjektu . (Zděděno od Image)

Metody

Clone()	Vytvoří přesnou kopii tohoto Imageobjektu . (Zděděno od Image)
Clone(Rectangle, PixelFormat)	Vytvoří kopii oddílu tohoto Bitmap definovaného strukturou Rectangle a se zadaným PixelFormat výčtem.
Clone(RectangleF, PixelFormat)	Vytvoří kopii tohoto oddílu Bitmap definovaného se zadaným PixelFormat výčtem.
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
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é nástrojem Image a volitelně uvolní spravované prostředky. (Zděděno od Image)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
FromHicon(IntPtr)	Bitmap Vytvoří z popisovače 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ázku. (Zděděno od Image)
GetFrameCount(FrameDimension)	Vrátí počet snímků zadané dimenze. (Zděděno od Image)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
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 ikony.
GetLifetimeService()	Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetPixel(Int32, Int32)	Získá barvu zadaného pixelu v tomto Bitmapobjektu .
GetPropertyItem(Int32)	Získá zadanou položku vlastnosti z tohoto Imageobjektu . (Zděděno od Image)
GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr)	Vrátí miniaturu pro tento Image. (Zděděno od Image)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
LockBits(Rectangle, ImageLockMode, PixelFormat)	Uzamkne do Bitmap systémové paměti.
LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)	Uzamkne do Bitmap systémové paměti.
MakeTransparent()	Nastaví výchozí průhlednou barvu pro tento Bitmap.
MakeTransparent(Color)	Zprůhlední zadanou barvu pro tento Bitmap.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
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)	Uloží ho Image do zadaného souboru nebo datového proudu. (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ží soubor Image do zadaného souboru v zadaném formátu. (Zděděno od Image)
SaveAdd(EncoderParameters)	Přidá rámec do souboru nebo datového proudu zadaného v předchozím volání Save metody . Tuto metodu použijte 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ámec 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ý rozměrem a indexem. (Zděděno od Image)
SetPixel(Int32, Int32, Color)	Nastaví barvu zadaného pixelu v tomto Bitmapobjektu .
SetPropertyItem(PropertyItem)	Ukládá položku vlastnosti (část metadat) v tomto Imagesouboru . (Zděděno od Image)
SetResolution(Single, Single)	Nastaví rozlišení pro tento Bitmap.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
UnlockBits(BitmapData)	Odemkne ho Bitmap ze systémové paměti.

Explicitní implementace rozhraní

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Naplní SerializationInfo objekt daty potřebnými 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