Click or drag to resize
CanvasDrawingSessionCreateLayer Method (Single, ICanvasBrush, Rect, CanvasGeometry, Matrix3x2, CanvasLayerOptions)
Creates a layer that will clip its contents to a rectangle and/or geometry region, and blend using the specified opacity and/or opacity mask brush.

Namespace:  Microsoft.Graphics.Canvas
Assembly:  Microsoft.Graphics.Canvas (in Microsoft.Graphics.Canvas.dll) Version: 0.0.0.0
Syntax
C#
Copy
public CanvasActiveLayer CreateLayer(
	float opacity,
	ICanvasBrush opacityBrush,
	Rect clipRectangle,
	CanvasGeometry clipGeometry,
	Matrix3x2 geometryTransform,
	CanvasLayerOptions options
)

Parameters

opacity
Type: SystemSingle
opacityBrush
Type: Microsoft.Graphics.Canvas.BrushesICanvasBrush
clipRectangle
Type: Windows.FoundationRect
clipGeometry
Type: Microsoft.Graphics.Canvas.GeometryCanvasGeometry
geometryTransform
Type: System.NumericsMatrix3x2
options
Type: Microsoft.Graphics.CanvasCanvasLayerOptions

Return Value

Type: CanvasActiveLayer
Remarks

The layer affects all drawing until the returned CanvasActiveLayer object is closed. In C# this is typically done with a 'using' statement, or in C++/CX the 'delete' keyword.

Antialising mode of the clip geometry is determined by the value of the Antialiasing property when CreateLayer is called.

For more information about layers, see CanvasActiveLayer.

See Also