Bagikan melalui

Metode IUIImageFromBitmap::CreateImage (uiribbon.h)

  • Artikel

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

Lihat juga

IUIImageFromBitmap

Sampel Windows Ribbon Framework