IWICImagingFactory::CreateBitmapFromSourceRect-Methode (wincodec.h)

Erstellt eine IWICBitmap aus einem angegebenen Rechteck einer IWICBitmapSource.

Syntax

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

Parameter

[in] pIBitmapSource

Typ: IWICBitmapSource*

Die IWICBitmapSource , aus der die Bitmap erstellt werden soll.

[in] x

Typ: UINT

Die horizontale Koordinate der oberen linken Ecke des Rechtecks.

[in] y

Typ: UINT

Die vertikale Koordinate der oberen linken Ecke des Rechtecks.

[in] width

Typ: UINT

Die Breite des Rechtecks und der neuen Bitmap.

[in] height

Typ: UINT

Die Höhe des Rechtecks und der neuen Bitmap.

[out] ppIBitmap

Typ: IWICBitmap**

Ein Zeiger, der einen Zeiger auf die neue Bitmap empfängt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Das Bereitstellen eines Rechtecks, das größer als die Quelle ist, führt zu nicht definierten Ergebnissen.

Diese Methode erstellt immer eine separate Kopie des Quellimages, ähnlich der Cacheoption WICBitmapCacheOnLoad.

Anforderungen