Bitmap Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Kapslar in en GDI+ bitmapp, som består av pixeldata för en grafikbild och dess attribut. A Bitmap är ett objekt som används för att arbeta med bilder som definieras av pixeldata.
public ref class Bitmap sealed : System::Drawing::Image
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public sealed class Bitmap : System.Drawing.Image
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type Bitmap = class
inherit Image
Public NotInheritable Class Bitmap
Inherits Image
- Arv
- Attribut
Exempel
I följande kodexempel visas hur du skapar en ny Bitmap från en fil med metoderna GetPixel och SetPixel för att ändra färg på bilden. Den använder PixelFormatockså egenskaperna , Widthoch Height .
Det här exemplet är utformat för att användas med en Windows Forms som innehåller en Label, PictureBox och Button med namnet Label1, PictureBox1 respektive Button1. Klistra in koden i formuläret och associera Button1_Click metoden med knappens Click händelse.
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
Kommentarer
En bitmapp består av pixeldata för en grafikbild och dess attribut. Det finns många standardformat för att spara en bitmapp i en fil. GDI+ stöder följande filformat: BMP, GIF, EXIF, JPG, PNG och TIFF. Mer information om format som stöds finns i Typer av bitmappar.
Du kan skapa bilder från filer, strömmar och andra källor genom att använda någon av konstruktorerna Bitmap och spara dem i en ström eller till filsystemet med Save metoden . Bilder ritas till skärmen eller till minnet med hjälp DrawImage av -metoden för Graphics objektet. En lista över ämnen om hur du arbetar med bildfiler finns i Arbeta med bilder, bitmappar, ikoner och metafiler.
Note
I .NET 6 och senare versioner stöds endast System.Drawing.Common-paketet, som innehåller den här typen, på Windows-operativsystem. Användning av den här typen i plattformsoberoende appar orsakar kompileringstidsvarningar och körningsfel. Mer information finns i System.Drawing.Common som endast stöds i Windows.
Note
Klassen Bitmap är inte tillgänglig för programdomäner. Om du till exempel skapar en dynamisk AppDomain och skapar flera penslar, pennor och bitmappar i domänen och sedan skickar dessa objekt tillbaka till huvudprogramdomänen kan du använda pennor och penslar. Men om du anropar DrawImage metoden för att rita den marskalkade Bitmapfår du följande undantag:
Fjärrkommunikation kan inte hitta fältet "intern bild" på typen "System.Drawing.Image".
Konstruktorer
| Name | Description |
|---|---|
| Bitmap(Image, Int32, Int32) |
Initierar en ny instans av Bitmap klassen från den angivna befintliga avbildningen, skalad till den angivna storleken. |
| Bitmap(Image, Size) |
Initierar en ny instans av Bitmap klassen från den angivna befintliga avbildningen, skalad till den angivna storleken. |
| Bitmap(Image) |
Initierar en ny instans av klassen från den angivna befintliga avbildningen Bitmap . |
| Bitmap(Int32, Int32, Graphics) |
Initierar en ny instans av Bitmap klassen med den angivna storleken och med upplösningen för det angivna Graphics objektet. |
| Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr) |
Initierar en ny instans av Bitmap klassen med angiven storlek, pixelformat och pixeldata. |
| Bitmap(Int32, Int32, PixelFormat) |
Initierar en ny instans av Bitmap klassen med angiven storlek och format. |
| Bitmap(Int32, Int32) |
Initierar en ny instans av Bitmap klassen med den angivna storleken. |
| Bitmap(Stream, Boolean) |
Initierar en ny instans av Bitmap klassen från den angivna dataströmmen. |
| Bitmap(Stream) |
Initierar en ny instans av Bitmap klassen från den angivna dataströmmen. |
| Bitmap(String, Boolean) |
Initierar en ny instans av Bitmap klassen från den angivna filen. |
| Bitmap(String) |
Initierar en ny instans av Bitmap klassen från den angivna filen. |
| Bitmap(Type, String) |
Initierar en ny instans av Bitmap klassen från en angiven resurs. |
Egenskaper
| Name | Description |
|---|---|
| Flags |
Hämtar attributflaggor för pixeldata för den här Image. (Ärvd från Image) |
| FrameDimensionsList |
Hämtar en matris med GUID:er som representerar ramarnas dimensioner i den här Image. (Ärvd från Image) |
| Height |
Hämtar höjden, i bildpunkter, för den här Image. (Ärvd från Image) |
| HorizontalResolution |
Hämtar den vågräta upplösningen i bildpunkter per tum av den här Image. (Ärvd från Image) |
| Palette |
Hämtar eller anger den färgpalett som används för detta Image. (Ärvd från Image) |
| PhysicalDimension |
Hämtar bredden och höjden på den här bilden. (Ärvd från Image) |
| PixelFormat |
Hämtar pixelformatet för detta Image. (Ärvd från Image) |
| PropertyIdList |
Hämtar ID:t för de egenskapsobjekt som lagras i den här Image. (Ärvd från Image) |
| PropertyItems |
Hämtar alla egenskapsobjekt (metadatadelar) som lagras i den här Image. (Ärvd från Image) |
| RawFormat |
Hämtar filformatet för det här Image. (Ärvd från Image) |
| Size |
Hämtar bredden och höjden i bildpunkter för den här bilden. (Ärvd från Image) |
| Tag |
Hämtar eller anger ett objekt som innehåller ytterligare data om bilden. (Ärvd från Image) |
| VerticalResolution |
Hämtar den lodräta upplösningen i bildpunkter per tum av den här Image. (Ärvd från Image) |
| Width |
Hämtar bredden i bildpunkter för den här Image. (Ärvd från Image) |
Metoder
| Name | Description |
|---|---|
| Clone() |
Skapar en exakt kopia av den här Image. (Ärvd från Image) |
| Clone(Rectangle, PixelFormat) |
Skapar en kopia av avsnittet som Bitmap definieras av Rectangle struktur och med en angiven PixelFormat uppräkning. |
| Clone(RectangleF, PixelFormat) |
Skapar en kopia av avsnittet i det här Bitmap som definierats med en angiven PixelFormat uppräkning. |
| CreateObjRef(Type) |
Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt. (Ärvd från MarshalByRefObject) |
| Dispose() |
Släpper alla resurser som används av den här Image. (Ärvd från Image) |
| Dispose(Boolean) |
Släpper de ohanterade resurser som används av Image och släpper eventuellt de hanterade resurserna. (Ärvd från Image) |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| FromHicon(IntPtr) |
Skapar en Bitmap från ett Windows-handtag till en ikon. |
| FromResource(IntPtr, String) |
Skapar en Bitmap från den angivna Windows resursen. |
| GetBounds(GraphicsUnit) |
Hämtar avbildningens gränser i den angivna enheten. (Ärvd från Image) |
| GetEncoderParameterList(Guid) |
Returnerar information om de parametrar som stöds av den angivna bildkodaren. (Ärvd från Image) |
| GetFrameCount(FrameDimension) |
Returnerar antalet bildrutor för den angivna dimensionen. (Ärvd från Image) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetHbitmap() |
Skapar ett GDI-bitmappsobjekt från detta Bitmap. |
| GetHbitmap(Color) |
Skapar ett GDI-bitmappsobjekt från detta Bitmap. |
| GetHicon() |
Returnerar handtaget till en ikon. |
| GetLifetimeService() |
Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject) |
| GetPixel(Int32, Int32) |
Hämtar färgen på den angivna pixeln i den här Bitmap. |
| GetPropertyItem(Int32) |
Hämtar det angivna egenskapsobjektet från den här Image. (Ärvd från Image) |
| GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr) |
Returnerar en miniatyrbild för den här Image. (Ärvd från Image) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| InitializeLifetimeService() |
Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject) |
| LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData) |
Låser en Bitmap i systemminnet. |
| LockBits(Rectangle, ImageLockMode, PixelFormat) |
Låser en Bitmap i systemminnet. |
| MakeTransparent() |
Gör den transparenta standardfärgen transparent för den här Bitmap. |
| MakeTransparent(Color) |
Gör den angivna färgen transparent för den här Bitmap. |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| MemberwiseClone(Boolean) |
Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet. (Ärvd från MarshalByRefObject) |
| RemovePropertyItem(Int32) |
Tar bort det angivna egenskapsobjektet från den här Image. (Ärvd från Image) |
| RotateFlip(RotateFlipType) |
Roterar, vänder eller roterar och vänder Image. (Ärvd från Image) |
| Save(Stream, ImageCodecInfo, EncoderParameters) |
Sparar den här bilden i den angivna strömmen med de angivna kodarna och bildkodarparametrarna. (Ärvd från Image) |
| Save(Stream, ImageFormat) |
Sparar den här avbildningen i den angivna strömmen i det angivna formatet. (Ärvd från Image) |
| Save(String, ImageCodecInfo, EncoderParameters) |
Sparar detta Image i den angivna filen med de angivna parametrarna kodare och bildkodare. (Ärvd från Image) |
| Save(String, ImageFormat) |
Sparar detta Image i den angivna filen i det angivna formatet. (Ärvd från Image) |
| Save(String) |
Sparar detta Image i den angivna filen eller strömmen. (Ärvd från Image) |
| SaveAdd(EncoderParameters) |
Lägger till en ram i filen eller strömmen som angavs i ett tidigare anrop till Save metoden. Använd den här metoden för att spara markerade bildrutor från en bild med flera bildrutor till en annan bild med flera bildrutor. (Ärvd från Image) |
| SaveAdd(Image, EncoderParameters) |
Lägger till en ram i filen eller strömmen som angavs i ett tidigare anrop till Save metoden. (Ärvd från Image) |
| SelectActiveFrame(FrameDimension, Int32) |
Väljer den ram som anges av dimensionen och indexet. (Ärvd från Image) |
| SetPixel(Int32, Int32, Color) |
Anger färgen på den angivna pixeln i den här Bitmap. |
| SetPropertyItem(PropertyItem) |
Lagrar ett egenskapsobjekt (bit metadata) i den här Image. (Ärvd från Image) |
| SetResolution(Single, Single) |
Anger upplösningen för den här Bitmap. |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
| UnlockBits(BitmapData) |
Låser upp detta Bitmap från systemminnet. |
Explicita gränssnittsimplementeringar
| Name | Description |
|---|---|
| ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
Fyller i en SerializationInfo med de data som behövs för att serialisera målobjektet. (Ärvd från Image) |