public CanvasDrawingSession CreateDrawingSession(
	Rect updateRectangle
)

Parameters

updateRectangle

Type: Windows.FoundationRect

Return Value

The specified region of the image is cleared to the ClearColor before this method returns. The region is in device independent pixels (DIPs). Regions that need to be updated are provided by the InvalidatedRegions property passed to the RegionsInvalidated event handler.

CreateDrawingSession may be called on any thread, but the returned drawing session must be disposed on the UI thread. If you want to move your drawing work to a different thread, either:

1. On an arbitrary non-UI thread:
   • CreateDrawingSession
   • Issue drawing calls
   • SuspendDrawingSession(CanvasDrawingSession)
2. Back on the UI thread:
   • drawingSession.Dispose()

or:

1. On the UI thread:
   • CreateDrawingSession
   • SuspendDrawingSession(CanvasDrawingSession)
2. Move to an arbitrary non-UI thread:
   • ResumeDrawingSession(CanvasDrawingSession)
   • Issue drawing calls
   • SuspendDrawingSession(CanvasDrawingSession)
3. Back on the UI thread:
   • drawingSession.Dispose()

Reference