共用方式為


ID2D1Bitmap::CopyFromRenderTarget 方法 (d2d1.h)

將指定的轉譯目標中指定的區域複製到目前的點陣圖。

語法

HRESULT CopyFromRenderTarget(
  [in, optional] const D2D1_POINT_2U *destPoint,
  [in]           ID2D1RenderTarget   *renderTarget,
  [in, optional] const D2D1_RECT_U   *srcRect
);

參數

[in, optional] destPoint

類型:const D2D1_POINT_2U*

在目前的點陣圖中,複製 srcRect 所指定區域的左上角。

[in] renderTarget

類型: ID2D1RenderTarget*

包含要複製之區域的轉譯目標。

[in, optional] srcRect

類型:const D2D1_RECT_U*

要複製的 renderTarget 區域。

傳回值

類型: HRESULT

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

這個方法不會更新目前點陣圖的大小。 如果來源點陣圖的內容不符合目前的點陣圖,這個方法就會失敗。 此外,請注意,此方法不會執行格式轉換,而且如果點陣圖格式不相符,將會失敗。

如果點陣圖在批次中為作用中,則呼叫這個方法可能會導致目前的批次排清。 如果排清的批次未順利完成,這個方法就會失敗。 不過,此方法不會清除批次排清所在的轉譯目標錯誤狀態。 失敗 的 HRESULT 和標籤狀態會在下一次呼叫 EndDrawFlush時傳回。

呼叫此方法之前,所有剪輯和圖層都必須從轉譯目標取出。 如果目前有任何剪輯或圖層套用至轉譯目標,此方法會傳回 D2DERR_RENDER_TARGET_HAS_LAYER_OR_CLIPRECT

規格需求

   
最低支援的用戶端 適用于 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 d2d1.h
程式庫 D2d1.lib
Dll D2d1.dll

另請參閱

ID2D1Bitmap