IPicture::Metode render (ocidl.h)

Artikel
02/29/2024

Merender (menggambar) bagian tertentu dari gambar yang ditentukan oleh offset (xSrc,ySrc) dari gambar sumber dan dimensi yang akan disalin (cxSrc,xySrc). Gambar ini dirender ke konteks perangkat yang ditentukan, diposisikan pada titik (x,y), dan diskalakan ke dimensi (cx,cy). Parameter prcWBounds menentukan posisi penyajian ini jika konteks perangkat tujuan itu sendiri adalah metafile. Informasi tersebut diperlukan untuk menempatkan satu metafile di metafile lain. Untuk informasi selengkapnya, lihat parameter prcWBounds dari IViewObject2::D raw.

Sintaks

HRESULT Render(
  [in] HDC                hDC,
  [in] LONG               x,
  [in] LONG               y,
  [in] LONG               cx,
  [in] LONG               cy,
  [in] OLE_XPOS_HIMETRIC  xSrc,
  [in] OLE_YPOS_HIMETRIC  ySrc,
  [in] OLE_XSIZE_HIMETRIC cxSrc,
  [in] OLE_YSIZE_HIMETRIC cySrc,
  [in] LPCRECT            pRcWBounds
);

Parameter

[in] hDC

Handel konteks perangkat untuk merender gambar.

[in] x

Koordinat horizontal dalam hdc untuk menempatkan gambar yang dirender.

[in] y

Koordinat vertikal dalam hdc untuk menempatkan gambar yang dirender.

[in] cx

Dimensi horizontal (lebar) persegi panjang tujuan.

[in] cy

Dimensi vertikal (tinggi) persegi panjang tujuan

[in] xSrc

Offset horizontal dalam gambar sumber untuk mulai menyalin.

[in] ySrc

Offset vertikal dalam gambar sumber untuk mulai menyalin.

[in] cxSrc

Tingkat horizontal untuk disalin dari gambar sumber.

[in] cySrc

Jangkauan vertikal untuk disalin dari gambar sumber.

[in] pRcWBounds

Penunjuk ke persegi panjang yang berisi posisi tujuan dalam konteks perangkat metafile jika hdc adalah DC metafile. Tidak boleh NULL dalam kasus seperti itu.

Nilai kembali

Metode ini mendukung nilai pengembalian standar E_FAIL, E_INVALIDARG, dan E_OUTOFMEMORY, serta berikut ini:

Menampilkan kode	Deskripsi
S_OK	Gambar berhasil dirender.
E_POINTER	Alamat dalam prcWBounds tidak valid ketika hdc berisi konteks perangkat metafile.
CTL_E_INVALIDPROPERTYVALUE	Parameter cx, cy, cxSrc, atau cySrc memiliki nilai nol.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	ocidl.h

Lihat juga

IPicture

Share via