Antarmuka IPicture (ocidl.h)

Mengelola objek gambar dan propertinya. Objek gambar menyediakan abstraksi netral bahasa untuk bitmap, ikon, dan metafiles. Seperti halnya objek font standar, sistem menyediakan implementasi standar objek gambar. Antarmuka utamanya adalah IPicture dan IPictureDisp, yang terakhir berasal dari IDispatch untuk menyediakan akses ke properti gambar melalui Automation. Objek gambar dibuat dengan OleCreatePictureIndirect.

Objek gambar juga mendukung antarmuka keluar IPropertyNotifySink, sehingga klien dapat menentukan kapan properti gambar berubah. Karena objek gambar mendukung setidaknya satu antarmuka keluar, objek tersebut juga mengimplementasikan IConnectionPointContainer dan antarmuka terkait untuk tujuan ini.

Objek gambar juga mendukung IPersistStream sehingga dapat menyimpan dan memuat dirinya sendiri dari instans IStream. Objek yang menggunakan objek gambar secara internal biasanya akan menyimpan dan memuat gambar sebagai bagian dari penanganan persistensi objek sendiri. Fungsi OleLoadPicture menyederhanakan pembuatan objek gambar berdasarkan konten aliran.

Warisan

Antarmuka IPicture mewarisi dari antarmuka IUnknown . IPicture juga memiliki jenis anggota ini:

Metode

Antarmuka IPicture memiliki metode ini.

IPicture::get_Attributes Mengambil set atribut bit gambar saat ini.
IPicture::get_CurDC Mengambil handel konteks perangkat saat ini. Properti ini hanya valid untuk gambar bitmap.
IPicture::get_Handle Mengambil handel ke gambar yang dikelola dalam objek gambar ini ke lokasi yang ditentukan.
IPicture::get_Height Mengambil tinggi gambar saat ini di objek gambar.
IPicture::get_hPal Mengambil salinan palet yang saat ini digunakan oleh objek gambar.
IPicture::get_KeepOriginalFormat Mengambil nilai properti KeepOriginalFormat gambar saat ini.
IPicture::get_Type Mengambil tipe gambar saat ini yang terkandung dalam objek gambar.
IPicture::get_Width Mengambil lebar gambar saat ini dalam objek gambar.
IPicture::P ictureChanged Memberi tahu objek gambar bahwa sumber daya gambarnya telah berubah. Metode ini hanya memanggil IPropertyNotifySink::OnChanged dengan DISPID_PICT_HANDLE untuk sink yang terhubung.
IPicture::p ut_KeepOriginalFormat Menetapkan nilai properti KeepOriginalFormat gambar.
IPicture::Render Merender (menggambar) bagian tertentu dari gambar yang ditentukan oleh offset (xSrc,ySrc) dari gambar sumber dan dimensi yang akan disalin (cxSrc,xySrc).
IPicture::SaveAsFile Menyimpan data gambar ke dalam aliran dalam format yang sama dengan yang akan disimpan ke dalam file. Bitmap menggunakan format file BMP, metafiles format WMF, dan ikon format ICO.
IPicture::SelectPicture Memilih gambar bitmap ke dalam konteks perangkat tertentu, dan mengembalikan konteks perangkat tempat gambar sebelumnya dipilih serta gagang GDI gambar. Metode ini bekerja bersama dengan IPicture::get_CurDC.
IPicture::set_hPal Menetapkan palet GDI ke gambar yang terkandung dalam objek gambar.

Keterangan

Setiap properti dalam antarmuka IPicture menyertakan metode get_PropertyName jika properti mendukung akses baca dan metode put_PropertyName jika properti mendukung akses tulis.

Properti	Jenis	Access	Deskripsi
Handle	OLE_HANDLE (int)	R	Gagang GDI Windows gambar
hPal	OLE_HANDLE (int)	RW	Handel Windows dari palet yang digunakan oleh gambar.
Jenis	pendek	R	Jenis gambar (lihat PICTYPE).
Lebar	OLE_XSIZE_HIMETRIC (panjang)	R	Lebar gambar.
Tinggi	OLE_YSIZE_HIMETRIC (panjang)	R	Tinggi gambar.
CurDC	HDC	R	Konteks perangkat saat ini.
KeepOriginalFormat	BOOL	RW	Jika TRUE, objek gambar mempertahankan seluruh status asli gambar dalam memori. Jika FALSE, status apa pun yang tidak berlaku untuk komputer pengguna akan dibuang.
Atribut	DWORD	R	Atribut bit lain-lain dari gambar.

 

Implementasi OLE

Objek gambar menyediakan abstraksi netral bahasa untuk bitmap, ikon, dan metafiles. Seperti halnya objek font standar, sistem menyediakan implementasi standar objek gambar. Antarmuka utamanya adalah IPicture dan IPictureDisp. Objek gambar dibuat dengan OleCreatePictureIndirect dan mendukung antarmuka IPicture dan IPictureDisp .

Objek gambar yang disediakan OLE mengimplementasikan semantik lengkap antarmuka IPicture dan IPictureDisp .

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

IPictureDisp