Bagikan melalui

Kelas COleControlSite

  • Artikel

Menyediakan dukungan untuk antarmuka kontrol sisi klien kustom.

Sintaks

class COleControlSite : public CCmdTarget

Anggota

Konstruktor Publik

Nama Deskripsi
COleControlSite::COleControlSite Membuat COleControlSite objek.

Metode Publik

Nama Deskripsi
COleControlSite::BindDefaultProperty Mengikat properti default kontrol yang dihosting ke sumber data.
COleControlSite::BindProperty Mengikat properti kontrol yang dihosting ke sumber data.
COleControlSite::CreateControl Membuat kontrol ActiveX yang dihosting.
COleControlSite::D estroyControl Menghancurkan kontrol yang dihosting.
COleControlSite::D oVerb Menjalankan kata kerja tertentu dari kontrol yang dihosting.
COleControlSite::EnableDSC Mengaktifkan sumber data untuk situs kontrol.
COleControlSite::EnableWindow Mengaktifkan situs kontrol.
COleControlSite::FreezeEvents Menentukan apakah situs kontrol menerima peristiwa.
COleControlSite::GetDefBtnCode Mengambil kode tombol default untuk kontrol yang dihosting.
COleControlSite::GetDlgCtrlID Mengambil pengidentifikasi kontrol.
COleControlSite::GetEventIID Mengambil ID antarmuka peristiwa untuk kontrol yang dihosting.
COleControlSite::GetExStyle Mengambil gaya yang diperluas dari situs kontrol.
COleControlSite::GetProperty Mengambil properti tertentu dari kontrol yang dihosting.
COleControlSite::GetStyle Mengambil gaya situs kontrol.
COleControlSite::GetWindowText Mengambil teks kontrol yang dihosting.
COleControlSite::InvokeHelper Panggil metode tertentu dari kontrol yang dihosting.
COleControlSite::InvokeHelperV Panggil metode tertentu dari kontrol yang dihosting dengan daftar variabel argumen.
COleControlSite::IsDefaultButton Menentukan apakah kontrol adalah tombol default di jendela.
COleControlSite::IsWindowEnabled Memeriksa status situs kontrol yang terlihat.
COleControlSite::ModifikasiStyle Memodifikasi gaya situs kontrol yang diperluas saat ini.
COleControlSite::ModifikasiStyleEx Memodifikasi gaya situs kontrol saat ini.
COleControlSite::MoveWindow Mengubah posisi situs kontrol.
COleControlSite::QuickActivate Mengaktifkan kontrol yang dihosting dengan cepat.
COleControlSite::SafeSetProperty Mengatur properti atau metode kontrol tanpa kemungkinan melemparkan pengecualian.
COleControlSite::SetDefaultButton Mengatur tombol default di jendela.
COleControlSite::SetDlgCtrlID Mengambil pengidentifikasi kontrol.
COleControlSite::SetFocus Mengatur fokus ke situs kontrol.
COleControlSite::SetProperty Mengatur properti tertentu dari kontrol yang dihosting.
COleControlSite::SetPropertyV Mengatur properti tertentu dari kontrol yang dihosting dengan daftar variabel argumen.
COleControlSite::SetWindowPos Mengatur posisi situs kontrol.
COleControlSite::SetWindowText Mengatur teks kontrol yang dihosting.
COleControlSite::ShowWindow Memperlihatkan atau menyembunyikan situs kontrol.

Metode yang Dilindungi

Nama Deskripsi
COleControlSite::GetControlInfo Mengambil informasi keyboard dan mnemonics untuk kontrol yang dihosting.

Anggota Data Publik

Nama Deskripsi
COleControlSite::m_bIsWindowless Menentukan apakah kontrol yang dihosting adalah kontrol tanpa jendela.
COleControlSite::m_ctlInfo Berisi informasi tentang penanganan papan tombol untuk kontrol.
COleControlSite::m_dwEventSink Cookie titik koneksi kontrol.
COleControlSite::m_dwMiscStatus Status lain-lain untuk kontrol yang dihosting.
COleControlSite::m_dwPropNotifySink Cookie IPropertyNotifySink kontrol.
COleControlSite::m_dwStyle Gaya kontrol yang dihosting.
COleControlSite::m_hWnd Handel situs kontrol.
COleControlSite::m_iidEvents ID antarmuka peristiwa untuk kontrol yang dihosting.
COleControlSite::m_nID ID kontrol yang dihosting.
COleControlSite::m_pActiveObject Penunjuk ke IOleInPlaceActiveObject objek kontrol yang dihosting.
COleControlSite::m_pCtrlCont Kontainer kontrol yang dihosting.
COleControlSite::m_pInPlaceObject Penunjuk ke IOleInPlaceObject objek kontrol yang dihosting.
COleControlSite::m_pObject Penunjuk ke IOleObjectInterface antarmuka kontrol.
COleControlSite::m_pWindowlessObject Penunjuk ke IOleInPlaceObjectWindowless antarmuka kontrol.
COleControlSite::m_pWndCtrl Penunjuk ke objek jendela untuk kontrol yang dihosting.
COleControlSite::m_rect Dimensi situs kontrol.

Keterangan

Dukungan ini adalah sarana utama di mana kontrol ActiveX tertanam mendapatkan informasi tentang lokasi dan sejauh mana situs tampilannya, monikernya, antarmuka penggunanya, properti sekitarnya, dan sumber daya lain yang disediakan oleh kontainernya. COleControlSite sepenuhnya mengimplementasikan antarmuka IOleControlSite, IOleInPlaceSite, IOleClientSite, IPropertyNotifySink, IBoundObjectSite, INotifyDBEvents, IRowSetNotify . Selain itu, antarmuka IDispatch (memberikan dukungan untuk properti sekitar dan sink peristiwa) juga diimplementasikan.

Untuk membuat situs kontrol ActiveX menggunakan COleControlSite, dapatkan kelas dari COleControlSite. Di kelas -turunan Anda CWnduntuk kontainer (misalnya, kotak dialog Anda) mengambil alih CWnd::CreateControlSite fungsi.

Hierarki Warisan

CObject

CCmdTarget

COleControlSite

Persyaratan

Header: afxocc.h

COleControlSite::BindDefaultProperty

Mengikat properti terikat sederhana default objek panggilan, seperti yang ditandai dalam pustaka jenis, ke kursor dasar yang ditentukan oleh properti DataSource, UserName, Password, dan SQL dari kontrol sumber data.

virtual void BindDefaultProperty(
    DISPID dwDispID,
    VARTYPE vtProp,
    LPCTSTR szFieldName,
    CWnd* pDSCWnd);

Parameter

dwDispID
Menentukan DISPID properti pada kontrol terikat data yang akan terikat ke kontrol sumber data.

vtProp
Menentukan jenis properti yang akan diikat — misalnya, VT_BSTR, VT_VARIANT, dan sebagainya.

szFieldName
Menentukan nama kolom, dalam kursor yang disediakan oleh kontrol sumber data, tempat properti akan terikat.

pDSCWnd
Penunjuk ke CWndobjek -turunan yang menghosting kontrol sumber data tempat properti akan terikat.

Keterangan

Objek CWnd tempat Anda memanggil fungsi ini harus merupakan kontrol terikat data.

COleControlSite::BindProperty

Mengikat properti terikat sederhana objek panggilan, seperti yang ditandai dalam pustaka jenis, ke kursor dasar yang ditentukan oleh properti DataSource, UserName, Password, dan SQL dari kontrol sumber data.

virtual void BindProperty(
    DISPID dwDispId,
    CWnd* pWndDSC);

Parameter

dwDispId
Menentukan DISPID properti pada kontrol terikat data yang akan terikat ke kontrol sumber data.

pWndDSC
Penunjuk ke CWndobjek -turunan yang menghosting kontrol sumber data tempat properti akan terikat.

Keterangan

Objek CWnd tempat Anda memanggil fungsi ini harus merupakan kontrol terikat data.

COleControlSite::COleControlSite

Membuat objek baru COleControlSite .

explicit COleControlSite(COleControlContainer* pCtrlCont);

Parameter

pCtrlCont
Penunjuk ke kontainer kontrol (yang mewakili jendela yang menghosting kontrol AtiveX).

Keterangan

Fungsi ini dipanggil oleh fungsi COccManager::CreateContainer . Untuk informasi selengkapnya tentang menyesuaikan pembuatan kontainer, lihat COccManager::CreateSite.

COleControlSite::CreateControl

Membuat kontrol ActiveX, yang dihosting COleControlSite oleh objek.

virtual HRESULT CreateControl(
    CWnd* pWndCtrl,
    REFCLSID clsid,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    UINT nID,
    CFile* pPersist = NULL,
    BOOL bStorage = FALSE,
    BSTR bstrLicKey = NULL);

virtual HRESULT CreateControl(
    CWnd* pWndCtrl,
    REFCLSID clsid,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const POINT* ppt,
    const SIZE* psize,
    UINT nID,
    CFile* pPersist = NULL,
    BOOL bStorage = FALSE,
    BSTR bstrLicKey = NULL);

Parameter

pWndCtrl
Penunjuk ke objek jendela yang mewakili kontrol.

clsid
ID kelas unik kontrol.

lpszWindowName
Penunjuk ke teks yang akan ditampilkan dalam kontrol. Mengatur nilai properti Keterangan atau Teks winodw (jika ada).

dwStyle
Gaya Windows. Gaya yang tersedia tercantum di bawah bagian Keterangan .

rect
Menentukan ukuran dan posisi kontrol. Ini bisa berupa CRect objek atau RECT struktur.

Nid
Menentukan ID jendela anak kontrol.

pPersist
Penunjuk ke yang CFile berisi status persisten untuk kontrol. Nilai defaultnya adalah NULL, menunjukkan bahwa kontrol menginisialisasi dirinya sendiri tanpa memulihkan statusnya dari penyimpanan persisten apa pun. Jika bukan NULL, itu harus menjadi penunjuk ke CFileobjek -turunan yang berisi data persisten kontrol, dalam bentuk aliran atau penyimpanan. Data ini bisa saja disimpan dalam aktivasi klien sebelumnya. CFile dapat berisi data lain, tetapi harus memiliki penunjuk baca-tulis yang diatur ke byte pertama data persisten pada saat panggilan ke CreateControl.

bStorage
Menunjukkan apakah data dalam pPersist harus ditafsirkan sebagai IStorage atau IStream data. Jika data dalam pPersist adalah penyimpanan, bStorage harus TRUE. Jika data dalam pPersist adalah aliran, bStorage harus FALSE. Nilai defaultnya adalah FALSE.

bstrLicKey
Data kunci lisensi opsional. Data ini hanya diperlukan untuk membuat kontrol yang memerlukan kunci lisensi run-time. Jika kontrol mendukung lisensi, Anda harus menyediakan kunci lisensi agar pembuatan kontrol berhasil. Nilai defaultnya adalah NULL.

Ppt
Penunjuk ke POINT struktur yang berisi sudut kiri atas kontrol. Ukuran kontrol ditentukan oleh nilai psize. Nilai ppt dan psize adalah metode opsional untuk menentukan ukuran dan posisi opf kontrol.

psize
Penunjuk ke SIZE struktur yang berisi ukuran kontrol. Sudut kiri atas ditentukan oleh nilai ppt. Nilai ppt dan psize adalah metode opsional untuk menentukan ukuran dan posisi opf kontrol.

Tampilkan Nilai

Nilai HRESULT standar.

Keterangan

Hanya subset bendera Windows dwStyle yang didukung oleh CreateControl:

  • WS_VISIBLE Membuat jendela yang awalnya terlihat. Diperlukan jika Anda ingin kontrol terlihat segera, seperti jendela biasa.

  • WS_DISABLED Membuat jendela yang awalnya dinonaktifkan. Jendela yang dinonaktifkan tidak dapat menerima input dari pengguna. Dapat diatur jika kontrol memiliki properti Diaktifkan.

  • WS_BORDER Membuat jendela dengan batas garis tipis. Dapat diatur jika kontrol memiliki properti BorderStyle.

  • WS_GROUP Menentukan kontrol pertama dari sekelompok kontrol. Pengguna dapat mengubah fokus keyboard dari satu kontrol dalam grup ke kontrol berikutnya dengan menggunakan tombol arah. Semua kontrol yang ditentukan dengan gaya WS_GROUP setelah kontrol pertama milik grup yang sama. Kontrol berikutnya dengan gaya WS_GROUP mengakhiri grup dan memulai grup berikutnya.

  • WS_TABSTOP Menentukan kontrol yang dapat menerima fokus keyboard saat pengguna menekan tombol TAB. Menekan tombol TAB mengubah fokus keyboard ke kontrol gaya WS_TABSTOP berikutnya.

Gunakan kelebihan beban kedua untuk membuat kontrol berukuran default.

COleControlSite::D estroyControl

COleControlSite Menghancurkan objek.

virtual BOOL DestroyControl();

Tampilkan Nilai

Bukan nol jika berhasil, jika tidak, 0.

Keterangan

Setelah selesai, objek dibesarkan dari memori dan pointer apa pun ke objek tidak lagi valid.

COleControlSite::D oVerb

Menjalankan kata kerja yang ditentukan.

virtual HRESULT DoVerb(
    LONG nVerb,
    LPMSG lpMsg = NULL);

Parameter

nVerb
Menentukan kata kerja yang akan dijalankan. Ini dapat mencakup salah satu hal berikut:

Nilai Makna Simbol
0 Kata kerja utama OLEIVERB_PRIMARY
-1 Kata kerja sekunder (Tidak Ada)
1 Menampilkan objek untuk pengeditan. OLEIVERB_SHOW
-2 Mengedit item di jendela terpisah. OLEIVERB_OPEN
-3 Menyembunyikan objek. OLEIVERB_HIDE
4- Mengaktifkan kontrol di tempat. OLEIVERB_UIACTIVATE
5- Mengaktifkan kontrol di tempat, tanpa elemen antarmuka pengguna tambahan. OLEIVERB_INPLACEACTIVATE
7- Tampilkan properti kontrol. OLEIVERB_PROPERTIES

lpMsg
Penunjuk ke pesan yang menyebabkan item diaktifkan.

Tampilkan Nilai

Nilai HRESULT standar.

Keterangan

Fungsi ini langsung memanggil melalui antarmuka kontrol IOleObject untuk menjalankan kata kerja yang ditentukan. Jika pengecualian dilemparkan sebagai akibat dari panggilan fungsi ini, kode kesalahan HRESULT dikembalikan.

Untuk informasi selengkapnya, lihat IOleObject::D oVerb di Windows SDK.

COleControlSite::EnableDSC

Mengaktifkan sumber data untuk situs kontrol.

virtual void EnableDSC();

Keterangan

Dipanggil oleh kerangka kerja untuk mengaktifkan dan menginisialisasi sumber data untuk situs kontrol. Ambil alih fungsi ini untuk menyediakan perilaku yang disesuaikan.

COleControlSite::EnableWindow

Mengaktifkan atau menonaktifkan input mouse dan keyboard ke situs kontrol.

virtual BOOL EnableWindow(BOOL bEnable);

Parameter

bEnable
Menentukan apakah akan mengaktifkan atau menonaktifkan jendela: TRUE jika input jendela akan diaktifkan, jika tidak, FALSE.

Tampilkan Nilai

Bukan nol jika jendela sebelumnya dinonaktifkan, jika tidak, 0.

COleControlSite::FreezeEvents

Menentukan apakah situs kontrol akan menangani atau mengabaikan peristiwa yang diaktifkan dari kontrol.

void FreezeEvents(BOOL bFreeze);

Parameter

bFreeze
Menentukan apakah situs kontrol ingin berhenti menerima peristiwa. Bukan nol jika kontrol tidak menerima peristiwa; jika tidak, nol.

Keterangan

Jika bFreeze TRUE, situs kontrol meminta kontrol untuk berhenti menembakkan peristiwa. Jika bFreeze FALSE, situs kontrol meminta kontrol untuk terus menembakkan peristiwa.

Catatan

Kontrol tidak diperlukan untuk berhenti menembakkan peristiwa jika diminta oleh situs kontrol. Ini dapat terus menembak tetapi semua peristiwa berikutnya akan diabaikan oleh situs kontrol.

COleControlSite::GetControlInfo

Mengambil informasi tentang mnemonik keyboard kontrol dan perilaku keyboard.

void GetControlInfo();

Keterangan

Informasi disimpan di COleControlSite::m_ctlInfo.

COleControlSite::GetDefBtnCode

Menentukan apakah kontrol adalah tombol dorong default.

DWORD GetDefBtnCode();

Tampilkan Nilai

Dapat berupa 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.

COleControlSite::GetDlgCtrlID

Mengambil pengidentifikasi kontrol.

virtual int GetDlgCtrlID() const;

Tampilkan Nilai

Pengidentifikasi item dialog kontrol.

COleControlSite::GetEventIID

Mengambil penunjuk ke antarmuka peristiwa default kontrol.

BOOL GetEventIID(IID* piid);

Parameter

piid
Penunjuk ke ID antarmuka.

Tampilkan Nilai

Bukan nol jika berhasil, jika tidak, 0. Jika berhasil, piid berisi ID antarmuka untuk antarmuka peristiwa default kontrol.

COleControlSite::GetExStyle

Mengambil gaya jendela yang diperluas.

virtual DWORD GetExStyle() const;

Tampilkan Nilai

Gaya yang diperluas jendela kontrol.

Keterangan

Untuk mengambil gaya reguler, panggil COleControlSite::GetStyle.

COleControlSite::GetProperty

Mendapatkan properti kontrol yang ditentukan oleh dwDispID.

virtual void GetProperty(
    DISPID dwDispID,
    VARTYPE vtProp,
    void* pvProp) const;

Parameter

dwDispID
Mengidentifikasi ID pengiriman properti, yang ditemukan pada antarmuka default IDispatch kontrol, untuk diambil.

vtProp
Menentukan tipe properti yang akan diambil. Untuk nilai yang mungkin, lihat bagian Keterangan untuk COleDispatchDriver::InvokeHelper.

pvProp
Alamat variabel yang akan menerima nilai properti. Ini harus cocok dengan jenis yang ditentukan oleh vtProp.

Keterangan

Nilai dikembalikan melalui pvProp.

COleControlSite::GetStyle

Mengambil gaya situs kontrol.

virtual DWORD GetStyle() const;

Tampilkan Nilai

Gaya jendela.

Keterangan

Untuk daftar nilai yang mungkin, lihat Gaya Windows. Untuk mengambil gaya yang diperluas dari situs kontrol, panggil COleControlSite::GetExStyle.

COleControlSite::GetWindowText

Mengambil teks kontrol saat ini.

virtual void GetWindowText(CString& str) const;

Parameter

Str
Referensi ke CString objek yang berisi teks kontrol saat ini.

Keterangan

Jika kontrol mendukung properti stok Keterangan, nilai ini dikembalikan. Jika properti Stok Keterangan tidak didukung, nilai untuk properti Teks dikembalikan.

COleControlSite::InvokeHelper

Memanggil metode atau properti yang ditentukan oleh dwDispID, dalam konteks yang ditentukan oleh wFlags.

virtual void AFX_CDECL InvokeHelper(
    DISPID dwDispID,
    WORD wFlags,
    VARTYPE vtRet,
    void* pvRet,
    const BYTE* pbParamInfo, ...);

Parameter

dwDispID
Mengidentifikasi ID pengiriman properti atau metode, yang ditemukan pada antarmuka kontrol IDispatch , untuk dipanggil.

wFlags
Bendera yang menjelaskan konteks panggilan ke IDispatch::Invoke. Untuk kemungkinan nilai wFlags , lihat IDispatch::Invoke di Windows SDK.

vtRet
Menentukan jenis nilai yang dikembalikan. Untuk nilai yang mungkin, lihat bagian Keterangan untuk COleDispatchDriver::InvokeHelper.

pvRet
Alamat variabel yang akan menerima nilai properti atau mengembalikan nilai. Ini harus cocok dengan jenis yang ditentukan oleh vtRet.

pbParamInfo
Penunjuk ke string byte yang dihentikan null yang menentukan jenis parameter berikut pbParamInfo. Untuk nilai yang mungkin, lihat bagian Keterangan untuk COleDispatchDriver::InvokeHelper.

...
Daftar variabel parameter, jenis yang ditentukan dalam pbParamInfo.

Keterangan

Parameter pbParamInfo menentukan jenis parameter yang diteruskan ke metode atau properti . Daftar variabel argumen diwakili oleh ... dalam deklarasi sintaksis.

Fungsi ini mengonversi parameter menjadi nilai VARIANTARG, lalu memanggil IDispatch::Invoke metode pada kontrol. Jika panggilan gagal IDispatch::Invoke , fungsi ini akan melemparkan pengecualian. Jika kode status yang dikembalikan oleh IDispatch::Invoke adalah DISP_E_EXCEPTION, fungsi ini melempar COleDispatchException objek, jika tidak, kode status akan melemparkan COleException.

COleControlSite::InvokeHelperV

Memanggil metode atau properti yang ditentukan oleh dwDispID, dalam konteks yang ditentukan oleh wFlags.

virtual void InvokeHelperV(
    DISPID dwDispID,
    WORD wFlags,
    VARTYPE vtRet,
    void* pvRet,
    const BYTE* pbParamInfo,
    va_list argList);

Parameter

dwDispID
Mengidentifikasi ID pengiriman properti atau metode, yang ditemukan pada antarmuka kontrol IDispatch , untuk dipanggil.

wFlags
Bendera yang menjelaskan konteks panggilan ke IDispatch::Invoke.

vtRet
Menentukan jenis nilai yang dikembalikan. Untuk nilai yang mungkin, lihat bagian Keterangan untuk COleDispatchDriver::InvokeHelper.

pvRet
Alamat variabel yang akan menerima nilai properti atau mengembalikan nilai. Ini harus cocok dengan jenis yang ditentukan oleh vtRet.

pbParamInfo
Penunjuk ke string byte yang dihentikan null yang menentukan jenis parameter berikut pbParamInfo. Untuk nilai yang mungkin, lihat bagian Keterangan untuk COleDispatchDriver::InvokeHelper.

argList
Penunjuk ke daftar argumen variabel.

Keterangan

Parameter pbParamInfo menentukan jenis parameter yang diteruskan ke metode atau properti . Parameter tambahan untuk metode atau properti yang dipanggil dapat diteruskan menggunakan parameter va_list .

Biasanya, fungsi ini dipanggil oleh COleControlSite::InvokeHelper.

COleControlSite::IsDefaultButton

Menentukan apakah kontrol adalah tombol default.

BOOL IsDefaultButton();

Tampilkan Nilai

Bukan nol jika kontrol adalah tombol default pada jendela, jika tidak, nol.

COleControlSite::IsWindowEnabled

Menentukan apakah situs kontrol diaktifkan.

virtual BOOL IsWindowEnabled() const;

Tampilkan Nilai

Bukan nol jika kontrol diaktifkan, jika tidak, nol.

Keterangan

Nilai diambil dari properti stok diaktifkan kontrol.

COleControlSite::m_bIsWindowless

Menentukan apakah objek adalah kontrol tanpa jendela.

BOOL m_bIsWindowless;

Keterangan

Bukan nol jika kontrol tidak memiliki jendela, jika tidak nol.

COleControlSite::m_ctlInfo

Informasi tentang bagaimana input keyboard ditangani oleh kontrol.

CONTROLINFO m_ctlInfo;

Keterangan

Informasi ini disimpan dalam struktur CONTROLINFO .

COleControlSite::m_dwEventSink

Berisi cookie titik koneksi dari sink peristiwa kontrol.

DWORD m_dwEventSink;

COleControlSite::m_dwMiscStatus

Berisi informasi lain-lain tentang kontrol.

DWORD m_dwMiscStatus;

Keterangan

Untuk informasi selengkapnya, lihat OLEMISCdi Windows SDK.

COleControlSite::m_dwPropNotifySink

Berisi cookie IPropertyNotifySink.

DWORD m_dwPropNotifySink;

COleControlSite::m_dwStyle

Berisi gaya Jendela kontrol.

DWORD m_dwStyle;

COleControlSite::m_hWnd

Berisi HWND kontrol, atau NULL jika kontrol tanpa jendela.

HWND m_hWnd;

COleControlSite::m_iidEvents

Berisi ID antarmuka antarmuka antarmuka sink peristiwa default kontrol.

IID m_iidEvents;

COleControlSite::m_nID

Berisi ID item dialog kontrol.

UINT m_nID;

COleControlSite::m_pActiveObject

Berisi antarmuka kontrol IOleInPlaceActiveObject.

LPOLEINPLACEACTIVEOBJECT m_pActiveObject;

COleControlSite::m_pCtrlCont

Berisi kontainer kontrol (mewakili formulir).

COleControlContainer* m_pCtrlCont;

COleControlSite::m_pInPlaceObject

IOleInPlaceObject Berisi antarmuka kontrol IOleInPlaceObject.

LPOLEINPLACEOBJECT m_pInPlaceObject;

COleControlSite::m_pObject

IOleObjectInterface Berisi antarmuka kontrol.

LPOLEOBJECT m_pObject;

COleControlSite::m_pWindowlessObject

IOleInPlaceObjectWindowlessBerisi antarmuka kontrol IOleInPlaceObjectWindowless.

IOleInPlaceObjectWindowless* m_pWindowlessObject;

COleControlSite::m_pWndCtrl

Berisi penunjuk ke CWnd objek yang mewakili kontrol itu sendiri.

CWnd* m_pWndCtrl;

COleControlSite::m_rect

Berisi batas kontrol, relatif terhadap jendela kontainer.

CRect m_rect;

COleControlSite::ModifikasiStyle

Memodifikasi gaya kontrol.

virtual BOOL ModifyStyle(
    DWORD dwRemove,
    DWORD dwAdd,
    UINT nFlags);

Parameter

dwRemove
Gaya yang akan dihapus dari gaya jendela saat ini.

dwTambahkan
Gaya yang akan ditambahkan dari gaya jendela saat ini.

nFlags
Bendera penempatan jendela. Untuk daftar nilai yang mungkin, lihat fungsi SetWindowPos di Windows SDK.

Tampilkan Nilai

Bukan nol jika gaya diubah, jika tidak, nol.

Keterangan

Properti diaktifkan stok kontrol akan dimodifikasi agar sesuai dengan pengaturan untuk WS_DISABLED. Properti Gaya Batas saham kontrol akan dimodifikasi agar sesuai dengan pengaturan yang diminta untuk WS_BORDER. Semua gaya lain diterapkan langsung ke handel jendela kontrol, jika ada.

Memodifikasi gaya jendela kontrol. Gaya yang akan ditambahkan atau dihapus dapat dikombinasikan dengan menggunakan operator bitwise OR (|). Lihat fungsi CreateWindow di Windows SDK untuk informasi tentang gaya jendela yang tersedia.

Jika nFlags nonzero, ModifyStyle memanggil fungsi SetWindowPosWin32 , dan menggambar ulang jendela dengan menggabungkan nFlags dengan empat bendera berikut:

  • SWP_NOSIZE Mempertahankan ukuran saat ini.

  • SWP_NOMOVE Mempertahankan posisi saat ini.

  • SWP_NOZORDER Mempertahankan urutan Z saat ini.

  • SWP_NOACTIVATE Tidak mengaktifkan jendela.

Untuk mengubah gaya jendela yang diperluas, panggil ModifyStyleEx.

COleControlSite::ModifikasiStyleEx

Memodifikasi gaya kontrol yang diperluas.

virtual BOOL ModifyStyleEx(
    DWORD dwRemove,
    DWORD dwAdd,
    UINT nFlags);

Parameter

dwRemove
Gaya yang diperluas akan dihapus dari gaya jendela saat ini.

dwTambahkan
Gaya yang diperluas untuk ditambahkan dari gaya jendela saat ini.

nFlags
Bendera penempatan jendela. Untuk daftar nilai yang mungkin, lihat fungsi SetWindowPos di Windows SDK.

Tampilkan Nilai

Bukan nol jika gaya diubah, jika tidak, nol.

Keterangan

Properti Tampilan saham kontrol akan dimodifikasi agar sesuai dengan pengaturan untuk WS_EX_CLIENTEDGE. Semua gaya jendela yang diperluas lainnya diterapkan langsung ke handel jendela kontrol, jika ada.

Memodifikasi gaya jendela yang diperluas dari objek situs kontrol. Gaya yang akan ditambahkan atau dihapus dapat dikombinasikan dengan menggunakan operator bitwise OR (|). Lihat fungsi CreateWindowEx di Windows SDK untuk informasi tentang gaya jendela yang tersedia.

Jika nFlags nonzero, ModifyStyleEx memanggil fungsi SetWindowPosWin32 , dan menggambar ulang jendela dengan menggabungkan nFlags dengan empat bendera berikut:

  • SWP_NOSIZE Mempertahankan ukuran saat ini.

  • SWP_NOMOVE Mempertahankan posisi saat ini.

  • SWP_NOZORDER Mempertahankan urutan Z saat ini.

  • SWP_NOACTIVATE Tidak mengaktifkan jendela.

Untuk mengubah gaya jendela yang diperluas, panggil ModifikasiStyle.

COleControlSite::MoveWindow

Mengubah posisi kontrol.

virtual void MoveWindow(
    int x,
    int y,
    int nWidth,
    int nHeight);

Parameter

x
Posisi baru sisi kiri jendela.

y
Posisi baru bagian atas jendela.

nWidth
Lebar baru jendela

nHeight
Tinggi baru jendela.

COleControlSite::QuickActivate

Mengaktifkan kontrol yang terkandung dengan cepat.

virtual BOOL QuickActivate();

Tampilkan Nilai

Bukan nol jika situs kontrol diaktifkan, jika tidak, nol.

Keterangan

Fungsi ini harus dipanggil hanya jika pengguna mengambil alih proses pembuatan kontrol.

Metode IPersist*::Load dan IPersist*::InitNew harus dipanggil setelah aktivasi cepat terjadi. Kontrol harus membuat koneksinya ke sink kontainer selama aktivasi cepat. Namun, koneksi ini tidak hidup sampai IPersist*::Load atau IPersist*::InitNew telah dipanggil.

COleControlSite::SafeSetProperty

Mengatur properti kontrol yang ditentukan oleh dwDispID.

virtual BOOL AFX_CDECL SafeSetProperty(
    DISPID dwDispID,
    VARTYPE vtProp, ...);

Parameter

dwDispID
Mengidentifikasi ID pengiriman properti atau metode, yang ditemukan pada antarmuka kontrol IDispatch , untuk diatur.

vtProp
Menentukan tipe properti yang akan disetel. Untuk nilai yang mungkin, lihat bagian Keterangan untuk COleDispatchDriver::InvokeHelper.

...
Parameter tunggal dari jenis yang ditentukan oleh vtProp.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

Catatan

Tidak seperti SetProperty dan SetPropertyV, jika terjadi kesalahan (seperti mencoba mengatur properti yang tidak ada), tidak ada pengecualian yang dilemparkan.

COleControlSite::SetDefaultButton

Mengatur kontrol sebagai tombol default.

void SetDefaultButton(BOOL bDefault);

Parameter

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

Keterangan

Catatan

Kontrol harus memiliki set bit status OLEMISC_ACTSLIKEBUTTON.

COleControlSite::SetDlgCtrlID

Mengubah nilai pengidentifikasi item dialog kontrol.

virtual int SetDlgCtrlID(int nID);

Parameter

Nid
Nilai pengidentifikasi baru.

Tampilkan Nilai

Jika berhasil, pengidentifikasi item dialog sebelumnya dari jendela; jika tidak, 0.

Keterangan

COleControlSite::SetFocus

Mengatur fokus ke kontrol.

virtual CWnd* SetFocus();
virtual CWnd* SetFocus(LPMSG lpmsg);

Parameter

lpmsg
Penunjuk ke struktur MSG. Struktur ini berisi pesan Windows yang SetFocus memicu permintaan kontrol yang terkandung dalam situs kontrol saat ini.

Tampilkan Nilai

Penunjuk ke jendela yang sebelumnya memiliki fokus.

COleControlSite::SetProperty

Mengatur properti kontrol yang ditentukan oleh dwDispID.

virtual void AFX_CDECL SetProperty(
    DISPID dwDispID,
    VARTYPE vtProp, ...);

Parameter

dwDispID
Mengidentifikasi ID pengiriman properti atau metode, yang ditemukan pada antarmuka kontrol IDispatch , untuk diatur.

vtProp
Menentukan tipe properti yang akan disetel. Untuk nilai yang mungkin, lihat bagian Keterangan untuk COleDispatchDriver::InvokeHelper.

...
Parameter tunggal dari jenis yang ditentukan oleh vtProp.

Keterangan

Jika SetProperty mengalami kesalahan, pengecualian akan dilemparkan.

Jenis pengecualian ditentukan oleh nilai pengembalian dari upaya untuk mengatur properti atau metode. Jika nilai yang dikembalikan adalah DISP_E_EXCEPTION, akan COleDispatchExcpetion dilemparkan; jika tidak, .COleException

COleControlSite::SetPropertyV

Mengatur properti kontrol yang ditentukan oleh dwDispID.

virtual void SetPropertyV(
    DISPID dwDispID,
    VARTYPE vtProp,
    va_list argList);

Parameter

dwDispID
Mengidentifikasi ID pengiriman properti atau metode, yang ditemukan pada antarmuka kontrol IDispatch , untuk diatur.

vtProp
Menentukan tipe properti yang akan disetel. Untuk nilai yang mungkin, lihat bagian Keterangan untuk COleDispatchDriver::InvokeHelper.

argList
Penunjuk ke daftar argumen.

Keterangan

Parameter tambahan untuk metode atau properti yang dipanggil dapat diteruskan menggunakan parameter arg_list . Jika SetProperty mengalami kesalahan, pengecualian akan dilemparkan.

Jenis pengecualian ditentukan oleh nilai pengembalian dari upaya untuk mengatur properti atau metode. Jika nilai yang dikembalikan adalah DISP_E_EXCEPTION, akan COleDispatchExcpetion dilemparkan; jika tidak, .COleException

COleControlSite::SetWindowPos

Mengatur ukuran, posisi, dan urutan Z situs kontrol.

virtual BOOL SetWindowPos(
    const CWnd* pWndInsertAfter,
    int x,
    int y,
    int cx,
    int cy,
    UINT nFlags);

Parameter

pWndInsertAfter
Penunjuk ke jendela.

x
Posisi baru sisi kiri jendela.

y
Posisi baru bagian atas jendela.

cx
Lebar baru jendela

Cy
Tinggi baru jendela.

nFlags
Menentukan bendera ukuran dan penempatan jendela. Untuk nilai yang mungkin, lihat bagian Keterangan untuk SetWindowPos di Windows SDK.

Tampilkan Nilai

Bukan nol jika berhasil, jika tidak, nol.

COleControlSite::SetWindowText

Mengatur teks untuk situs kontrol.

virtual void SetWindowText(LPCTSTR lpszString);

Parameter

lpszString
Penunjuk ke string yang dihentikan null untuk digunakan sebagai judul atau teks kontrol baru.

Keterangan

Fungsi ini pertama-tama mencoba mengatur properti stok Keterangan. Jika properti Stok Keterangan tidak didukung, properti Teks diatur sebagai gantinya.

COleControlSite::ShowWindow

Mengatur status peragaan jendela.

virtual BOOL ShowWindow(int nCmdShow);

Parameter

nCmdShow
Menentukan bagaimana situs kontrol akan ditampilkan. Ini harus menjadi salah satu nilai berikut:

  • SW_HIDE Menyembunyikan jendela ini dan meneruskan aktivasi ke jendela lain.

  • SW_MINIMIZE Meminimalkan jendela dan mengaktifkan jendela tingkat atas dalam daftar sistem.

  • SW_RESTORE Mengaktifkan dan menampilkan jendela. Jika jendela diminimalkan atau dimaksimalkan, Windows memulihkannya ke ukuran dan posisi aslinya.

  • SW_SHOW Mengaktifkan jendela dan menampilkannya dalam ukuran dan posisinya saat ini.

  • SW_SHOWMAXIMIZED Mengaktifkan jendela dan menampilkannya sebagai jendela yang dimaksimalkan.

  • SW_SHOWMINIMIZED Mengaktifkan jendela dan menampilkannya sebagai ikon.

  • SW_SHOWMINNOACTIVE Menampilkan jendela sebagai ikon. Jendela yang saat ini aktif tetap aktif.

  • SW_SHOWNA Menampilkan jendela dalam statusnya saat ini. Jendela yang saat ini aktif tetap aktif.

  • SW_SHOWNOACTIVATE Menampilkan jendela dalam ukuran dan posisi terbarunya. Jendela yang saat ini aktif tetap aktif.

  • SW_SHOWNORMAL Mengaktifkan dan menampilkan jendela. Jika jendela diminimalkan atau dimaksimalkan, Windows memulihkannya ke ukuran dan posisi aslinya.

Tampilkan Nilai

Bukan nol jika jendela sebelumnya terlihat; 0 jika jendela sebelumnya disembunyikan.

Lihat juga

Kelas CCmdTarget
Bagan Hierarki
Kelas COleControlContainer