ID2D1RenderTarget::PushLayer(constD2D1_LAYER_PARAMETERS*,ID2D1Layer*) method (d2d1.h)
Adds the specified layer to the render target so that it receives all subsequent drawing operations until PopLayer is called.
Syntax
void PushLayer(
[in] const D2D1_LAYER_PARAMETERS *layerParameters,
[in] ID2D1Layer *layer
);
Parameters
[in] layerParameters
Type: const D2D1_LAYER_PARAMETERS*
The content bounds, geometric mask, opacity, opacity mask, and antialiasing options for the layer.
[in] layer
Type: ID2D1Layer*
The layer that receives subsequent drawing operations.
Return value
None
Remarks
The PushLayer method allows a caller to begin redirecting rendering to a layer. All rendering operations are valid in a layer. The location of the layer is affected by the world transform set on the render target.
Each PushLayer must have a matching PopLayer call. If there are more PopLayer calls than PushLayer calls, the render target is placed into an error state. If Flush is called before all outstanding layers are popped, the render target is placed into an error state, and an error is returned. The error state can be cleared by a call to EndDraw.
A particular ID2D1Layer resource can be active only at one time. In other words, you cannot call a PushLayer method, and then immediately follow with another PushLayer method with the same layer resource. Instead, you must call the second PushLayer method with different layer resources.
This method doesn't return an error code if it fails. To determine whether a drawing operation (such as PushLayer) failed, check the result returned by the ID2D1RenderTarget::EndDraw or ID2D1RenderTarget::Flush methods.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps | UWP apps] |
| Minimum supported server | Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | UWP apps] |
| Target Platform | Windows |
| Header | d2d1.h |
| Library | D2d1.lib |
| DLL | D2d1.dll |