Bitmap Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Een GDI+-bitmap inkapselen, die bestaat uit de pixelgegevens voor een grafische afbeelding en de bijbehorende kenmerken. A Bitmap is een object dat wordt gebruikt om te werken met afbeeldingen die zijn gedefinieerd door pixelgegevens.
public ref class Bitmap sealed : System::Drawing::Image[System.Serializable]
public sealed class Bitmap : System.Drawing.Image[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class Bitmap : System.Drawing.Imagepublic sealed class Bitmap : System.Drawing.Image[<System.Serializable>]
type Bitmap = class
inherit Image[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Bitmap = class
inherit Imagetype Bitmap = class
inherit ImagePublic NotInheritable Class Bitmap
Inherits Image- Overname
- Kenmerken
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u een nieuw Bitmap bestand maakt met behulp van de GetPixel en SetPixel methoden om de afbeelding opnieuw te kleuren. Het maakt ook gebruik van de PixelFormat, Widthen Height eigenschappen.
Dit voorbeeld is ontworpen voor gebruik met een Windows Forms met een Label, PictureBox en Button met de naam Label1, PictureBox1 en Button1. Plak de code in het formulier en koppel de Button1_Click methode aan de gebeurtenis van Click de knop.
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
Opmerkingen
Een bitmap bestaat uit de pixelgegevens voor een grafische afbeelding en de bijbehorende kenmerken. Er zijn veel standaardindelingen voor het opslaan van een bitmap in een bestand. GDI+ ondersteunt de volgende bestandsindelingen: BMP, GIF, EXIF, JPG, PNG en TIFF. Zie Typen bitmaps voor meer informatie over ondersteunde indelingen.
U kunt afbeeldingen maken op basis van bestanden, streams en andere bronnen met behulp van een van de Bitmap constructors en deze opslaan in een stroom of in het bestandssysteem met de Save methode. Afbeeldingen worden getekend op het scherm of in het geheugen met behulp van de DrawImage methode van het Graphics object. Zie Werken met afbeeldingen, bitmaps, pictogrammen en metabestanden voor een lijst met onderwerpen over het werken met afbeeldingsbestanden.
Note
In .NET 6 en latere versies wordt het pakket System.Drawing.Common, dat dit type bevat, alleen ondersteund op Windows-besturingssystemen. Het gebruik van dit type in platformoverschrijdende apps veroorzaakt compileertijdwaarschuwingen en runtime-uitzonderingen. Zie System.Drawing.Common alleen ondersteund in Windows voor meer informatie.
Note
De Bitmap klasse is niet toegankelijk tussen toepassingsdomeinen. Als u bijvoorbeeld een dynamische AppDomain en verschillende penselen, pennen en bitmaps in dat domein maakt, kunt u deze objecten weer doorgeven aan het hoofdtoepassingsdomein, kunt u de pennen en borstels gebruiken. Als u echter de DrawImage methode aanroept om de marshaled Bitmapte tekenen, ontvangt u de volgende uitzondering:
Externe toegang kan het veld 'systeemeigen installatiekopie' niet vinden op het type System.Drawing.Image.
Constructors
| Name | Description |
|---|---|
| Bitmap(Image, Int32, Int32) |
Initialiseert een nieuw exemplaar van de Bitmap klasse van de opgegeven bestaande installatiekopieën, geschaald naar de opgegeven grootte. |
| Bitmap(Image, Size) |
Initialiseert een nieuw exemplaar van de Bitmap klasse van de opgegeven bestaande installatiekopieën, geschaald naar de opgegeven grootte. |
| Bitmap(Image) |
Initialiseert een nieuw exemplaar van de Bitmap klasse op basis van de opgegeven bestaande installatiekopieën. |
| Bitmap(Int32, Int32, Graphics) |
Initialiseert een nieuw exemplaar van de Bitmap klasse met de opgegeven grootte en met de resolutie van het opgegeven Graphics object. |
| Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr) |
Initialiseert een nieuw exemplaar van de Bitmap klasse met de opgegeven grootte, pixelnotatie en pixelgegevens. |
| Bitmap(Int32, Int32, PixelFormat) |
Initialiseert een nieuw exemplaar van de Bitmap klasse met de opgegeven grootte en indeling. |
| Bitmap(Int32, Int32) |
Initialiseert een nieuw exemplaar van de Bitmap klasse met de opgegeven grootte. |
| Bitmap(Stream, Boolean) |
Initialiseert een nieuw exemplaar van de Bitmap klasse vanuit de opgegeven gegevensstroom. |
| Bitmap(Stream) |
Initialiseert een nieuw exemplaar van de Bitmap klasse vanuit de opgegeven gegevensstroom. |
| Bitmap(String, Boolean) |
Initialiseert een nieuw exemplaar van de Bitmap klasse uit het opgegeven bestand. |
| Bitmap(String) |
Initialiseert een nieuw exemplaar van de Bitmap klasse uit het opgegeven bestand. |
| Bitmap(Type, String) |
Initialiseert een nieuw exemplaar van de Bitmap klasse van een opgegeven resource. |
Eigenschappen
| Name | Description |
|---|---|
| Flags |
Hiermee worden kenmerkvlagmen opgehaald voor de pixelgegevens van deze Image. (Overgenomen van Image) |
| FrameDimensionsList |
Hiermee haalt u een matrix van GUID's op die de afmetingen van frames in dit Imagevertegenwoordigen. (Overgenomen van Image) |
| Height |
Hiermee haalt u de hoogte, in pixels, van deze Image. (Overgenomen van Image) |
| HorizontalResolution |
Hiermee haalt u de horizontale resolutie, in pixels per inch, van deze Image. (Overgenomen van Image) |
| Palette |
Hiermee haalt u het kleurenpalet op of stelt u dit Imagein. (Overgenomen van Image) |
| PhysicalDimension |
Hiermee haalt u de breedte en hoogte van deze afbeelding op. (Overgenomen van Image) |
| PixelFormat |
Hiermee haalt u de pixelindeling voor dit Imageop. (Overgenomen van Image) |
| PropertyIdList |
Hiermee worden id's opgehaald van de eigenschapsitems die in dit Imageitem zijn opgeslagen. (Overgenomen van Image) |
| PropertyItems |
Hiermee worden alle eigenschapsitems (stukjes metagegevens) opgeslagen in deze Image. (Overgenomen van Image) |
| RawFormat |
Hiermee haalt u de bestandsindeling van dit Imagebestand op. (Overgenomen van Image) |
| Size |
Hiermee haalt u de breedte en hoogte, in pixels, van deze afbeelding op. (Overgenomen van Image) |
| Tag |
Hiermee haalt u een object op of stelt u een object in dat aanvullende gegevens over de afbeelding biedt. (Overgenomen van Image) |
| VerticalResolution |
Hiermee haalt u de verticale resolutie, in pixels per inch, van deze Image. (Overgenomen van Image) |
| Width |
Hiermee wordt de breedte, in pixels, van deze Image. (Overgenomen van Image) |
Methoden
| Name | Description |
|---|---|
| ApplyEffect(Effect, Rectangle) |
Wijzigt de bitmap door de opgegeven |
| Clone() |
Hiermee maakt u een exacte kopie van deze Image. (Overgenomen van Image) |
| Clone(Rectangle, PixelFormat) |
Hiermee maakt u een kopie van de sectie van deze Bitmap sectie die is gedefinieerd door Rectangle de structuur en met een opgegeven PixelFormat opsomming. |
| Clone(RectangleF, PixelFormat) |
Hiermee maakt u een kopie van de sectie van deze Bitmap sectie die is gedefinieerd met een opgegeven PixelFormat opsomming. |
| ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single) |
Converteert de bitmap naar de opgegeven |
| ConvertFormat(PixelFormat) |
Converteert de bitmap naar de opgegeven |
| CreateObjRef(Type) |
Hiermee maakt u een object dat alle relevante informatie bevat die nodig is om een proxy te genereren die wordt gebruikt om te communiceren met een extern object. (Overgenomen van MarshalByRefObject) |
| Dispose() |
Alle resources die door deze Imageresources worden gebruikt, worden vrijgegeven. (Overgenomen van Image) |
| Dispose(Boolean) |
Publiceert de niet-beheerde resources die worden gebruikt door de Image beheerde resources en brengt eventueel de beheerde resources vrij. (Overgenomen van Image) |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| FromHicon(IntPtr) |
Hiermee maakt u een Bitmap van een Windows ingang naar een pictogram. |
| FromResource(IntPtr, String) |
Hiermee maakt u een Bitmap van de opgegeven Windows-resource. |
| GetBounds(GraphicsUnit) |
Hiermee haalt u de grenzen van de afbeelding op in de opgegeven eenheid. (Overgenomen van Image) |
| GetEncoderParameterList(Guid) |
Retourneert informatie over de parameters die worden ondersteund door de opgegeven afbeeldingscoderingsprogramma. (Overgenomen van Image) |
| GetFrameCount(FrameDimension) |
Retourneert het aantal frames van de opgegeven dimensie. (Overgenomen van Image) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetHbitmap() |
Hiermee maakt u een GDI-bitmapobject op basis van deze Bitmap. |
| GetHbitmap(Color) |
Hiermee maakt u een GDI-bitmapobject op basis van deze Bitmap. |
| GetHicon() |
Retourneert de greep naar een pictogram. |
| GetLifetimeService() |
Verouderd.
Hiermee haalt u het huidige levensduurserviceobject op waarmee het levensduurbeleid voor dit exemplaar wordt beheerd. (Overgenomen van MarshalByRefObject) |
| GetPixel(Int32, Int32) |
Hiermee haalt u de kleur van de opgegeven pixel op.Bitmap |
| GetPropertyItem(Int32) |
Hiermee wordt het opgegeven eigenschapsitem opgehaald.Image (Overgenomen van Image) |
| GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr) |
Retourneert een miniatuur voor dit Image. (Overgenomen van Image) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| InitializeLifetimeService() |
Verouderd.
Hiermee haalt u een levensduurserviceobject op om het levensduurbeleid voor dit exemplaar te beheren. (Overgenomen van MarshalByRefObject) |
| LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData) |
Hiermee wordt een Bitmap systeemgeheugen vergrendeld. |
| LockBits(Rectangle, ImageLockMode, PixelFormat) |
Hiermee wordt een Bitmap systeemgeheugen vergrendeld. |
| MakeTransparent() |
Maakt de standaard transparante kleur transparant voor dit Bitmap. |
| MakeTransparent(Color) |
Maakt de opgegeven kleur transparant voor dit Bitmap. |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| MemberwiseClone(Boolean) |
Hiermee maakt u een ondiepe kopie van het huidige MarshalByRefObject object. (Overgenomen van MarshalByRefObject) |
| RemovePropertyItem(Int32) |
Hiermee verwijdert u het opgegeven eigenschapsitem uit deze Image. (Overgenomen van Image) |
| RotateFlip(RotateFlipType) |
Draait, spiegelt of draait en spiegelt de Image. (Overgenomen van Image) |
| Save(Stream, ImageCodecInfo, EncoderParameters) |
Slaat deze afbeelding op in de opgegeven stroom, met de opgegeven encoder- en afbeeldingscoderingsprogrammaparameters. (Overgenomen van Image) |
| Save(Stream, ImageFormat) |
Slaat deze afbeelding op in de opgegeven stroom in de opgegeven indeling. (Overgenomen van Image) |
| Save(String, ImageCodecInfo, EncoderParameters) |
Hiermee wordt dit Image opgeslagen in het opgegeven bestand, met de opgegeven encoder- en image-encoderparameters. (Overgenomen van Image) |
| Save(String, ImageFormat) |
Hiermee wordt dit Image opgeslagen in het opgegeven bestand in de opgegeven indeling. (Overgenomen van Image) |
| Save(String) |
Slaat dit Image op in het opgegeven bestand of de opgegeven stream. (Overgenomen van Image) |
| SaveAdd(EncoderParameters) |
Voegt een frame toe aan het bestand of de stream die is opgegeven in een vorige aanroep naar de Save methode. Gebruik deze methode om geselecteerde frames van een afbeelding met meerdere frames op te slaan in een andere afbeelding met meerdere frames. (Overgenomen van Image) |
| SaveAdd(Image, EncoderParameters) |
Voegt een frame toe aan het bestand of de stream die is opgegeven in een vorige aanroep naar de Save methode. (Overgenomen van Image) |
| SelectActiveFrame(FrameDimension, Int32) |
Hiermee selecteert u het frame dat is opgegeven door de dimensie en index. (Overgenomen van Image) |
| SetPixel(Int32, Int32, Color) |
Hiermee stelt u de kleur van de opgegeven pixel in.Bitmap |
| SetPropertyItem(PropertyItem) |
Hiermee slaat u een eigenschapsitem (stukje metagegevens) op.Image (Overgenomen van Image) |
| SetResolution(Single, Single) |
Hiermee stelt u de resolutie voor .Bitmap |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |
| UnlockBits(BitmapData) |
Ontgrendelt dit Bitmap vanuit het systeemgeheugen. |
Expliciete interface-implementaties
| Name | Description |
|---|---|
| ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
Vult een SerializationInfo met de gegevens die nodig zijn om het doelobject te serialiseren. (Overgenomen van Image) |
