Aracılığıyla paylaş

COleControlSite Sınıfı

  • Makale

Özel istemci tarafı denetim arabirimleri için destek sağlar.

Sözdizimi

class COleControlSite : public CCmdTarget

Üyeler

Ortak Oluşturucular

Veri Akışı Adı Açıklama
COleControlSite::COleControlSite Bir COleControlSite nesne oluşturur.

Genel Yöntemler

Veri Akışı Adı Açıklama
COleControlSite::BindDefaultProperty Barındırılan denetimin varsayılan özelliğini bir veri kaynağına bağlar.
COleControlSite::BindProperty Barındırılan denetimin bir özelliğini bir veri kaynağına bağlar.
COleControlSite::CreateControl Barındırılan bir ActiveX denetimi oluşturur.
COleControlSite::D estroyControl Barındırılan denetimi yok eder.
COleControlSite::D oVerb Barındırılan denetimin belirli bir fiilini yürütür.
COleControlSite::EnableDSC Denetim sitesi için veri kaynağını belirlemeyi etkinleştirir.
COleControlSite::EnableWindow Denetim sitesini etkinleştirir.
COleControlSite::FreezeEvents Denetim sitesinin olayları kabullenip kabul etmediğini belirtir.
COleControlSite::GetDefBtnCode Barındırılan denetim için varsayılan düğme kodunu alır.
COleControlSite::GetDlgCtrlID Denetimin tanımlayıcısını alır.
COleControlSite::GetEventIID Barındırılan denetim için bir olay arabiriminin kimliğini alır.
COleControlSite::GetExStyle Denetim sitesinin genişletilmiş stillerini alır.
COleControlSite::GetProperty Barındırılan denetimin belirli bir özelliğini alır.
COleControlSite::GetStyle Denetim sitesinin stillerini alır.
COleControlSite::GetWindowText Barındırılan denetimin metnini alır.
COleControlSite::InvokeHelper Barındırılan denetimin belirli bir yöntemini çağırın.
COleControlSite::InvokeHelperV Bağımsız değişkenlerin değişken listesiyle barındırılan denetimin belirli bir yöntemini çağırın.
COleControlSite::IsDefaultButton Denetimin penceredeki varsayılan düğme olup olmadığını belirler.
COleControlSite::IsWindowEnabled Denetim sitesinin görünür durumunu denetler.
COleControlSite::ModifyStyle Denetim sitesinin geçerli genişletilmiş stillerini değiştirir.
COleControlSite::ModifyStyleEx Denetim sitesinin geçerli stillerini değiştirir.
COleControlSite::MoveWindow Denetim sitesinin konumunu değiştirir.
COleControlSite::QuickActivate Barındırılan denetimi hızlı bir şekilde etkinleştirir.
COleControlSite::SafeSetProperty Özel durum oluşturma şansı olmadan denetimin bir özelliğini veya yöntemini ayarlar.
COleControlSite::SetDefaultButton Penceredeki varsayılan düğmeyi ayarlar.
COleControlSite::SetDlgCtrlID Denetimin tanımlayıcısını alır.
COleControlSite::SetFocus Odağı denetim sitesine ayarlar.
COleControlSite::SetProperty Barındırılan denetimin belirli bir özelliğini ayarlar.
COleControlSite::SetPropertyV Bağımsız değişkenlerin değişken listesiyle barındırılan denetimin belirli bir özelliğini ayarlar.
COleControlSite::SetWindowPos Denetim sitesinin konumunu ayarlar.
COleControlSite::SetWindowText Barındırılan denetimin metnini ayarlar.
COleControlSite::ShowWindow Denetim sitesini gösterir veya gizler.

Korumalı Yöntemler

Veri Akışı Adı Açıklama
COleControlSite::GetControlInfo Barındırılan denetim için klavye bilgilerini ve anımsatıcıları alır.

Ortak Veri Üyeleri

Veri Akışı Adı Açıklama
COleControlSite::m_bIsWindowless Barındırılan denetimin penceresiz bir denetim olup olmadığını belirler.
COleControlSite::m_ctlInfo Denetim için klavye işleme hakkında bilgi içerir.
COleControlSite::m_dwEventSink Denetimin bağlantı noktasının tanımlama bilgisi.
COleControlSite::m_dwMiscStatus Barındırılan denetimin çeşitli durumları.
COleControlSite::m_dwPropNotifySink Denetimin IPropertyNotifySink tanımlama bilgisi.
COleControlSite::m_dwStyle Barındırılan denetimin stilleri.
COleControlSite::m_hWnd Denetim sitesinin tanıtıcısı.
COleControlSite::m_iidEvents Barındırılan denetim için olay arabiriminin kimliği.
COleControlSite::m_nID Barındırılan denetimin kimliği.
COleControlSite::m_pActiveObject Barındırılan denetimin IOleInPlaceActiveObject nesnesine bir işaretçi.
COleControlSite::m_pCtrlCont Barındırılan denetimin kapsayıcısı.
COleControlSite::m_pInPlaceObject Barındırılan denetimin IOleInPlaceObject nesnesine bir işaretçi.
COleControlSite::m_pObject Denetimin IOleObjectInterface arabirimine bir işaretçi.
COleControlSite::m_pWindowlessObject Denetimin IOleInPlaceObjectWindowless arabirimine bir işaretçi.
COleControlSite::m_pWndCtrl Barındırılan denetim için pencere nesnesinin işaretçisi.
COleControlSite::m_rect Denetim sitesinin boyutları.

Açıklamalar

Bu destek, katıştırılmış bir ActiveX denetiminin görüntüleme sitesinin konumu ve kapsamı, takma adı, kullanıcı arabirimi, ortam özellikleri ve kapsayıcısı tarafından sağlanan diğer kaynaklar hakkında bilgi edindiği birincil araçlardır. COleControlSiteIOleControlSite, IOleInPlaceSite, IOleClientSite, IPropertyNotifySink, IBoundObjectSite, INotifyDBEvents, IRowSetNotify arabirimlerini tam olarak uygular. Ayrıca, IDispatch arabirimi (ortam özellikleri ve olay havuzları için destek sağlayan) da uygulanır.

kullanarak COleControlSitebir ActiveX denetim sitesi oluşturmak için öğesinden COleControlSitebir sınıf türetin. Kapsayıcı için türetilmiş sınıfınızda CWnd(örneğin, iletişim kutunuz) işlevi geçersiz kılar CWnd::CreateControlSite .

Devralma Hiyerarşisi

CObject

CCmdTarget

COleControlSite

Gereksinimler

Üst bilgi: afxocc.h

COleControlSite::BindDefaultProperty

Çağıran nesnenin varsayılan basit ilişkili özelliğini, tür kitaplığında işaretlenmiş olarak veri kaynağı denetiminin DataSource, UserName, Password ve SQL özellikleri tarafından tanımlanan temel imleçle bağlar.

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

Parametreler

dwDispID
Veri kaynağı denetimine bağlanacak veri bağlı denetimdeki bir özelliğin DISPID'sini belirtir.

vtProp
Bağlanacak özelliğin türünü belirtir; örneğin, VT_BSTR, VT_VARIANT vb.

szFieldName
Özelliğin bağlanacağı veri kaynağı denetimi tarafından sağlanan imleçte sütunun adını belirtir.

pDSCWnd
Özelliğin CWndbağlanacağı veri kaynağı denetimini barındıran türetilmiş nesnenin işaretçisi.

Açıklamalar

CWnd Bu işlevi çağırdığınız nesne, veriye bağlı bir denetim olmalıdır.

COleControlSite::BindProperty

Çağıran nesnenin basit ilişkili özelliğini tür kitaplığında işaretlenmiş olarak veri kaynağı denetiminin DataSource, UserName, Password ve SQL özellikleri tarafından tanımlanan temel imleçle bağlar.

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

Parametreler

dwDispId
Veri kaynağı denetimine bağlanacak veri bağlı denetimdeki bir özelliğin DISPID'sini belirtir.

pWndDSC
Özelliğin CWndbağlanacağı veri kaynağı denetimini barındıran türetilmiş nesnenin işaretçisi.

Açıklamalar

CWnd Bu işlevi çağırdığınız nesne, veriye bağlı bir denetim olmalıdır.

COleControlSite::COleControlSite

Yeni COleControlSite bir nesne oluşturur.

explicit COleControlSite(COleControlContainer* pCtrlCont);

Parametreler

pCtrlCont
Denetimin kapsayıcısının işaretçisi (AtiveX denetimini barındıran pencereyi temsil eder).

Açıklamalar

Bu işlev COccManager::CreateContainer işlevi tarafından çağrılır . Kapsayıcıların oluşturulmasını özelleştirme hakkında daha fazla bilgi için bkz . COccManager::CreateSite.

COleControlSite::CreateControl

Nesnesi tarafından barındırılan COleControlSite bir ActiveX denetimi oluşturur.

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);

Parametreler

pWndCtrl
Denetimi temsil eden pencere nesnesinin işaretçisi.

clsid
Denetimin benzersiz sınıf kimliği.

lpszWindowName
Denetimde görüntülenecek metnin işaretçisi. Winodw'un Caption veya Text özelliğinin (varsa) değerini ayarlar.

dwStyle
Windows stilleri. Kullanılabilir stiller Açıklamalar bölümünde listelenir.

Rect
Denetimin boyutunu ve konumunu belirtir. Nesne veya RECT yapı olabilirCRect.

Nıd
Denetimin alt pencere kimliğini belirtir.

pPersist
Denetimin kalıcı durumunu içeren bir CFile işaretçi. Varsayılan değer NULL'dır ve denetimin durumunu kalıcı depolamadan geri yüklemeden kendisini başlatdığını gösterir. NULL değilse, bir akış veya depolama biçiminde denetimin kalıcı verilerini içeren türetilmiş bir nesnenin işaretçisi CFileolmalıdır. Bu veriler istemcinin önceki bir etkinleştirmesinde kaydedilmiş olabilir. CFile başka veriler içerebilir, ancak öğesinin çağrısı CreateControlsırasında okuma-yazma işaretçisinin kalıcı verilerin ilk baytını ayarlamış olması gerekir.

bStorage
pPersist içindeki verilerin olarak mı yoksa IStream veri olarak IStorage mı yorumlanması gerektiğini gösterir. pPersist'teki veriler bir depolama alanıysa, bStorage TRUE olmalıdır. pPersist'teki veriler bir akışsa, bStorage YANLIŞ olmalıdır. Varsayılan değer YANLIŞ'tır.

bstrLicKey
İsteğe bağlı lisans anahtarı verileri. Bu veriler yalnızca çalışma zamanı lisans anahtarı gerektiren denetimler oluşturmak için gereklidir. Denetim lisanslamayı destekliyorsa, denetimin oluşturulmasının başarılı olması için bir lisans anahtarı sağlamanız gerekir. Varsayılan değer NULL'dir.

Ppt
Denetimin sol üst köşesini içeren bir POINT yapı işaretçisi. Denetimin boyutu psize değerine göre belirlenir. ppt ve psize değerleri, denetimin boyutunu ve konumunu belirtmeye yönelik isteğe bağlı bir yöntemdir.

psize
Denetimin boyutunu içeren bir SIZE yapıya işaretçi. Sol üst köşe ppt değerine göre belirlenir. ppt ve psize değerleri, denetimin boyutunu ve konumunu belirtmeye yönelik isteğe bağlı bir yöntemdir.

Dönüş Değeri

Standart bir HRESULT değeri.

Açıklamalar

Windows dwStyle bayraklarının yalnızca bir alt kümesi tarafından CreateControldesteklenir:

  • WS_VISIBLE Başlangıçta görünür olan bir pencere oluşturur. Denetimin normal pencereler gibi hemen görünür olmasını istiyorsanız gereklidir.

  • WS_DISABLED Başlangıçta devre dışı bırakılmış bir pencere oluşturur. Devre dışı bırakılmış bir pencere kullanıcıdan giriş alamaz. Denetimin Enabled özelliği varsa ayarlanabilir.

  • WS_BORDER İnce çizgi kenarlıklı bir pencere oluşturur. Denetimin BorderStyle özelliği varsa ayarlanabilir.

  • WS_GROUP Bir denetim grubunun ilk denetimini belirtir. Kullanıcı yön tuşlarını kullanarak klavye odağını gruptaki bir denetimden diğerine değiştirebilir. İlk denetimden sonra WS_GROUP stiliyle tanımlanan tüm denetimler aynı gruba aittir. WS_GROUP stiline sahip bir sonraki denetim grubu sonlandırır ve sonraki grubu başlatır.

  • WS_TABSTOP Kullanıcı SEKME tuşuna bastığında klavye odağını alabilen bir denetim belirtir. SEKME tuşuna basıldığında klavye odağı, WS_TABSTOP stilinin bir sonraki denetimine dönüşür.

Varsayılan boyutlu denetimler oluşturmak için ikinci aşırı yüklemeyi kullanın.

COleControlSite::D estroyControl

Nesneyi yok eder COleControlSite .

virtual BOOL DestroyControl();

Dönüş Değeri

Başarılı olursa sıfır olmayan, aksi takdirde 0.

Açıklamalar

Tamamlandıktan sonra nesne bellekten kaldırılır ve nesnenin işaretçileri artık geçerli olmaz.

COleControlSite::D oVerb

Belirtilen fiili yürütür.

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

Parametreler

nVerb
Yürütülecek fiili belirtir. Aşağıdakilerden birini içerebilir:

Değer Anlamı Simge
0 Birincil fiil OLEIVERB_PRIMARY
-1 İkincil fiil (Yok)
1 Nesneyi düzenlemek üzere görüntüler. OLEIVERB_SHOW
-2 Öğeyi ayrı bir pencerede düzenler. OLEIVERB_OPEN
-3 Nesneyi gizler. OLEIVERB_HIDE
-4 Denetimi yerinde etkinleştirir. OLEIVERB_UIACTIVATE
-5 Ek kullanıcı arabirimi öğeleri olmadan bir denetimi yerinde etkinleştirir. OLEIVERB_INPLACEACTIVATE
7- Denetimin özelliklerini görüntüleyin. OLEIVERB_PROPERTIES

lpMsg
Öğenin etkinleştirilmesine neden olan ileti işaretçisi.

Dönüş Değeri

Standart bir HRESULT değeri.

Açıklamalar

Bu işlev, belirtilen fiili yürütmek için doğrudan denetimin IOleObject arabirimini çağırır. Bu işlev çağrısının sonucu olarak bir özel durum oluşursa, hresult hata kodu döndürülür.

Daha fazla bilgi için bkz . Windows SDK'sında IOleObject::D oVerb .

COleControlSite::EnableDSC

Denetim sitesi için veri kaynağını belirlemeyi etkinleştirir.

virtual void EnableDSC();

Açıklamalar

Denetim sitesi için veri kaynağını oluşturmayı etkinleştirmek ve başlatmak için çerçeve tarafından çağrılır. Özelleştirilmiş davranış sağlamak için bu işlevi geçersiz kılın.

COleControlSite::EnableWindow

Denetim sitesine fare ve klavye girişini etkinleştirir veya devre dışı bırakır.

virtual BOOL EnableWindow(BOOL bEnable);

Parametreler

bEnable
Pencerenin etkinleştirilip etkinleştirilmeymeyeceğini veya devre dışı bırakılıp devre dışı bırakılmayacağını belirtir: Pencere girişi etkinleştirilecekse TRUE, aksi takdirde YANLIŞ.

Dönüş Değeri

Pencere daha önce devre dışı bırakılmışsa sıfır olmayan, aksi halde 0.

COleControlSite::FreezeEvents

Denetim sitesinin bir denetimden tetiklenen olayları işleyip işlemeyeceğini veya yoksayacağını belirtir.

void FreezeEvents(BOOL bFreeze);

Parametreler

bFreeze
Denetim sitesinin olayları kabul etmeyi durdurmak isteyip istemediğinizi belirtir. Denetimin olayları kabul etmemesi durumunda sıfır olmayan; aksi takdirde sıfır.

Açıklamalar

BFreeze TRUE ise, denetim sitesi denetimden olayları tetiklemeyi durdurmasını istemektedir. BFreeze YANLIŞ ise, denetim sitesi olayları tetiklemeye devam etmek için denetimden istekte bulunur.

Not

Denetim sitesi tarafından istenirse olayları tetiklemeyi durdurmak için denetim gerekli değildir. Tetikleme devam edebilir, ancak izleyen tüm olaylar denetim sitesi tarafından yoksayılır.

COleControlSite::GetControlInfo

Denetimin klavye anımsatıcıları ve klavye davranışı hakkında bilgi alır.

void GetControlInfo();

Açıklamalar

Bilgiler COleControlSite::m_ctlInfo içinde depolanır.

COleControlSite::GetDefBtnCode

Denetimin varsayılan bir anında iletme düğmesi olup olmadığını belirler.

DWORD GetDefBtnCode();

Dönüş Değeri

Aşağıdaki değerlerden biri olabilir:

  • DLGC_DEFPUSHBUTTON Denetimi, iletişim kutusundaki varsayılan düğmedir.

  • DLGC_UNDEFPUSHBUTTON Denetimi, iletişim kutusundaki varsayılan düğme değildir.

  • 0 Denetim bir düğme değildir.

COleControlSite::GetDlgCtrlID

Denetimin tanımlayıcısını alır.

virtual int GetDlgCtrlID() const;

Dönüş Değeri

Denetimin iletişim kutusu öğesi tanımlayıcısı.

COleControlSite::GetEventIID

Denetimin varsayılan olay arabirimine yönelik bir işaretçi alır.

BOOL GetEventIID(IID* piid);

Parametreler

piid
Arabirim kimliğinin işaretçisi.

Dönüş Değeri

Başarılı olursa sıfır olmayan, aksi takdirde 0. Başarılı olursa, piid denetimin varsayılan olay arabiriminin arabirim kimliğini içerir.

COleControlSite::GetExStyle

Pencerenin genişletilmiş stillerini alır.

virtual DWORD GetExStyle() const;

Dönüş Değeri

Denetim penceresinin genişletilmiş stilleri.

Açıklamalar

Normal stilleri almak için COleControlSite::GetStyle öğesini çağırın.

COleControlSite::GetProperty

dwDispID tarafından belirtilen denetim özelliğini alır.

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

Parametreler

dwDispID
Alınacak denetimin varsayılan IDispatch arabiriminde bulunan özelliğin dağıtım kimliğini tanımlar.

vtProp
Alınacak özelliğin türünü belirtir. Olası değerler için COleDispatchDriver::InvokeHelper için Açıklamalar bölümüne bakın.

pvProp
Özellik değerini alacak değişkenin adresi. vtProp tarafından belirtilen türle eşleşmelidir.

Açıklamalar

değer pvProp aracılığıyla döndürülür.

COleControlSite::GetStyle

Denetim sitesinin stillerini alır.

virtual DWORD GetStyle() const;

Dönüş Değeri

Pencerenin stilleri.

Açıklamalar

Olası değerlerin listesi için bkz . Windows Stilleri. Denetim sitesinin genişletilmiş stillerini almak için COleControlSite::GetExStyle öğesini çağırın.

COleControlSite::GetWindowText

Denetimin geçerli metnini alır.

virtual void GetWindowText(CString& str) const;

Parametreler

str
Denetimin geçerli metnini içeren bir CString nesneye başvuru.

Açıklamalar

Denetim Caption stock özelliğini destekliyorsa, bu değer döndürülür. Caption stock özelliği desteklenmiyorsa Text özelliğinin değeri döndürülür.

COleControlSite::InvokeHelper

dwDispID tarafından belirtilen yöntemi veya özelliği wFlags tarafından belirtilen bağlamda çağırır.

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

Parametreler

dwDispID
Çağrılacak denetimin IDispatch arabiriminde bulunan özellik veya yöntemin dağıtım kimliğini tanımlar.

wFlags
IDispatch::Invoke çağrısının bağlamını açıklayan bayraklar. Olası wFlags değerleri için bkz IDispatch::Invoke . Windows SDK'sında.

vtRet
Dönüş değerinin türünü belirtir. Olası değerler için COleDispatchDriver::InvokeHelper için Açıklamalar bölümüne bakın.

pvRet
Özellik değerini veya dönüş değerini alacak değişkenin adresi. vtRet tarafından belirtilen türle eşleşmelidir.

pbParamInfo
PbParamInfo'nun ardından parametrelerin türlerini belirten null olarak sonlandırılan bayt dizesi işaretçisi. Olası değerler için COleDispatchDriver::InvokeHelper için Açıklamalar bölümüne bakın.

...
PbParamInfo'da belirtilen türlerdeki parametrelerin değişken listesi.

Açıklamalar

pbParamInfo parametresi, yönteme veya özelliğe geçirilen parametre türlerini belirtir. Bağımsız değişkenlerin değişken listesi ... söz dizimi bildiriminde.

Bu işlev parametreleri VARIANTARG değerlerine dönüştürür ve ardından denetimde IDispatch::Invoke yöntemini çağırır. çağrısı IDispatch::Invoke başarısız olursa, bu işlev bir özel durum oluşturur. tarafından IDispatch::Invoke döndürülen durum kodu ise DISP_E_EXCEPTION, bu işlev bir COleDispatchException nesnesi oluşturur, aksi takdirde bir COleExceptionoluşturur.

COleControlSite::InvokeHelperV

dwDispID tarafından belirtilen yöntemi veya özelliği wFlags tarafından belirtilen bağlamda çağırır.

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

Parametreler

dwDispID
Çağrılacak denetimin IDispatch arabiriminde bulunan özellik veya yöntemin dağıtım kimliğini tanımlar.

wFlags
IDispatch::Invoke çağrısının bağlamını açıklayan bayraklar.

vtRet
Dönüş değerinin türünü belirtir. Olası değerler için COleDispatchDriver::InvokeHelper için Açıklamalar bölümüne bakın.

pvRet
Özellik değerini veya dönüş değerini alacak değişkenin adresi. vtRet tarafından belirtilen türle eşleşmelidir.

pbParamInfo
PbParamInfo'nun ardından parametrelerin türlerini belirten null olarak sonlandırılan bayt dizesi işaretçisi. Olası değerler için COleDispatchDriver::InvokeHelper için Açıklamalar bölümüne bakın.

argList
Değişken bağımsız değişken listesinin işaretçisi.

Açıklamalar

pbParamInfo parametresi, yönteme veya özelliğe geçirilen parametre türlerini belirtir. Çağrılan yöntem veya özellik için ek parametreler va_list parametresi kullanılarak geçirilebilir.

Bu işlev genellikle tarafından COleControlSite::InvokeHelperçağrılır.

COleControlSite::IsDefaultButton

Denetimin varsayılan düğme olup olmadığını belirler.

BOOL IsDefaultButton();

Dönüş Değeri

Denetim penceredeki varsayılan düğmeyse sıfır değil, aksi takdirde sıfır.

COleControlSite::IsWindowEnabled

Denetim sitesinin etkinleştirilip etkinleştirilmediğini belirler.

virtual BOOL IsWindowEnabled() const;

Dönüş Değeri

Denetim etkinse sıfır olmayan, aksi takdirde sıfır.

Açıklamalar

Değer denetimin Etkin hisse senedi özelliğinden alınır.

COleControlSite::m_bIsWindowless

Nesnenin penceresiz bir denetim olup olmadığını belirler.

BOOL m_bIsWindowless;

Açıklamalar

Denetimin penceresi yoksa sıfır olmayan, aksi halde sıfır.

COleControlSite::m_ctlInfo

Klavye girişinin denetim tarafından nasıl işleneceğini gösteren bilgiler.

CONTROLINFO m_ctlInfo;

Açıklamalar

Bu bilgiler CONTROLINFO yapısında depolanır.

COleControlSite::m_dwEventSink

Denetimin olay havuzundaki bağlantı noktasının tanımlama bilgisini içerir.

DWORD m_dwEventSink;

COleControlSite::m_dwMiscStatus

Denetim hakkında çeşitli bilgiler içerir.

DWORD m_dwMiscStatus;

Açıklamalar

Daha fazla bilgi için bkz . Windows SDK'sında OLEMISC.

COleControlSite::m_dwPropNotifySink

IPropertyNotifySink tanımlama bilgisini içerir.

DWORD m_dwPropNotifySink;

COleControlSite::m_dwStyle

Denetimin Pencere stillerini içerir.

DWORD m_dwStyle;

COleControlSite::m_hWnd

Denetimin HWND'sini veya denetim penceresizse NULL değerini içerir.

HWND m_hWnd;

COleControlSite::m_iidEvents

Denetimin varsayılan olay havuzu arabiriminin arabirim kimliğini içerir.

IID m_iidEvents;

COleControlSite::m_nID

Denetimin iletişim kutusu öğesi kimliğini içerir.

UINT m_nID;

COleControlSite::m_pActiveObject

Denetimin IOleInPlaceActiveObject arabirimini içerir.

LPOLEINPLACEACTIVEOBJECT m_pActiveObject;

COleControlSite::m_pCtrlCont

Denetimin kapsayıcısını (formu temsil eden) içerir.

COleControlContainer* m_pCtrlCont;

COleControlSite::m_pInPlaceObject

Denetimin IOleInPlaceObject IOleInPlaceObject arabirimini içerir.

LPOLEINPLACEOBJECT m_pInPlaceObject;

COleControlSite::m_pObject

Denetimin IOleObjectInterface arabirimini içerir.

LPOLEOBJECT m_pObject;

COleControlSite::m_pWindowlessObject

Denetimin IOleInPlaceObjectWindowlessIOleInPlaceObjectWindowless arabirimini içerir.

IOleInPlaceObjectWindowless* m_pWindowlessObject;

COleControlSite::m_pWndCtrl

Denetimin CWnd kendisini temsil eden nesneye ilişkin bir işaretçi içerir.

CWnd* m_pWndCtrl;

COleControlSite::m_rect

Kapsayıcının penceresine göre denetimin sınırlarını içerir.

CRect m_rect;

COleControlSite::ModifyStyle

Denetimin stillerini değiştirir.

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

Parametreler

dwRemove
Geçerli pencere stillerinden kaldırılacak stiller.

dwAdd
Geçerli pencere stillerinden eklenecek stiller.

nFlags
Pencere konumlandırma bayrakları. Olası değerlerin listesi için Windows SDK'sında SetWindowPos işlevine bakın.

Dönüş Değeri

Stiller değiştirilirse sıfır olmayan, aksi halde sıfır.

Açıklamalar

Denetimin hisse senedi Etkin özelliği, WS_DISABLED ayarıyla eşleşecek şekilde değiştirilir. Denetimin stok Kenarlık Stili özelliği, WS_BORDER için istenen ayara uyacak şekilde değiştirilir. Diğer tüm stiller, varsa doğrudan denetimin pencere tutamacına uygulanır.

Denetimin pencere stillerini değiştirir. Eklenecek veya kaldırılacak stiller bit düzeyinde OR (|) işleci kullanılarak birleştirilebilir. Kullanılabilir pencere stilleri hakkında bilgi için Windows SDK'sında CreateWindow işlevine bakın.

nFlags sıfır değilse Win32 ModifyStyle işlevini SetWindowPosçağırır ve nFlags öğesini aşağıdaki dört bayrakla birleştirerek pencereyi yeniden çizer:

  • SWP_NOSIZE Geçerli boyutu korur.

  • SWP_NOMOVE Geçerli konumu korur.

  • SWP_NOZORDER Geçerli Z sırasını korur.

  • SWP_NOACTIVATE Pencereyi etkinleştirmez.

Pencerenin genişletilmiş stillerini değiştirmek için ModifyStyleEx'i çağırabilirsiniz.

COleControlSite::ModifyStyleEx

Denetimin genişletilmiş stillerini değiştirir.

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

Parametreler

dwRemove
Geçerli pencere stillerinden kaldırılacak genişletilmiş stiller.

dwAdd
Geçerli pencere stillerinden eklenecek genişletilmiş stiller.

nFlags
Pencere konumlandırma bayrakları. Olası değerlerin listesi için Windows SDK'sında SetWindowPos işlevine bakın.

Dönüş Değeri

Stiller değiştirilirse sıfır olmayan, aksi halde sıfır.

Açıklamalar

Denetimin hisse senedi Görünümü özelliği, WS_EX_CLIENTEDGE ayarıyla eşleşecek şekilde değiştirilir. Diğer tüm genişletilmiş pencere stilleri, varsa doğrudan denetimin pencere tutamacına uygulanır.

Denetim sitesi nesnesinin pencere genişletilmiş stillerini değiştirir. Eklenecek veya kaldırılacak stiller bit düzeyinde OR (|) işleci kullanılarak birleştirilebilir. Kullanılabilir pencere stilleri hakkında bilgi için windows SDK'sında CreateWindowEx işlevine bakın.

nFlags sıfır değilse Win32 ModifyStyleEx işlevini SetWindowPosçağırır ve nFlags öğesini aşağıdaki dört bayrakla birleştirerek pencereyi yeniden çizer:

  • SWP_NOSIZE Geçerli boyutu korur.

  • SWP_NOMOVE Geçerli konumu korur.

  • SWP_NOZORDER Geçerli Z sırasını korur.

  • SWP_NOACTIVATE Pencereyi etkinleştirmez.

Pencerenin genişletilmiş stillerini değiştirmek için ModifyStyle'ı çağırabilirsiniz.

COleControlSite::MoveWindow

Denetimin konumunu değiştirir.

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

Parametreler

x
Pencerenin sol tarafının yeni konumu.

y
Pencerenin üst kısmındaki yeni konum.

nWidth
Pencerenin yeni genişliği

nHeight
Pencerenin yeni yüksekliği.

COleControlSite::QuickActivate

Hızlı, kapsanan denetimi etkinleştirir.

virtual BOOL QuickActivate();

Dönüş Değeri

Denetim sitesi etkinleştirildiyse sıfır olmayan, aksi takdirde sıfır.

Açıklamalar

Bu işlev yalnızca kullanıcı denetimin oluşturma işlemini geçersiz kıldıysa çağrılmalıdır.

IPersist*::Load Hızlı etkinleştirme gerçekleştikten sonra ve IPersist*::InitNew yöntemleri çağrılmalıdır. Denetim, hızlı etkinleştirme sırasında kapsayıcının havuzlarına bağlantılar kurmalıdır. Ancak, bu bağlantılar çağrılana kadar veya IPersist*::InitNew çağrılana kadar IPersist*::Load canlı değildir.

COleControlSite::SafeSetProperty

dwDispID tarafından belirtilen denetim özelliğini ayarlar.

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

Parametreler

dwDispID
Ayarlanacak denetimin IDispatch arabiriminde bulunan özellik veya yöntemin dağıtım kimliğini tanımlar.

vtProp
Ayarlanacak özellik türünü belirtir. Olası değerler için COleDispatchDriver::InvokeHelper için Açıklamalar bölümüne bakın.

...
vtProp tarafından belirtilen türde tek bir parametre.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde sıfır.

Açıklamalar

Not

ve SetPropertyV'den farklı SetProperty olarak bir hatayla karşılaşılırsa (var olmayan bir özelliği ayarlamaya çalışmak gibi), hiçbir özel durum oluşmaz.

COleControlSite::SetDefaultButton

Denetimi varsayılan düğme olarak ayarlar.

void SetDefaultButton(BOOL bDefault);

Parametreler

bDefault
Denetimin varsayılan düğme olması gerekiyorsa sıfır olmayan; aksi takdirde sıfır.

Açıklamalar

Not

Denetimin OLEMISC_ACTSLIKEBUTTON durumu biti ayarlanmış olmalıdır.

COleControlSite::SetDlgCtrlID

Denetimin iletişim kutusu öğesi tanımlayıcısının değerini değiştirir.

virtual int SetDlgCtrlID(int nID);

Parametreler

Nıd
Yeni tanımlayıcı değeri.

Dönüş Değeri

Başarılı olursa, pencerenin önceki iletişim kutusu öğesi tanımlayıcısı; aksi takdirde 0.

Açıklamalar

COleControlSite::SetFocus

Odağı denetime ayarlar.

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

Parametreler

lpmsg
MSG yapısının işaretçisi. Bu yapı, geçerli denetim sitesinde yer alan denetim isteğini tetikleyen SetFocus Windows iletisini içerir.

Dönüş Değeri

Daha önce odaklanmış olan pencere işaretçisi.

COleControlSite::SetProperty

dwDispID tarafından belirtilen denetim özelliğini ayarlar.

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

Parametreler

dwDispID
Ayarlanacak denetimin IDispatch arabiriminde bulunan özellik veya yöntemin dağıtım kimliğini tanımlar.

vtProp
Ayarlanacak özellik türünü belirtir. Olası değerler için COleDispatchDriver::InvokeHelper için Açıklamalar bölümüne bakın.

...
vtProp tarafından belirtilen türde tek bir parametre.

Açıklamalar

Hatayla karşılaşırsanız SetProperty bir özel durum oluşur.

Özel durum türü, özellik veya yöntemi ayarlama girişiminin dönüş değeri tarafından belirlenir. Dönüş değeri ise DISP_E_EXCEPTION, bir COleDispatchExcpetion oluşturulur; aksi takdirde bir COleException.

COleControlSite::SetPropertyV

dwDispID tarafından belirtilen denetim özelliğini ayarlar.

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

Parametreler

dwDispID
Ayarlanacak denetimin IDispatch arabiriminde bulunan özellik veya yöntemin dağıtım kimliğini tanımlar.

vtProp
Ayarlanacak özellik türünü belirtir. Olası değerler için COleDispatchDriver::InvokeHelper için Açıklamalar bölümüne bakın.

argList
Bağımsız değişken listesinin işaretçisi.

Açıklamalar

Çağrılan yöntem veya özellik için ek parametreler arg_list parametresi kullanılarak geçirilebilir. Hatayla karşılaşırsanız SetProperty bir özel durum oluşur.

Özel durum türü, özellik veya yöntemi ayarlama girişiminin dönüş değeri tarafından belirlenir. Dönüş değeri ise DISP_E_EXCEPTION, bir COleDispatchExcpetion oluşturulur; aksi takdirde bir COleException.

COleControlSite::SetWindowPos

Denetim sitesinin boyutunu, konumunu ve Z sırasını ayarlar.

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

Parametreler

pWndInsertAfter
Pencerenin işaretçisi.

x
Pencerenin sol tarafının yeni konumu.

y
Pencerenin üst kısmındaki yeni konum.

cx
Pencerenin yeni genişliği

Cy
Pencerenin yeni yüksekliği.

nFlags
Pencere boyutlandırma ve konumlandırma bayraklarını belirtir. Olası değerler için Windows SDK'sında SetWindowPos için Açıklamalar bölümüne bakın.

Dönüş Değeri

Başarılı olursa sıfır olmayan, aksi takdirde sıfır.

COleControlSite::SetWindowText

Denetim sitesinin metnini ayarlar.

virtual void SetWindowText(LPCTSTR lpszString);

Parametreler

lpszString
Yeni başlık veya denetim metni olarak kullanılacak null olarak sonlandırılan dize işaretçisi.

Açıklamalar

Bu işlev önce Caption stock özelliğini ayarlamayı dener. Caption stock özelliği desteklenmiyorsa, bunun yerine Text özelliği ayarlanır.

COleControlSite::ShowWindow

Pencerenin gösteri durumunu ayarlar.

virtual BOOL ShowWindow(int nCmdShow);

Parametreler

nCmdShow
Denetim sitesinin nasıl gösterileceğini belirtir. Aşağıdaki değerlerden biri olmalıdır:

  • SW_HIDE Bu pencereyi gizler ve etkinleştirmeyi başka bir pencereye geçirir.

  • SW_MINIMIZE Pencereyi simge durumuna küçültür ve sistem listesindeki en üst düzey pencereyi etkinleştirir.

  • SW_RESTORE Pencereyi etkinleştirir ve görüntüler. Pencere simge durumuna küçültülmüş veya ekranı kaplamışsa, Windows pencereyi özgün boyutuna ve konumuna geri yükler.

  • SW_SHOW Pencereyi etkinleştirir ve geçerli boyutu ve konumunda görüntüler.

  • SW_SHOWMAXIMIZED Pencereyi etkinleştirir ve ekranı kaplamış bir pencere olarak görüntüler.

  • SW_SHOWMINIMIZED Pencereyi etkinleştirir ve simge olarak görüntüler.

  • SW_SHOWMINNOACTIVE Pencereyi simge olarak görüntüler. Şu anda etkin olan pencere etkin kalır.

  • SW_SHOWNA Pencereyi geçerli durumunda görüntüler. Şu anda etkin olan pencere etkin kalır.

  • SW_SHOWNOACTIVATE Pencereyi en son boyutu ve konumuyla görüntüler. Şu anda etkin olan pencere etkin kalır.

  • SW_SHOWNORMAL Pencereyi etkinleştirir ve görüntüler. Pencere simge durumuna küçültülmüş veya ekranı kaplamışsa, Windows pencereyi özgün boyutuna ve konumuna geri yükler.

Dönüş Değeri

Pencere daha önce görünürse sıfır olmayan; Pencere daha önce gizliyse 0.

Ayrıca bkz.

CCmdTarget Sınıfı
Hiyerarşi Grafiği
COleControlContainer Sınıfı