本文為機器翻譯文章。如需檢視英文版,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

Bitmap 類別

 

封裝 GDI+ 點陣圖的像素資料的圖形映像和其屬性所組成。 A Bitmap 是用來處理影像像素資料所定義的物件。

命名空間:   System.Drawing
組件:  System.Drawing (於 System.Drawing.dll)

System.Object
  System.MarshalByRefObject
    System.Drawing.Image
      System.Drawing.Bitmap

[SerializableAttribute]
[ComVisibleAttribute(true)]
public sealed class Bitmap : Image

名稱描述
System_CAPS_pubmethodBitmap(Image)

初始化的新執行個體 Bitmap 類別從指定的現有映像。

System_CAPS_pubmethodBitmap(Image, Int32, Int32)

初始化的新執行個體 Bitmap 類別從指定的現有映像,調整為指定的大小。

System_CAPS_pubmethodBitmap(Image, Size)

初始化的新執行個體 Bitmap 類別從指定的現有映像,調整為指定的大小。

System_CAPS_pubmethodBitmap(Int32, Int32)

初始化的新執行個體 Bitmap 類別,以指定的大小。

System_CAPS_pubmethodBitmap(Int32, Int32, Graphics)

初始化的新執行個體 Bitmap 類別以指定的大小,並以指定的解析度 Graphics 物件。

System_CAPS_pubmethodBitmap(Int32, Int32, Int32, PixelFormat, IntPtr)

初始化的新執行個體 Bitmap 具有指定的大小、 像素格式和像素資料類別。

System_CAPS_pubmethodBitmap(Int32, Int32, PixelFormat)

初始化的新執行個體 Bitmap 類別,以指定的大小和格式。

System_CAPS_pubmethodBitmap(Stream)

從指定的資料流,初始化 Bitmap 類別的新執行個體。

System_CAPS_pubmethodBitmap(Stream, Boolean)

從指定的資料流,初始化 Bitmap 類別的新執行個體。

System_CAPS_pubmethodBitmap(String)

從指定的檔案,初始化 Bitmap 類別的新執行個體。

System_CAPS_pubmethodBitmap(String, Boolean)

從指定的檔案,初始化 Bitmap 類別的新執行個體。

System_CAPS_pubmethodBitmap(Type, String)

初始化的新執行個體 Bitmap 類別從指定的資源。

名稱描述
System_CAPS_pubpropertyFlags

取得屬性的像素資料,這個旗標 Image(繼承自 Image。)

System_CAPS_pubpropertyFrameDimensionsList

取得 Guid 的陣列,代表在這個框架的維度 Image(繼承自 Image。)

System_CAPS_pubpropertyHeight

取得高度,單位為像素的 Image(繼承自 Image。)

System_CAPS_pubpropertyHorizontalResolution

取得水平解析度,單位為像素每英吋像這個 Image(繼承自 Image。)

System_CAPS_pubpropertyPalette

取得或設定用於此色彩調色盤 Image(繼承自 Image。)

System_CAPS_pubpropertyPhysicalDimension

取得這個影像的寬度和高度。(繼承自 Image。)

System_CAPS_pubpropertyPixelFormat

取得這個像素格式 Image(繼承自 Image。)

System_CAPS_pubpropertyPropertyIdList

取得儲存在這個內容項目的 Id Image(繼承自 Image。)

System_CAPS_pubpropertyPropertyItems

取得所有屬性的項目 (中繼資料的各個) 儲存在這個 Image(繼承自 Image。)

System_CAPS_pubpropertyRawFormat

取得這個檔案格式 Image(繼承自 Image。)

System_CAPS_pubpropertySize

取得影像的寬度和高度,單位為像素。(繼承自 Image。)

System_CAPS_pubpropertyTag

取得或設定物件,該物件提供影像的其他相關資料。(繼承自 Image。)

System_CAPS_pubpropertyVerticalResolution

取得垂直解析度,單位為像素每英吋,這 Image(繼承自 Image。)

System_CAPS_pubpropertyWidth

取得這個像素為單位的寬度, Image(繼承自 Image。)

名稱描述
System_CAPS_pubmethodClone()

建立這個 Image 的完全相同複本。(繼承自 Image。)

System_CAPS_pubmethodClone(Rectangle, PixelFormat)

建立複本的區段 Bitmap 所定義 Rectangle 結構並與指定 PixelFormat 列舉型別。

System_CAPS_pubmethodClone(RectangleF, PixelFormat)

建立複本的區段 Bitmap 定義與指定 PixelFormat 列舉型別。

System_CAPS_pubmethodCreateObjRef(Type)

建立物件,包含要產生 proxy 用來與遠端物件通訊所需的所有相關資訊。(繼承自 MarshalByRefObject。)

System_CAPS_pubmethodDispose()

釋放此 Image 所使用的所有資源。(繼承自 Image。)

System_CAPS_pubmethodEquals(Object)

判斷指定的物件是否等於目前的物件。(繼承自 Object。)

System_CAPS_pubmethodSystem_CAPS_staticFromHicon(IntPtr)

建立 Bitmap 從圖示的 Windows 控制代碼。

System_CAPS_pubmethodSystem_CAPS_staticFromResource(IntPtr, String)

建立 Bitmap 從指定的 Windows 資源。

System_CAPS_pubmethodGetBounds(GraphicsUnit)

取得使用指定單位之影像的界限。(繼承自 Image。)

System_CAPS_pubmethodGetEncoderParameterList(Guid)

傳回指定的影像編碼器支援的參數資訊。(繼承自 Image。)

System_CAPS_pubmethodGetFrameCount(FrameDimension)

傳回指定維度的框架數。(繼承自 Image。)

System_CAPS_pubmethodGetHashCode()

做為預設雜湊函式。(繼承自 Object。)

System_CAPS_pubmethodGetHbitmap()

建立 GDI 點陣圖物件與這個 Bitmap

System_CAPS_pubmethodGetHbitmap(Color)

建立 GDI 點陣圖物件與這個 Bitmap

System_CAPS_pubmethodGetHicon()

傳回圖示的控制代碼。

System_CAPS_pubmethodGetLifetimeService()

擷取目前存留期間的服務物件可控制這個執行個體的存留期原則。(繼承自 MarshalByRefObject。)

System_CAPS_pubmethodGetPixel(Int32, Int32)

在此取得指定之像素的色彩 Bitmap

System_CAPS_pubmethodGetPropertyItem(Int32)

取得指定之的屬性的項目從這個 Image(繼承自 Image。)

System_CAPS_pubmethodGetThumbnailImage(Int32, Int32, Image.GetThumbnailImageAbort, IntPtr)

傳回這個縮圖 Image(繼承自 Image。)

System_CAPS_pubmethodGetType()

取得目前執行個體的 Type(繼承自 Object。)

System_CAPS_pubmethodInitializeLifetimeService()

取得存留期服務物件,以控制這個執行個體的存留期原則。(繼承自 MarshalByRefObject。)

System_CAPS_pubmethodLockBits(Rectangle, ImageLockMode, PixelFormat)

鎖定 Bitmap 至系統記憶體。

System_CAPS_pubmethodLockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)

鎖定 Bitmap 至系統記憶體

System_CAPS_pubmethodMakeTransparent()

可讓這個 Bitmap的預設透明色彩為透明。

System_CAPS_pubmethodMakeTransparent(Color)

會指定透明的色彩這個 Bitmap

System_CAPS_pubmethodRemovePropertyItem(Int32)

移除指定之的屬性的項目從這個 Image(繼承自 Image。)

System_CAPS_pubmethodRotateFlip(RotateFlipType)

旋轉、 翻轉或旋轉和翻轉 Image(繼承自 Image。)

System_CAPS_pubmethodSave(Stream, ImageCodecInfo, EncoderParameters)

使用指定的編碼器和影像編碼器參數,將此影像儲存至指定的資料流。(繼承自 Image。)

System_CAPS_pubmethodSave(Stream, ImageFormat)

將這個影像以指定的格式儲存至指定的資料流。(繼承自 Image。)

System_CAPS_pubmethodSave(String)

這會將儲存 Image 到指定的檔案或資料流。(繼承自 Image。)

System_CAPS_pubmethodSave(String, ImageCodecInfo, EncoderParameters)

這會將儲存 Image 至指定的檔案,以指定的編碼器和影像編碼器參數。(繼承自 Image。)

System_CAPS_pubmethodSave(String, ImageFormat)

這會將儲存 Image 至指定的檔案中指定的格式。(繼承自 Image。)

System_CAPS_pubmethodSaveAdd(EncoderParameters)

將框架加入先前的 Save 方法呼叫所指定的檔案或資料流。 使用這個方法以從多重框架影像儲存選取框架至另一個多重框架影像。(繼承自 Image。)

System_CAPS_pubmethodSaveAdd(Image, EncoderParameters)

將框架加入先前的 Save 方法呼叫所指定的檔案或資料流。(繼承自 Image。)

System_CAPS_pubmethodSelectActiveFrame(FrameDimension, Int32)

選取由維度和索引所指定的框架。(繼承自 Image。)

System_CAPS_pubmethodSetPixel(Int32, Int32, Color)

設定此 Bitmap 中指定之像素的色彩。

System_CAPS_pubmethodSetPropertyItem(PropertyItem)

在這個 Image 中儲存屬性項目 (中繼資料的項目)。(繼承自 Image。)

System_CAPS_pubmethodSetResolution(Single, Single)

設定這個解析度 Bitmap

System_CAPS_pubmethodToString()

傳回代表目前物件的字串。(繼承自 Object。)

System_CAPS_pubmethodUnlockBits(BitmapData)

這會解除鎖定 Bitmap 與系統記憶體。

名稱描述
System_CAPS_pubinterfaceSystem_CAPS_privmethodISerializable.GetObjectData(SerializationInfo, StreamingContext)

將序列化目標物件所需的資料填入 SerializationInfo(繼承自 Image。)

點陣圖的像素資料的圖形映像和其屬性所組成。 有許多標準格式將點陣圖儲存至檔案。GDI+ 支援下列檔案格式︰ BMP、 GIF、 EXIF、 JPG、 PNG 及 TIFF。 如需支援之格式的詳細資訊,請參閱 點陣圖類型

您也可以使用其中一個從檔案、 資料流和其他來源建立映像 Bitmap 建構函式並將它們儲存至資料流或檔案系統與 Save 方法。 映像會繪製到螢幕或記憶體使用 DrawImage 方法 Graphics 物件。 如需使用映像檔的相關主題的清單,請參閱 使用影像、點陣圖、圖示和中繼檔

System_CAPS_note注意

Bitmap 類別不能存取在應用程式定義域。 例如,如果您建立動態 AppDomain 和該網域,然後傳遞這些物件回到主要應用程式定義域中建立幾筆刷、 畫筆與點陣圖,您可以順利使用畫筆和筆刷。 不過,如果您呼叫 DrawImage 方法繪製封送處理 Bitmap, ,您會收到下列例外狀況。

遠端處理型別"System.Drawing.Image"上找不到欄位 「 原生映像 」。

下列程式碼範例示範如何建構新 Bitmap 從檔案、 使用 GetPixelSetPixel 方法,以將影像重新著色。 它也會使用 PixelFormat, ,Width, ,和 Height 屬性。

這個範例設計來搭配 Windows Form 包含 Label, ,PictureBox, ,和 Button 名為 Label1, ,PictureBox1, ,和 Button1, 分別。 程式碼貼到表單,並將關聯 Button1_Click 方法與按鈕的 Click 事件。

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.");
    }
}

.NET Framework
自 1.1 起供應

此類型的任何 public static (在 Visual Basic 中 共用 在 Visual Basic 中) 成員皆為安全執行緒。不保證任何執行個體成員為安全執行緒。

回到頁首
顯示: