Bitmap 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
封裝 GDI+ 點陣圖，這個點陣圖是由圖形影像的像素資料及其屬性所組成。 Bitmap 是用來處理像素資料所定義影像的物件。
public ref class Bitmap sealed : System::Drawing::Imagepublic sealed class Bitmap : 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.Imagetype Bitmap = class
inherit Image[<System.Serializable>]
type Bitmap = class
inherit Image[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Bitmap = class
inherit ImagePublic NotInheritable Class Bitmap
Inherits Image- 繼承
- 屬性
範例
下列程式碼範例示範如何使用 和 SetPixel 方法來從檔案建構新的 Bitmap ， GetPixel 以重新著色影像。 它也會使用 PixelFormat 、 Width 和 Height 屬性。
此範例的設計目的是要分別與包含 Label 、 和 、 和 ButtonButton1PictureBox1Label1 的Windows Forms搭配使用。 PictureBox 將程式碼貼到表單中，並將 Button1_Click 方法與按鈕的事件 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
備註
點陣圖是由圖形影像及其屬性的圖元資料所組成。 有許多標準格式可將點陣圖儲存至檔案。 GDI+ 支援下列檔案格式：BMP、GIF、EXIF、JPG、PNG 和 TIFF。 如需支援格式的詳細資訊，請參閱 點陣圖的類型。
您可以使用其中 Bitmap 一個建構函式，從檔案、資料流程和其他來源建立影像，並使用 方法將它們儲存至資料流程或檔案系統 Save 。 影像會使用 DrawImage 物件的 方法 Graphics 繪製到螢幕或記憶體。 如需使用影像檔的主題清單，請參閱 使用影像、點陣圖、圖示和中繼檔。
注意
在 .NET 6 和更新版本中，只有 Windows 作業系統才支援包含此類型的 System.Drawing.Common 套件。 在跨平臺應用程式中使用此類型會導致編譯時期警告和執行時間例外狀況。 如需詳細資訊，請參閱 僅限 Windows 上支援的 System.Drawing.Common。
注意
類別 Bitmap 無法跨應用程式域存取。 例如，如果您建立動態 AppDomain ，並在該網域中建立數個筆刷、畫筆和點陣圖，然後將這些物件傳回主要應用程式域，您可以成功使用畫筆和筆刷。 不過，如果您呼叫 DrawImage 方法來繪製封送處理 Bitmap 的方法，您會收到下列例外狀況：
遠端處理在類型 「System.Drawing.Image」 上找不到欄位「原生影像」。
建構函式
| Bitmap(Image) |
從指定的現有影像初始化 Bitmap 類別的新執行個體。 |
| Bitmap(Image, Int32, Int32) |
從指定的現有影像 (已縮放至指定之大小)，初始化 Bitmap 類別的新執行個體。 |
| Bitmap(Image, Size) |
從指定的現有影像 (已縮放至指定之大小)，初始化 Bitmap 類別的新執行個體。 |
| Bitmap(Int32, Int32) |
使用指定的大小，初始化 Bitmap 類別的新執行個體。 |
| Bitmap(Int32, Int32, Graphics) | |
| Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr) |
使用指定的大小、像素格式和像素資料，初始化 Bitmap 類別的新執行個體。 |
| Bitmap(Int32, Int32, PixelFormat) |
使用指定的大小和格式，初始化 Bitmap 類別的新執行個體。 |
| Bitmap(Stream) |
從指定的資料流，初始化 Bitmap 類別的新執行個體。 |
| Bitmap(Stream, Boolean) |
從指定的資料流，初始化 Bitmap 類別的新執行個體。 |
| Bitmap(String) |
從指定的檔案，初始化 Bitmap 類別的新執行個體。 |
| Bitmap(String, Boolean) |
從指定的檔案，初始化 Bitmap 類別的新執行個體。 |
| Bitmap(Type, String) |
從指定的資源，初始化 Bitmap 類別的新執行個體。 |
屬性
| Flags |
取得這個 Image 之像素資料的屬性旗標。 (繼承來源 Image) |
| FrameDimensionsList |
取得 GUID 的陣列，表示這個 Image 中的框架 (Frame) 維度 (Dimension)。 (繼承來源 Image) |
| Height |
取得這個 Image 的高度 (單位為像素)。 (繼承來源 Image) |
| HorizontalResolution |
取得這個 Image 的水平解析度 (單位為每英吋的像素)。 (繼承來源 Image) |
| Palette |
取得或設定用於這個 Image 的調色盤。 (繼承來源 Image) |
| PhysicalDimension |
取得這個影像的寬度和高度。 (繼承來源 Image) |
| PixelFormat |
取得這個 Image 的像素格式。 (繼承來源 Image) |
| PropertyIdList |
取得儲存在這個 Image 中的屬性項目 ID。 (繼承來源 Image) |
| PropertyItems |
取得儲存在這個 Image 中的所有屬性項目 (中繼資料的各個項目)。 (繼承來源 Image) |
| RawFormat |
取得這個 Image 的檔案格式。 (繼承來源 Image) |
| Size |
取得影像的寬度和高度，單位為像素。 (繼承來源 Image) |
| Tag |
取得或設定物件，該物件提供影像的其他相關資料。 (繼承來源 Image) |
| VerticalResolution |
取得這個 Image 的垂直解析度 (單位為每英吋的像素)。 (繼承來源 Image) |
| Width |
取得這個 Image 的寬度 (單位為像素)。 (繼承來源 Image) |
方法
明確介面實作
| ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
將序列化目標物件所需的資料填入 SerializationInfo。 (繼承來源 Image) |
適用於
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應