Metodo ID2D1Bitmap::CopyFromRenderTarget (d2d1.h)

Copia l'area specificata dalla destinazione di rendering specificata nella bitmap corrente.

Sintassi

HRESULT CopyFromRenderTarget(
  [in, optional] const D2D1_POINT_2U *destPoint,
  [in]           ID2D1RenderTarget   *renderTarget,
  [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] renderTarget

Tipo: ID2D1RenderTarget*

Destinazione di rendering che contiene l'area da copiare.

[in, optional] srcRect

Tipo: const D2D1_RECT_U*

Area di renderTarget 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 rientra nella 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 verranno restituiti alla chiamata successiva a EndDraw o Flush.

Tutte le clip e i livelli devono essere estratti dalla destinazione di rendering prima di chiamare questo metodo. Il metodo restituisce D2DERR_RENDER_TARGET_HAS_LAYER_OR_CLIPRECT se alla destinazione di rendering vengono applicati clip o livelli.

Requisiti

Vedi anche

ID2D1Bitmap