Fungsi OleLoadPictureEx (olectl.h)

Artikel
03/04/2024

Membuat objek gambar baru dan menginisialisasinya dari konten aliran. Ini setara dengan memanggil OleCreatePictureIndirect dengan NULL sebagai parameter pertama, diikuti dengan panggilan ke IPersistStream::Load.

Sintaks

WINOLECTLAPI OleLoadPictureEx(
  [in]  LPSTREAM lpstream,
  [in]  LONG     lSize,
  [in]  BOOL     fRunmode,
  [in]  REFIID   riid,
  [in]  DWORD    xSizeDesired,
  [in]  DWORD    ySizeDesired,
  [in]  DWORD    dwFlags,
  [out] LPVOID   *lplpvObj
);

Parameter

[in] lpstream

Arahkan ke aliran yang berisi data gambar.

[in] lSize

Jumlah byte yang harus dibaca dari aliran, atau nol jika seluruh aliran harus dibaca.

[in] fRunmode

Kebalikan dari nilai awal properti KeepOriginalFormat . Jika TRUE, KeepOriginalFormat diatur ke FALSE dan sebaliknya.

[in] riid

Referensi ke pengidentifikasi antarmuka yang menjelaskan jenis penunjuk antarmuka untuk kembali dalam ppvObj.

[in] xSizeDesired

Lebar ikon atau kursor yang diinginkan. Nilai yang valid adalah 16, 32, dan 48. Teruskan LP_DEFAULT ke kedua parameter ukuran untuk menggunakan ukuran default sistem.

[in] ySizeDesired

Tinggi ikon atau kursor yang diinginkan. Nilai yang valid adalah 16, 32, dan 48. Teruskan LP_DEFAULT ke kedua parameter ukuran untuk menggunakan ukuran default sistem.

[in] dwFlags

Kedalaman warna yang diinginkan untuk ikon atau kursor. Nilainya adalah LP_MONOCHROME (monokrom), LP_VGACOLOR (16 warna), LP_COLOR (256 warna), atau LP_DEFAULT (memilih kedalaman terbaik untuk tampilan saat ini).

[out] lplpvObj

Alamat variabel pointer yang menerima pointer antarmuka yang diminta dalam riid. Setelah berhasil dikembalikan, *ppvObj berisi penunjuk antarmuka yang diminta pada penyimpanan objek yang diidentifikasi oleh moniker. Jika *ppvObjnon-NULL, fungsi ini memanggil IUnknown::AddRef pada antarmuka; adalah tanggung jawab penelepon untuk memanggil IUnknown::Release. Jika terjadi kesalahan, *ppvObj diatur ke NULL.

Nilai kembali

Fungsi ini mengembalikan S_OK pada keberhasilan. Nilai lain yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
E_NOINTERFACE	Objek tidak mendukung antarmuka yang ditentukan dalam riid.
E_POINTER	Alamat dalam pPictDesc atau ppvObj tidak valid. Misalnya, mungkin NULL.

Keterangan

Aliran harus dalam format BMP (bitmap), WMF (metafile), atau ICO (ikon). Objek gambar yang dibuat menggunakan OleLoadPictureEx selalu memiliki kepemilikan atas sumber daya internalnya (fOwn==TRUE tersirat).

Selain memungkinkan spesifikasi ikon atau ukuran kursor, OleLoadPictureEx mendukung pemuatan kursor warna.

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	olectl.h
Pustaka	OleAut32.lib
DLL	OleAut32.dll

Lihat juga

OleCreatePictureIndirect

PICTDESC

Bagikan melalui