WriteableBitmap.AddDirtyRect(Int32Rect) 메서드

정의

네임스페이스:

System.Windows.Media.Imaging

어셈블리:

PresentationCore.dll

변경된 비트맵의 영역을 지정합니다.

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)

매개 변수

dirtyRect

Int32Rect

변경된 영역을 나타내는 Int32Rect입니다. 크기는 픽셀 단위입니다.

예외

InvalidOperationException

Lock() 또는 TryLock(Duration) 메서드를 호출하여 비트맵을 잠그지 않은 경우

ArgumentOutOfRangeException

dirtyRect가 WriteableBitmap의 경계를 벗어났습니다.

예제

다음 코드 예제를 사용 하 여 AddDirtyRect 변경 된 백 버퍼의 영역을 지정 하는 방법을 보여 드립니다 메서드.

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

설명

메서드를 AddDirtyRect 호출하여 코드가 백 버퍼에 적용한 변경 내용을 나타냅니다.

이 메서드를 여러 번 호출하면 변경된 영역이 충분한 표현으로 누적되지만 반드시 최소한의 표현은 아닙니다. 효율성을 위해 더티로 표시된 영역만 전면 버퍼로 복사되도록 보장됩니다. 그러나 비트맵의 모든 부분이 앞으로 복사될 수 있으므로 전체 백 버퍼가 항상 유효한지 확인해야 합니다.

클래스 설명에 AddDirtyRect 설명된 대로 및 Unlock 메서드 호출 간에만 메서드를 WriteableBitmap 호출 Lock 합니다.