MÉTHODE ID2D1RenderTarget ::P ushLayer(constD2D1_LAYER_PARAMETERS*,ID2D1Layer*) (d2d1.h)

Ajoute la couche spécifiée à la cible de rendu afin qu’elle reçoive toutes les opérations de dessin suivantes jusqu’à ce que PopLayer soit appelé.

Syntaxe

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

Paramètres

[in] layerParameters

Type : const D2D1_LAYER_PARAMETERS*

Les limites de contenu, le masque géométrique, l’opacité, le masque d’opacité et les options d’anticrénelage pour le calque.

[in] layer

Type : ID2D1Layer*

Couche qui reçoit les opérations de dessin suivantes.

Valeur de retour

None

Remarques

La méthode PushLayer permet à un appelant de commencer à rediriger le rendu vers une couche. Toutes les opérations de rendu sont valides dans une couche. L’emplacement de la couche est affecté par le jeu de transformation universel sur la cible de rendu.

Chaque PushLayer doit avoir un appel PopLayer correspondant. S’il y a plus d’appels PopLayer que d’appels PushLayer , la cible de rendu est placée dans un état d’erreur. Si Flush est appelé avant que toutes les couches en attente ne soient déclenchées, la cible de rendu est placée dans un état d’erreur et une erreur est retournée. L’état d’erreur peut être effacé par un appel à EndDraw.

Une ressource ID2D1Layer particulière ne peut être active qu’à la fois. En d’autres termes, vous ne pouvez pas appeler une méthode PushLayer , puis suivre immédiatement une autre méthode PushLayer avec la même ressource de couche. Au lieu de cela, vous devez appeler la deuxième méthode PushLayer avec différentes ressources de couche.

Cette méthode ne retourne pas de code d’erreur en cas d’échec. Pour déterminer si une opération de dessin (telle que PushLayer) a échoué, case activée le résultat retourné par les méthodes ID2D1RenderTarget ::EndDraw ou ID2D1RenderTarget ::Flush.

Configuration requise

Voir aussi

ID2D1RenderTarget

Vue d’ensemble des couches

PopLayer