ID2D1Bitmap：：CopyFromBitmap 方法 (d2d1.h)
將指定的區域從指定的點陣圖複製到目前的點陣圖。
語法
HRESULT CopyFromBitmap(
[in, optional] const D2D1_POINT_2U *destPoint,
[in] ID2D1Bitmap *bitmap,
[in, optional] const D2D1_RECT_U *srcRect
);
參數
[in, optional] destPoint
類型： const D2D1_POINT_2U*
在目前的點陣圖中，會複製 srcRect 所指定區域的左上角。
[in] bitmap
類型： ID2D1Bitmap*
要從中複製的點陣圖。
[in, optional] srcRect
類型： const D2D1_RECT_U*
要複製之 點陣圖 的區域。
傳回值
類型： HRESULT
如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
這個方法不會更新目前點陣圖的大小。 如果來源位圖的內容不符合目前的點陣圖，這個方法就會失敗。 此外，請注意，這個方法不會執行格式轉換，而且如果點圖格式不符，將會失敗。
如果點圖在批次中使用中，呼叫這個方法可能會導致目前的批次排清。 如果排清的批次未順利完成，這個方法就會失敗。 不過，這個方法不會清除批次排清所在轉譯目標的錯誤狀態。 失敗 的 HRESULT 和標記狀態會在下一次 呼叫 EndDraw 或 Flush 時傳回。
從 Windows 8.1 開始，這個方法支援區塊壓縮位圖。 如果您使用區塊壓縮格式， srcRect 參數的結束座標必須是 4 的倍數，否則方法會 傳回E_INVALIDARG。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 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 |