Kelas CPictureHolder
Menerapkan properti Gambar, yang memungkinkan pengguna menampilkan gambar di kontrol Anda.
Sintaks
class CPictureHolder
Anggota
Konstruktor Publik
| Nama | Deskripsi |
|---|---|
| CPictureHolder::CPictureHolder | Membuat CPictureHolder objek. |
Metode Publik
| Nama | Deskripsi |
|---|---|
| CPictureHolder::CreateEmpty | Membuat objek kosong CPictureHolder . |
| CPictureHolder::CreateFromBitmap | CPictureHolder Membuat objek dari bitmap. |
| CPictureHolder::CreateFromicon | CPictureHolder Membuat objek dari ikon. |
| CPictureHolder::CreateFromMetafile | CPictureHolder Membuat objek dari metafile. |
| CPictureHolder::GetDisplayString | Mengambil string yang ditampilkan di browser properti kontainer kontrol. |
| CPictureHolder::GetPictureDispatch | Mengembalikan CPictureHolder antarmuka objek IDispatch . |
| CPictureHolder::GetType | Memberi tahu apakah CPictureHolder objek adalah bitmap, metafile, atau ikon. |
| CPictureHolder::Render | Merender gambar. |
| CPictureHolder::SetPictureDispatch | CPictureHolder Mengatur antarmuka objekIDispatch. |
Anggota Data Publik
| Nama | Deskripsi |
|---|---|
| CPictureHolder::m_pPict | Penunjuk ke objek gambar. |
Keterangan
CPictureHolder tidak memiliki kelas dasar.
Dengan properti Gambar stok, pengembang dapat menentukan bitmap, ikon, atau metafile untuk ditampilkan.
Untuk informasi tentang membuat properti gambar kustom, lihat artikel Kontrol ActiveX MFC: Menggunakan Gambar dalam Kontrol ActiveX.
Hierarki Warisan
CPictureHolder
Persyaratan
Header: afxctl.h
CPictureHolder::CPictureHolder
Membuat CPictureHolder objek.
CPictureHolder();
CPictureHolder::CreateEmpty
Membuat objek kosong CPictureHolder dan menyambungkannya ke IPicture antarmuka.
BOOL CreateEmpty();
Tampilkan Nilai
Bukan nol jika objek berhasil dibuat; jika tidak, 0.
CPictureHolder::CreateFromBitmap
Menggunakan bitmap untuk menginisialisasi objek gambar dalam CPictureHolder.
BOOL CreateFromBitmap(
UINT idResource);
BOOL CreateFromBitmap(
CBitmap* pBitmap,
CPalette* pPal = NULL,
BOOL bTransferOwnership = TRUE);
BOOL CreateFromBitmap(
HBITMAP hbm,
HPALETTE hpal = NULL,
BOOL bTransferOwnership = FALSE);
Parameter
idResource
ID sumber daya sumber daya bitmap.
pBitmap
Penunjuk ke objek CBitmap .
pPal
Penunjuk ke objek CPalette .
bTransferOwnership
Menunjukkan apakah objek gambar akan mengambil kepemilikan objek bitmap dan palet.
hbm
Tangani ke bitmap tempat CPictureHolder objek dibuat.
hpal
Tangani ke palet yang digunakan untuk merender bitmap.
Tampilkan Nilai
Bukan nol jika objek berhasil dibuat; jika tidak, 0.
Keterangan
Jika bTransferOwnership TRUE, pemanggil tidak boleh menggunakan bitmap atau objek palet dengan cara apa pun setelah panggilan ini kembali. Jika bTransferOwnership FALSE, pemanggil bertanggung jawab untuk memastikan bahwa objek bitmap dan palet tetap valid selama masa pakai objek gambar.
CPictureHolder::CreateFromicon
Menggunakan ikon untuk menginisialisasi objek gambar dalam CPictureHolder.
BOOL CreateFromIcon(
UINT idResource);
BOOL CreateFromIcon(
HICON hIcon,
BOOL bTransferOwnership = FALSE);
Parameter
idResource
ID sumber daya sumber daya bitmap.
hIcon
Tangani ke ikon tempat CPictureHolder objek dibuat.
bTransferOwnership
Menunjukkan apakah objek gambar akan mengambil kepemilikan objek ikon.
Tampilkan Nilai
Bukan nol jika objek berhasil dibuat; jika tidak, 0.
Keterangan
Jika bTransferOwnership TRUE, pemanggil tidak boleh menggunakan objek ikon dengan cara apa pun setelah panggilan ini kembali. Jika bTransferOwnership FALSE, pemanggil bertanggung jawab untuk memastikan bahwa objek ikon tetap valid untuk masa pakai objek gambar.
CPictureHolder::CreateFromMetafile
Menggunakan metafile untuk menginisialisasi objek gambar dalam CPictureHolder.
BOOL CreateFromMetafile(
HMETAFILE hmf,
int xExt,
int yExt,
BOOL bTransferOwnership = FALSE);
Parameter
hmf
Tangani ke metafile yang digunakan untuk membuat CPictureHolder objek.
xExt
Tingkat X gambar.
yExt
Y luas gambar.
bTransferOwnership
Menunjukkan apakah objek gambar akan mengambil kepemilikan objek metafile.
Tampilkan Nilai
Bukan nol jika objek berhasil dibuat; jika tidak, 0.
Keterangan
Jika bTransferOwnership TRUE, pemanggil tidak boleh menggunakan objek metafile dengan cara apa pun setelah panggilan ini kembali. Jika bTransferOwnership FALSE, pemanggil bertanggung jawab untuk memastikan bahwa objek metafile tetap valid untuk masa pakai objek gambar.
CPictureHolder::GetDisplayString
Mengambil string yang ditampilkan di browser properti kontainer.
BOOL GetDisplayString(CString& strValue);
Parameter
strValue
Referensi ke CString yaitu menahan string tampilan.
Tampilkan Nilai
Bukan nol jika string berhasil diambil; jika tidak, 0.
CPictureHolder::GetPictureDispatch
Fungsi ini mengembalikan penunjuk ke CPictureHolder antarmuka objek IPictureDisp .
LPPICTUREDISP GetPictureDispatch();
Tampilkan Nilai
Penunjuk ke CPictureHolder antarmuka objek IPictureDisp .
Keterangan
Pemanggil harus memanggil Release penunjuk ini setelah selesai.
CPictureHolder::GetType
Menunjukkan apakah gambar tersebut adalah bitmap, metafile, atau ikon.
short GetType();
Tampilkan Nilai
Nilai yang menunjukkan jenis gambar. Nilai yang mungkin dan maknanya adalah sebagai berikut:
| Nilai | Makna |
|---|---|
| PICTYPE_UNINITIALIZED | CPictureHolder objek bersatuan. |
| PICTYPE_NONE | CPictureHolder objek kosong. |
| PICTYPE_BITMAP | Gambar adalah bitmap. |
| PICTYPE_METAFILE | Gambar adalah metafile. |
| PICTYPE_ICON | Gambar adalah ikon. |
CPictureHolder::m_pPict
Penunjuk ke CPictureHolder antarmuka objek IPicture .
LPPICTURE m_pPict;
CPictureHolder::Render
Merender gambar dalam persegi yang direferensikan oleh rcRender.
void Render(
CDC* pDC,
const CRect& rcRender,
const CRect& rcWBounds);
Parameter
pDC
Arahkan ke konteks tampilan tempat gambar akan dirender.
rcRender
Persegi panjang tempat gambar akan dirender.
rcWBounds
Persegi panjang yang mewakili persegi panjang pembatas objek yang merender gambar. Untuk kontrol, persegi panjang ini adalah parameter rcBounds yang diteruskan ke penimpaan COleControl::OnDraw.
CPictureHolder::SetPictureDispatch
Menyambungkan CPictureHolder objek ke IPictureDisp antarmuka.
void SetPictureDispatch(LPPICTUREDISP pDisp);
Parameter
pDisp
Arahkan ke antarmuka baru IPictureDisp .