Fungsi OleMetafilePictFromIconAndLabel (ole2.h)

Artikel
02/29/2024

Membuat metafile tempat ikon dan label yang ditentukan digambar.

Sintaks

HGLOBAL OleMetafilePictFromIconAndLabel(
  [in] HICON    hIcon,
  [in] LPOLESTR lpszLabel,
  [in] LPOLESTR lpszSourceFile,
  [in] UINT     iIconIndex
);

Parameter

[in] hIcon

Tangani ke ikon yang akan digambar ke dalam metafile. Parameter ini bisa NULL. Jika hIcon adalah NULL, fungsi ini mengembalikan NULL tanpa membuat metafile.

[in] lpszLabel

Label ikon. Parameter ini bisa NULL. Jika lpszLabel adalah NULL, metafile yang dihasilkan tidak akan menyertakan label.

[in] lpszSourceFile

Jalur dan nama file file ikon. String ini dapat diperoleh melalui antarmuka pengguna atau dari database pendaftaran. Parameter ini bisa NULL.

[in] iIconIndex

Lokasi ikon dalam file bernama oleh lpszSourceFile, dinyatakan sebagai offset dalam byte dari awal file.

Nilai kembali

Handel global ke struktur METAFILEPICT yang berisi ikon dan label. Metafile menggunakan mode pemetaan MM_ANISOTROPIC.

Jika terjadi kesalahan, handel yang dikembalikan adalah NULL. Dalam hal ini, penelepon dapat memanggil GetLastError untuk mendapatkan informasi lebih lanjut.

Keterangan

Fungsi ini dipanggil oleh OleGetIconOfFile dan OleGetIconOfClass.

Jika lpszSourceFile bukan NULL dan iIconIndex bukan 0, nama file sumber yang diteruskan di lpszSourceFile dan indeks yang diteruskan oleh iIconIndex ditambahkan ke metafile yang dibuat sebagai rekaman komentar.

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	ole2.h
Pustaka	Ole32.lib
DLL	Ole32.dll

Lihat juga

OleGetIconOfClass

OleGetIconOfFile

Bagikan melalui