Metodo ID2D1Bitmap::CopyFromBitmap (d2d1.h)

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

Vedi anche

ID2D1Bitmap