Metodo ID2D1Bitmap::CopyFromBitmap (d2d1.h)

Articolo
08/22/2023

Copia l'area specificata dalla bitmap specificata nella bitmap corrente.

Sintassi

HRESULT CopyFromBitmap(
  [in, optional] const D2D1_POINT_2U *destPoint,
  [in]           ID2D1Bitmap         *bitmap,
  [in, optional] const D2D1_RECT_U   *srcRect
);

Parametri

[in, optional] destPoint

Tipo: const D2D1_POINT_2U*

Nella bitmap corrente, l'angolo superiore sinistro dell'area in cui viene copiata l'area specificata da srcRect .

[in] bitmap

Tipo: ID2D1Bitmap*

Bitmap da cui copiare.

[in, optional] srcRect

Tipo: const D2D1_RECT_U*

Area della bitmap da copiare .

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo non aggiorna le dimensioni della bitmap corrente. Se il contenuto della bitmap di origine non è adatto alla bitmap corrente, questo metodo ha esito negativo. Si noti inoltre che questo metodo non esegue la conversione del formato e avrà esito negativo se i formati bitmap non corrispondono.

La chiamata a questo metodo può causare lo scaricamento del batch corrente se la bitmap è attiva nel batch. Se il batch scaricato non viene completato correttamente, questo metodo ha esito negativo. Tuttavia, questo metodo non cancella lo stato di errore della destinazione di rendering in cui è stato scaricato il batch. Lo stato HRESULT e tag non riuscito verrà restituito alla chiamata successiva a EndDraw o Flush.

A partire da Windows 8.1, questo metodo supporta le bitmap compresse bloccate. Se si usa un formato compresso a blocchi, le coordinate finali del parametro srcRect devono essere multiple di 4 o il metodo restituisce E_INVALIDARG.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	d2d1.h
Libreria	D2d1.lib
DLL	D2d1.dll

Vedi anche

ID2D1Bitmap

Condividi tramite