Share via

ID2D1Bitmap::CopyFromRenderTarget, méthode (d2d1.h)

  • Article

Copie la région spécifiée de la cible de rendu spécifiée dans la bitmap actuelle.

Syntaxe

HRESULT CopyFromRenderTarget(
  [in, optional] const D2D1_POINT_2U *destPoint,
  [in]           ID2D1RenderTarget   *renderTarget,
  [in, optional] const D2D1_RECT_U   *srcRect
);

Paramètres

[in, optional] destPoint

Type : const D2D1_POINT_2U*

Dans la bitmap actuelle, le coin supérieur gauche de la zone dans laquelle la région spécifiée par srcRect est copiée.

[in] renderTarget

Type : ID2D1RenderTarget*

Cible de rendu qui contient la région à copier.

[in, optional] srcRect

Type : const D2D1_RECT_U*

Zone de renderTarget à copier.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, il retourne un code d’erreur HRESULT .

Remarques

Cette méthode ne met pas à jour la taille de l’image bitmap actuelle. Si le contenu de l’image bitmap source ne tient pas dans la bitmap actuelle, cette méthode échoue. Notez également que cette méthode n’effectue pas de conversion de format et échoue si les formats bitmap ne correspondent pas.

L’appel de cette méthode peut entraîner la vidage du lot actuel si la bitmap est active dans le lot. Si le lot qui a été vidé ne se termine pas correctement, cette méthode échoue. Toutefois, cette méthode n’efface pas l’état d’erreur de la cible de rendu sur laquelle le lot a été vidé. L’état HRESULT et tag défaillants seront retournés lors de l’appel suivant à EndDraw ou Flush.

Tous les clips et couches doivent être extraits de la cible de rendu avant d’appeler cette méthode. La méthode retourne D2DERR_RENDER_TARGET_HAS_LAYER_OR_CLIPRECT si des clips ou des couches sont actuellement appliqués à la cible de rendu.

Configuration requise

   
Client minimal pris en charge Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête d2d1.h
Bibliothèque D2d1.lib
DLL D2d1.dll

Voir aussi

ID2D1Bitmap