Kelas COccManager

Mengelola berbagai situs kontrol kustom; diimplementasikan oleh COleControlContainer objek dan COleControlSite .

Sintaks

class COccManager : public CNoTrackObject

Anggota

Metode Publik

Keterangan

Kelas dasar, CNoTrackObject, adalah kelas dasar yang tidak terdokumentasi (terletak di AFXTLS. H). Dirancang untuk digunakan oleh kerangka kerja MFC, kelas yang berasal dari kelas dikecualikan dari deteksi kebocoran CNoTrackObject memori. Tidak disarankan agar Anda mendapatkan langsung dari CNoTrackObject.

Hierarki Warisan

CNoTrackObject

COccManager

Persyaratan

Header: afxocc.h

COccManager::CreateContainer

Dipanggil oleh kerangka kerja untuk membuat kontainer kontrol.

virtual COleControlContainer* CreateContainer(CWnd* pWnd);

Parameter

pWnd
Penunjuk ke objek jendela yang terkait dengan kontainer situs kustom.

Tampilkan Nilai

Penunjuk ke kontainer yang baru dibuat; jika tidak, NULL.

Keterangan

Untuk informasi selengkapnya tentang membuat situs kustom, lihat COleControlContainer::AttachControlSite.

COccManager::CreateDlgControls

Panggil fungsi ini untuk membuat kontrol ActiveX yang ditentukan oleh parameter pOccDialogInfo .

virtual BOOL CreateDlgControls(
    CWnd* pWndParent,
    LPCTSTR lpszResourceName,
    _AFX_OCC_DIALOG_INFO* pOccDialogInfo);

virtual BOOL CreateDlgControls(
    CWnd* pWndParent,
    void* lpResource,
    _AFX_OCC_DIALOG_INFO* pOccDialogInfo);

Parameter

pWndParent
Penunjuk ke induk objek dialog.

lpszResourceName
Nama sumber daya yang sedang dibuat.

pOccDialogInfo
Penunjuk ke templat dialog yang digunakan untuk membuat objek dialog.

lpResource
Penunjuk ke sumber daya.

Tampilkan Nilai

Bukan nol jika kontrol berhasil dibuat; jika tidak, nol.

COccManager::CreateSite

Dipanggil oleh kerangka kerja untuk membuat situs kontrol, yang dihosting oleh kontainer yang ditunjuk oleh pCtrlCont.

virtual COleControlSite* CreateSite(COleControlContainer* pCtrlCont);

Parameter

pCtrlCont
Penunjuk ke kontainer kontrol yang menghosting situs kontrol baru.

Tampilkan Nilai

Penunjuk ke situs kontrol yang baru dibuat.

Keterangan

Ambil alih fungsi ini untuk membuat situs kontrol kustom, menggunakan kelas turunan COleControlSite Anda.

Setiap kontainer kontrol dapat menghosting beberapa situs. Buat situs tambahan dengan beberapa panggilan ke CreateSite.

COccManager::GetDefBtnCode

Panggil fungsi ini untuk menentukan apakah kontrol adalah tombol tekan default.

static DWORD AFX_CDECL GetDefBtnCode(CWnd* pWnd);

Parameter

pWnd
Objek jendela yang berisi kontrol tombol.

Tampilkan Nilai

Salah satu dari nilai berikut:

• DLGC_DEFPUSHBUTTON Control adalah tombol default dalam dialog.

• DLGC_UNDEFPUSHBUTTON Control bukan tombol default dalam dialog.

• 0 Kontrol bukan tombol.

COccManager::IsDialogMessage

Dipanggil oleh kerangka kerja untuk menentukan apakah pesan ditujukan untuk kotak dialog yang ditentukan dan, jika ya, memproses pesan.

virtual BOOL IsDialogMessage(
    CWnd* pWndDlg,
    LPMSG lpMsg);

Parameter

pWndDlg
Penunjuk ke dialog target pesan yang dimaksudkan.

lpMsg
Penunjuk ke MSG struktur yang berisi pesan yang akan diperiksa.

Tampilkan Nilai

Bukan nol jika pesan diproses; jika tidak, nol.

Keterangan

Perilaku IsDialogMessage default adalah memeriksa pesan keyboard dan mengonversinya menjadi pilihan untuk kotak dialog yang sesuai. Misalnya, tombol TAB, saat ditekan, memilih kontrol atau grup kontrol berikutnya.

Ambil alih fungsi ini untuk memberikan perilaku kustom untuk pesan yang dikirim ke dialog yang ditentukan.

COccManager::IsLabelControl

Panggil fungsi ini untuk menentukan apakah kontrol yang ditentukan adalah kontrol label.

static BOOL AFX_CDECL IsLabelControl(CWnd* pWnd);
static BOOL AFX_CDECL IsLabelControl(COleControlSiteOrWnd* pWnd);

Parameter

pWnd
Penunjuk ke jendela yang berisi kontrol.

Tampilkan Nilai

Bukan nol jika kontrol adalah label; jika tidak, nol

Keterangan

Kontrol label adalah kontrol yang bertindak seperti label untuk kontrol apa pun selanjutnya dalam urutan.

COccManager::IsMatchingMnemonic

Panggil fungsi ini untuk menentukan apakah mnemonic saat ini cocok dengan yang diwakili oleh kontrol.

static BOOL AFX_CDECL IsMatchingMnemonic(
    CWnd* pWnd,
    LPMSG lpMsg);

static BOOL AFX_CDECL IsMatchingMnemonic(
    COleControlSiteOrWnd* pWnd,
    LPMSG lpMsg);

Parameter

pWnd
Penunjuk ke jendela yang berisi kontrol.

lpMsg
Pointer ke pesan yang berisi mnemonic untuk dicocokkan.

Tampilkan Nilai

Nonzero jika mnemonic cocok dengan kontrol; jika tidak, nol

Keterangan

COccManager::OnEvent

Dipanggil oleh kerangka kerja untuk menangani peristiwa yang ditentukan.

virtual BOOL OnEvent(
    CCmdTarget* pCmdTarget,
    UINT idCtrl,
    AFX_EVENT* pEvent,
    AFX_CMDHANDLERINFO* pHandlerInfo);

Parameter

pCmdTarget
Penunjuk ke objek yang CCmdTarget mencoba menangani peristiwa

idCtrl
ID sumber daya kontrol.

pEvent
Peristiwa yang sedang ditangani.

pHandlerInfo
Jika bukan NULL, OnEvent mengisi pTarget anggota AFX_CMDHANDLERINFO struktur dan pmf alih-alih mengirimkan perintah. Biasanya, parameter ini harus NULL.

Tampilkan Nilai

Bukan nol jika peristiwa ditangani, jika tidak, nol.

Keterangan

Ambil alih fungsi ini untuk menyesuaikan proses penanganan peristiwa default.

COccManager::P reCreateDialog

Dipanggil oleh kerangka kerja untuk memproses templat dialog untuk kontrol ActiveX sebelum membuat kotak dialog aktual.

virtual const DLGTEMPLATE* PreCreateDialog(
    _AFX_OCC_DIALOG_INFO* pOccDialogInfo,
    const DLGTEMPLATE* pOrigTemplate);

Parameter

pOccDialogInfo
Struktur _AFX_OCC_DIALOG_INFO yang berisi informasi tentang templat dialog dan kontrol ActiveX apa pun yang dihosting oleh dialog.

pOrigTemplate
Penunjuk ke templat dialog yang akan digunakan dalam membuat kotak dialog.

Tampilkan Nilai

Penunjuk ke struktur templat dialog yang digunakan untuk membuat kotak dialog.

Keterangan

Perilaku default melakukan panggilan ke SplitDialogTemplate, menentukan apakah ada kontrol ActiveX yang ada lalu mengembalikan templat dialog yang dihasilkan.

Ambil alih fungsi ini untuk menyesuaikan proses pembuatan kotak dialog yang menghosting kontrol ActiveX.

COccManager::P ostCreateDialog

Dipanggil oleh kerangka kerja untuk mengosongkan memori yang dialokasikan untuk templat dialog.

virtual void PostCreateDialog(_AFX_OCC_DIALOG_INFO* pOccDialogInfo);

Parameter

pOccDialogInfo
Struktur _AFX_OCC_DIALOG_INFO yang berisi informasi tentang templat dialog dan kontrol ActiveX apa pun yang dihosting oleh dialog.

Keterangan

Memori ini dialokasikan oleh panggilan ke SplitDialogTemplate, dan digunakan untuk kontrol ActiveX yang dihosting dalam kotak dialog.

Ambil alih fungsi ini untuk menyesuaikan proses pembersihan sumber daya apa pun yang digunakan oleh objek kotak dialog.

COccManager::SetDefaultButton

Panggil fungsi ini untuk mengatur kontrol sebagai tombol default.

static void AFX_CDECL SetDefaultButton(
    CWnd* pWnd,
    BOOL bDefault);

Parameter

pWnd
Penunjuk ke jendela yang berisi kontrol.

bDefault
Bukan nol jika kontrol harus menjadi tombol default; jika tidak, nol.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

COccManager::SplitDialogTemplate

Dipanggil oleh kerangka kerja untuk membagi kontrol ActiveX dari kontrol dialog umum.

virtual DLGTEMPLATE* SplitDialogTemplate(
    const DLGTEMPLATE* pTemplate,
    DLGITEMTEMPLATE** ppOleDlgItems);

Parameter

pTemplate
Penunjuk ke templat dialog yang akan diperiksa.

ppOleDlgItems
Daftar pointer ke item kotak dialog yang merupakan kontrol ActiveX.

Tampilkan Nilai

Penunjuk ke struktur templat dialog yang hanya berisi kontrol non-ActiveX. Jika tidak ada kontrol ActiveX, NULL dikembalikan.

Keterangan

Jika ada kontrol ActiveX yang ditemukan, templat dianalisis dan templat baru, hanya berisi kontrol non-ActiveX, yang dibuat. Kontrol ActiveX apa pun yang ditemukan selama proses ini ditambahkan ke ppOleDlgItems.

Jika tidak ada kontrol ActiveX dalam templat, NULL dikembalikan .

Ambil alih fungsi ini untuk menyesuaikan proses ini.

Lihat juga

Bagan Hierarki
Kelas COleControlSite
Kelas COleControlContainer