Kelas CPictureHolder

Nota

Pustaka Microsoft Foundation Classes (MFC) terus didukung. Namun, kami tidak lagi menambahkan fitur atau memperbarui dokumentasi.

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 .

Lihat juga

Bagan Hierarki
Kelas CFontHolder