Metode IUIImageFromBitmap::CreateImage (uiribbon.h)
Membuat objek IUIImage dari gambar bitmap.
Sintaks
HRESULT CreateImage(
[in] HBITMAP bitmap,
[in] UI_OWNERSHIP options,
[out] IUIImage **image
);
Parameter
[in] bitmap
Jenis: HBITMAP
Handel ke bitmap yang berisi gambar.
[in] options
Jenis: UI_OWNERSHIP
Kondisi kepemilikan tempat gambar dibuat.
Nilai | Makna |
---|---|
UI_OWNERSHIP_TRANSFER | Jika UI_OWNERSHIP_TRANSFER ditentukan sebagai nilai opsi, kerangka kerja Pita memiliki handel ke bitmap (HBITMAP) melalui objek IUIImage dan melepaskannya saat kerangka kerja tidak lagi memerlukannya.
Catatan Opsi ini mencegah aplikasi host Pita mereferensikan HBITMAP yang sama dengan aman di tempat lain di UI aplikasi.
|
UI_OWNERSHIP_COPY | Jika UI_OWNERSHIP_COPY ditentukan sebagai nilai opsi, maka aplikasi host memiliki HBITMAP dan dapat mereferensikan HBITMAP yang sama untuk digunakan di tempat lain di UI.
Catatan Opsi ini menempatkan tanggung jawab untuk merilis HBITMAP pada aplikasi host.
|
[out] image
Jenis: IUIImage**
Ketika metode ini kembali, berisi alamat variabel pointer yang menerima objek IUIImage .
Nilai kembali
Jenis: HRESULT
Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Metode pabrik ini berguna ketika aplikasi secara dinamis menghasilkan sumber daya gambar dan ingin meneruskan HBITMAP baru ke Pita, misalnya, memuat Portable Network Graphics (PNG) melalui Komponen Pencitraan Windows (WIC) atau menggunakan CreateDIBSection untuk membuat gambar untuk gaya baru di galeri gaya.
Metode ini juga berguna untuk aplikasi yang memerlukan gambar bitmap yang sudah ada sebelumnya yang belum dirender usang oleh Pita, misalnya, strip gambar toolbar warisan.
Tentukan UI_OWNERSHIP_COPY sebagai nilai untuk opsi jika Pita sedang diimplementasikan dalam aplikasi yang sudah ada dan diperlukan perubahan kode minimal. Metode ini menggunakan memori tambahan untuk gambar tambahan.
Tentukan UI_OWNERSHIP_TRANSFER sebagai nilai opsi untuk meminimalkan penggunaan memori.
Persyaratan
Klien minimum yang didukung | Windows 7 [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2008 R2 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | uiribbon.h |
DLL | Mshtml.dll |