WriteableBitmap.Lock Метод

Определение

Резервирует задний буфер для обновлений.

public:
 void Lock();
public void Lock ();
member this.Lock : unit -> unit
Public Sub Lock ()

Примеры

В следующем примере кода показано, как зарезервировать задний буфер с помощью Lock метода .

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

Комментарии

Метод Lock увеличивает количество блокировок. WriteableBitmap Если объект заблокирован, система отрисовки не отправляет обновления, пока WriteableBitmap не будет полностью разблокирован вызовами Unlock метода .

Метод можно использовать для поддержки Lock многопоточных реализаций. В этих сценариях поток пользовательского интерфейса блокирует растровое изображение и предоставляет задний буфер другим потокам. Когда рабочий поток завершает кадр, поток пользовательского интерфейса добавляет измененные прямоугольники и разблокирует буфер.

Поток пользовательского интерфейса может блокироваться, когда поток отрисовки получает блокировку на заднем буфере, чтобы скопировать его в передний буфер. Если задержка от этого блока слишком длинна, используйте TryLock метод , чтобы подождать некоторое время, а затем разблокировать поток пользовательского интерфейса для выполнения других задач, пока задний буфер заблокирован.

Применяется к

См. также раздел