共用方式為

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

另請參閱

ID2D1Bitmap