ImageLockMode Enumeração

Definição

Namespace:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Origem:

ImageLockMode.cs

Especifica os sinalizadores passados para o parâmetro de sinalizadores do método LockBits. O método LockBits bloqueia uma parte de uma imagem para que seja possível ler ou gravar os dados de pixel.

C#

public enum ImageLockMode

Herança

Object

ValueType

Enum

ImageLockMode

Campos

Nome	Valor	Description
ReadOnly	1	Especifica que uma parte da imagem está bloqueada para leitura.
ReadWrite	3	Especifica que uma parte da imagem está bloqueada para leitura ou gravação.
UserInputBuffer	4	Especifica que o buffer usado para ler ou gravar dados de pixel foi alocado pelo usuário. Se esse sinalizador estiver definido, o parâmetro flags do método LockBits funcionará como um parâmetro de entrada (e possivelmente como um parâmetro de saída). Se esse sinalizador estiver desmarcado, o parâmetro flags funcionará apenas como um parâmetro de saída.
WriteOnly	2	Especifica que uma parte da imagem está bloqueada para gravação.

Exemplos

O exemplo de código a seguir demonstra como usar as PixelFormatpropriedades , Height, Widthe Scan0 , e os LockBits métodos e UnlockBits e a ImageLockMode enumeração . Este exemplo foi projetado para ser usado com Windows Forms. Para executar este exemplo, cole-o em um formulário e manipule o evento do Paint formulário chamando o LockUnlockBitsExample método , passando e como PaintEventArgs.

C#

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

Aplica-se a