WriteableBitmap.AddDirtyRect(Int32Rect) Método

Definición

Espacio de nombres:

System.Windows.Media.Imaging

Ensamblado:

PresentationCore.dll

Especifica el área del mapa de bits que cambió.

public:
 void AddDirtyRect(System::Windows::Int32Rect dirtyRect);

public void AddDirtyRect (System.Windows.Int32Rect dirtyRect);

member this.AddDirtyRect : System.Windows.Int32Rect -> unit

Public Sub AddDirtyRect (dirtyRect As Int32Rect)

Parámetros

dirtyRect

Int32Rect

Int32Rect que representa el área que ha cambiado. Las dimensiones se expresan en píxeles.

Excepciones

InvalidOperationException

El mapa de bits no se ha bloqueado mediante una llamada al método Lock() o TryLock(Duration).

ArgumentOutOfRangeException

dirtyRect está fuera de los límites de WriteableBitmap.

Ejemplos

En el ejemplo de código siguiente se muestra cómo especificar el área del búfer de reserva que cambió mediante el AddDirtyRect método .

    // The DrawPixel method updates the WriteableBitmap by using
    // unsafe code to write a pixel into the back buffer.
    static void DrawPixel(MouseEventArgs e)
    {
        int column = (int)e.GetPosition(i).X;
        int row = (int)e.GetPosition(i).Y;

        try{
            // Reserve the back buffer for updates.
            writeableBitmap.Lock();

            unsafe
            {
                // Get a pointer to the back buffer.
                IntPtr pBackBuffer = writeableBitmap.BackBuffer;

                // Find the address of the pixel to draw.
                pBackBuffer += row * writeableBitmap.BackBufferStride;
                pBackBuffer += column * 4;

                // Compute the pixel's color.
                int color_data = 255 << 16; // R
                color_data |= 128 << 8;   // G
                color_data |= 255 << 0;   // B

                // Assign the color data to the pixel.
                *((int*) pBackBuffer) = color_data;
            }

            // Specify the area of the bitmap that changed.
            writeableBitmap.AddDirtyRect(new Int32Rect(column, row, 1, 1));
        }
        finally{
            // Release the back buffer and make it available for display.
            writeableBitmap.Unlock();
        }
    }

Comentarios

Llame al AddDirtyRect método para indicar los cambios realizados en el búfer de reserva del código.

Cuando se llama a este método varias veces, las áreas modificadas se acumulan en una representación suficiente, pero no necesariamente mínima. Por eficiencia, solo se garantiza que las áreas marcadas como sucias se copien hacia delante en el búfer frontal. Sin embargo, cualquier parte del mapa de bits se puede copiar hacia delante, por lo que debe asegurarse de que todo el búfer de reserva siempre es válido.

Llame al AddDirtyRect método solo entre las llamadas a los Lock métodos y Unlock , como se describe en los comentarios de la WriteableBitmap clase.