ImageLockMode Enumerazione

Definizione

Specifica i flag passati al parametro dei flag del metodo LockBits. Il metodo LockBits blocca una porzione di un'immagine in modo da consentire la lettura o la scrittura dei dati pixel.

public enum ImageLockMode
Ereditarietà
ImageLockMode

Campi

ReadOnly 1

Specifica il blocco di una porzione dell'immagine per consentirne la lettura.

ReadWrite 3

Specifica il blocco di una porzione dell'immagine per consentirne la lettura o la scrittura.

UserInputBuffer 4

Specifica che il buffer utilizzato per la lettura o la scrittura dei dati pixel è allocato dall'utente. Se il flag è impostato, il parametro flags del metodo LockBits fungerà da parametro di input e possibilmente da parametro di output. Diversamente, flags fungerà solo da parametro di output.

WriteOnly 2

Specifica il blocco di una porzione dell'immagine per consentirne la scrittura.

Esempio

Nell'esempio di codice seguente viene illustrato come usare le PixelFormatproprietà , , WidthHeighte , i LockBits metodi e UnlockBitsScan0 e l'enumerazioneImageLockMode. Questo esempio è progettato per essere usato con Windows Forms. Per eseguire questo esempio, incollarlo in un modulo e gestire l'evento del Paint modulo chiamando il LockUnlockBitsExample metodo, passando e come PaintEventArgs.

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

Si applica a

Prodotto Versioni
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9