Método ID2D1RenderTarget::P ushLayer(constD2D1_LAYER_PARAMETERS*,ID2D1Layer*) (d2d1.h)

Adiciona a camada especificada ao destino de renderização para que ela receba todas as operações de desenho subsequentes até que o PopLayer seja chamado.

Sintaxe

void PushLayer(
  [in] const D2D1_LAYER_PARAMETERS *layerParameters,
  [in] ID2D1Layer                  *layer
);

Parâmetros

[in] layerParameters

Tipo: const D2D1_LAYER_PARAMETERS*

Os limites de conteúdo, a máscara geométrica, a opacidade, a máscara de opacidade e as opções de suavização da camada.

[in] layer

Tipo: ID2D1Layer*

A camada que recebe as operações de desenho subsequentes.

Retornar valor

Nenhum

Comentários

O método PushLayer permite que um chamador comece a redirecionar a renderização para uma camada. Todas as operações de renderização são válidas em uma camada. O local da camada é afetado pelo conjunto de transformações do mundo no destino de renderização.

Cada PushLayer deve ter uma chamada PopLayer correspondente. Se houver mais chamadas poplayer do que chamadas do PushLayer , o destino de renderização será colocado em um estado de erro. Se Flush for chamado antes que todas as camadas pendentes sejam exibidas, o destino de renderização será colocado em um estado de erro e um erro será retornado. O estado de erro pode ser limpo por uma chamada para EndDraw.

Um recurso ID2D1Layer específico pode estar ativo apenas uma vez. Em outras palavras, você não pode chamar um método PushLayer e, em seguida, seguir imediatamente com outro método PushLayer com o mesmo recurso de camada. Em vez disso, você deve chamar o segundo método PushLayer com recursos de camada diferentes.

Esse método não retornará um código de erro se falhar. Para determinar se uma operação de desenho (como PushLayer) falhou, marcar o resultado retornado pelos métodos ID2D1RenderTarget::EndDraw ou ID2D1RenderTarget::Flush.

Requisitos

Confira também

ID2D1RenderTarget

Visão geral das camadas

PopLayer