ID2D1Bitmap::CopyFromRenderTarget, méthode (d2d1.h)
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 |