WriteableBitmap.Lock Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Rezerwuje bufor wsteczny dla aktualizacji.
public:
void Lock();
public void Lock ();
member this.Lock : unit -> unit
Public Sub Lock ()
Przykłady
Poniższy przykład kodu pokazuje, jak zarezerwować bufor wsteczny przy użyciu Lock metody .
// 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();
}
}
Uwagi
Metoda Lock zwiększa liczbę blokad. WriteableBitmap Gdy element jest zablokowany, system renderowania nie wysyła aktualizacji WriteableBitmap do momentu pełnego odblokowania przez wywołania metody Unlock .
Za pomocą Lock metody można obsługiwać implementacje wielowątkowe. W tych scenariuszach wątek interfejsu użytkownika blokuje mapę bitową i uwidacznia bufor wsteczny do innych wątków. Po zakończeniu ramki wątek procesu roboczego wątek interfejsu użytkownika dodaje zmienione prostokąty i odblokowuje bufor.
Wątek interfejsu użytkownika może blokować, gdy wątek renderowania uzyskuje blokadę w buforze wstecznym, aby skopiować go do buforu frontu. Jeśli opóźnienie z tego bloku jest zbyt długie, użyj TryLock metody , aby poczekać krótki czas, a następnie odblokować wątek interfejsu użytkownika, aby wykonać inne zadania, gdy bufor wsteczny jest zablokowany.