ID2D1Bitmap ::CopyFromBitmap, méthode (d2d1.h)
Copie la région spécifiée de la bitmap spécifiée dans la bitmap actuelle.
Syntaxe
HRESULT CopyFromBitmap(
[in, optional] const D2D1_POINT_2U *destPoint,
[in] ID2D1Bitmap *bitmap,
[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] bitmap
Type : ID2D1Bitmap*
Bitmap à partir de laquelle effectuer la copie.
[in, optional] srcRect
Type : const D2D1_RECT_U*
Zone de bitmap à copier.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT .
Remarques
Cette méthode ne met pas à jour la taille de la bitmap actuelle. Si le contenu de la 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 le 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 la balise défaillants seront retournés lors de l’appel suivant à EndDraw ou Flush.
À compter de Windows 8.1, cette méthode prend en charge les bitmaps compressées par bloc. Si vous utilisez un format compressé par bloc, les coordonnées de fin du paramètre srcRect doivent être des multiples de 4 ou la méthode retourne E_INVALIDARG.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 Platform Update pour Windows Server 2008 [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | d2d1.h |
| Bibliothèque | D2d1.lib |
| DLL | D2d1.dll |