IWICImagingFactory：：CreateBitmapFromSourceRect 方法 (wincodec.h)

從 IWICBitmapSource 的指定矩形建立 IWICBitmap。

語法

HRESULT CreateBitmapFromSourceRect(
  [in]  IWICBitmapSource *pIBitmapSource,
  [in]  UINT             x,
  [in]  UINT             y,
  [in]  UINT             width,
  [in]  UINT             height,
  [out] IWICBitmap       **ppIBitmap
);

參數

[in] pIBitmapSource

類型： IWICBitmapSource*

要從中建立點陣圖的 IWICBitmapSource 。

[in] x

類型： UINT

矩形左上角的水準座標。

[in] y

類型： UINT

矩形左上角的垂直座標。

[in] width

類型： UINT

矩形和新點陣圖的寬度。

[in] height

類型： UINT

矩形的高度和新點陣圖。

[out] ppIBitmap

類型： IWICBitmap**

接收新點陣圖指標的指標。

傳回值

類型： HRESULT

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

備註

提供大於來源的矩形會產生未定義的結果。

這個方法一律會建立來源影像的個別複本，類似于快取選項 WICBitmapCacheOnLoad。

規格需求

最低支援的用戶端	Windows XP 搭配 SP2、Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	wincodec.h
程式庫	Windowscodecs.lib
Dll	Windowscodecs.dll