ImageLockMode 列舉

定義

命名空間:

System.Drawing.Imaging

組件:

System.Drawing.Common.dll

套件:

System.Drawing.Common v8.0.0

來源:

ImageLockMode.cs

指定傳遞至 LockBits 方法的旗標參數之旗標。 LockBits 方法會鎖定影像的部分，以便您可以讀取或寫入像素資料。

public enum ImageLockMode

繼承

Object

ValueType

Enum

ImageLockMode

欄位

名稱	值	Description
ReadOnly	1	指定鎖定影像的部分供讀取之用。
ReadWrite	3	指定鎖定影像的部分供讀取或寫入之用。
UserInputBuffer	4	指定用來讀取或寫入像素資料的緩衝區是由使用者所配置。 如果設定這個旗標，則 LockBits 方法的 flags 參數會做為輸入參數 (也可能做為輸出參數)。 如果清除這個旗標，則 flags 參數只會做為輸出參數。
WriteOnly	2	指定鎖定影像的部分供寫入之用。

範例

下列程式代碼範例示範如何使用、、 和屬性、LockBits和 UnlockBits 方法，以及 ImageLockMode 列舉。Scan0WidthHeightPixelFormat 此範例的設計目的是要與 Windows Forms 搭配使用。 若要執行此範例，請將它貼到表單中，並藉由呼叫 方法來處理表單Paint的事件，並e傳遞為 PaintEventArgs。LockUnlockBitsExample

private void LockUnlockBitsExample(PaintEventArgs e)
    {

        // Create a new bitmap.
        Bitmap bmp = new Bitmap("c:\\fakePhoto.jpg");

        // Lock the bitmap's bits.  
        Rectangle rect = new Rectangle(0, 0, bmp.Width, bmp.Height);
        System.Drawing.Imaging.BitmapData bmpData =
            bmp.LockBits(rect, System.Drawing.Imaging.ImageLockMode.ReadWrite,
            bmp.PixelFormat);

        // Get the address of the first line.
        IntPtr ptr = bmpData.Scan0;

        // Declare an array to hold the bytes of the bitmap.
        int bytes  = Math.Abs(bmpData.Stride) * bmp.Height;
        byte[] rgbValues = new byte[bytes];

        // Copy the RGB values into the array.
        System.Runtime.InteropServices.Marshal.Copy(ptr, rgbValues, 0, bytes);

        // Set every third value to 255. A 24bpp bitmap will look red.  
        for (int counter = 2; counter < rgbValues.Length; counter += 3)
            rgbValues[counter] = 255;

        // Copy the RGB values back to the bitmap
        System.Runtime.InteropServices.Marshal.Copy(rgbValues, 0, ptr, bytes);

        // Unlock the bits.
        bmp.UnlockBits(bmpData);

        // Draw the modified image.
        e.Graphics.DrawImage(bmp, 0, 150);
    }

適用於