COccManager Sınıfı

Çeşitli özel denetim sitelerini yönetir; ve COleControlSite nesneleri tarafından COleControlContainer uygulanır.

Sözdizimi

class COccManager : public CNoTrackObject

Üyeler

Genel Yöntemler

Veri Akışı Adı	Açıklama
COccManager::CreateContainer	Bir COleContainer nesnesi oluşturur.
COccManager::CreateDlgControls	İlişkili COleContainer nesne tarafından barındırılan ActiveX denetimleri oluşturur.
COccManager::CreateSite	Bir COleClientSite nesnesi oluşturur.
COccManager::GetDefBtnCode	Varsayılan düğmenin kodunu alır.
COccManager::IsDialogMessage	İletişim kutusunun hedefini belirler.
COccManager::IsLabelControl	Belirtilen denetimin bir etiket denetimi olup olmadığını belirler.
COccManager::IsMatchingMnemonic	Geçerli anımsatıcının belirtilen denetimin anımsatıcısı ile eşleşip eşleşmediğini belirler.
COccManager::OnEvent	Belirtilen olayı işlemeye çalışır.
COccManager::P ostCreateDialog	İletişim kutusu oluşturma sırasında ayrılan kaynakları serbest getirir.
COccManager::P ReCreateDialog	ActiveX denetimleri için bir iletişim kutusu şablonunu işler.
COccManager::SetDefaultButton	Belirtilen denetimin varsayılan durumunu değiştirir.
COccManager::SplitDialogTemplate	Mevcut ActiveX denetimlerini belirtilen iletişim kutusu şablonundaki ortak denetimlerden ayırır.

Açıklamalar

temel sınıfı, CNoTrackObjectbelgelenmemiş bir temel sınıftır (AFXTLS'de bulunur). H). MFC çerçevesi tarafından kullanılmak üzere tasarlanan sınıftan CNoTrackObject türetilen sınıflar bellek sızıntısı algılamasından muaf tutulur. doğrudan öğesinden CNoTrackObjecttüretilmiş olmanız önerilmez.

Devralma Hiyerarşisi

CNoTrackObject

COccManager

Gereksinimler

Üst bilgi: afxocc.h

COccManager::CreateContainer

Denetim kapsayıcısı oluşturmak için çerçeve tarafından çağrılır.

virtual COleControlContainer* CreateContainer(CWnd* pWnd);

Parametreler

pWnd
Özel site kapsayıcısıyla ilişkilendirilmiş pencere nesnesinin işaretçisi.

Dönüş Değeri

Yeni oluşturulan kapsayıcının işaretçisi; aksi takdirde NULL.

Açıklamalar

Özel siteler oluşturma hakkında daha fazla bilgi için bkz . COleControlContainer::AttachControlSite.

COccManager::CreateDlgControls

pOccDialogInfo parametresi tarafından belirtilen ActiveX denetimleri oluşturmak için bu işlevi çağırın .

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

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

Parametreler

pWndParent
İletişim kutusu nesnesinin üst öğesinin işaretçisi.

lpszResourceName
Oluşturulan kaynağın adı.

pOccDialogInfo
İletişim kutusu nesnesini oluşturmak için kullanılan iletişim kutusu şablonunun işaretçisi.

lpResource
Bir kaynağın işaretçisi.

Dönüş Değeri

Denetim başarıyla oluşturulduysa sıfır olmayan; aksi takdirde sıfır.

COccManager::CreateSite

pCtrlCont tarafından işaret edilen kapsayıcı tarafından barındırılan bir denetim sitesi oluşturmak için çerçeve tarafından çağrılır.

virtual COleControlSite* CreateSite(COleControlContainer* pCtrlCont);

Parametreler

pCtrlCont
Yeni denetim sitesini barındıran denetim kapsayıcısının işaretçisi.

Dönüş Değeri

Yeni oluşturulan denetim sitesine ilişkin bir işaretçi.

Açıklamalar

COleControlSite türetilmiş sınıfınızı kullanarak özel bir denetim sitesi oluşturmak için bu işlevi geçersiz kılın.

Her denetim kapsayıcısı birden çok site barındırabilir. birden çok çağrısıyla CreateSiteek siteler oluşturun.

COccManager::GetDefBtnCode

Denetimin varsayılan bir anında iletme düğmesi olup olmadığını belirlemek için bu işlevi çağırın.

static DWORD AFX_CDECL GetDefBtnCode(CWnd* pWnd);

Parametreler

pWnd
Düğme denetimini içeren pencere nesnesi.

Dönüş Değeri

Aşağıdaki değerlerden biri:

• 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.

COccManager::IsDialogMessage

Bir iletinin belirtilen iletişim kutusuna yönelik olup olmadığını belirlemek için çerçeve tarafından çağrılır ve hedefleniyorsa iletiyi işler.

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

Parametreler

pWndDlg
İletinin hedeflenen hedef iletişim kutusuna yönelik bir işaretçi.

lpMsg
denetlenecek iletiyi içeren bir MSG yapı işaretçisi.

Dönüş Değeri

İleti işlenirse sıfır olmayan; aksi takdirde sıfır.

Açıklamalar

varsayılan davranışı IsDialogMessage , klavye iletilerini denetlemek ve bunları ilgili iletişim kutusu için seçimlere dönüştürmektir. Örneğin, SEKME tuşu basıldığında bir sonraki denetimi veya denetim grubunu seçer.

Belirtilen iletişim kutusuna gönderilen iletiler için özel davranış sağlamak için bu işlevi geçersiz kılın.

COccManager::IsLabelControl

Belirtilen denetimin bir etiket denetimi olup olmadığını belirlemek için bu işlevi çağırın.

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

Parametreler

pWnd
Denetimi içeren pencerenin işaretçisi.

Dönüş Değeri

Denetim bir etiketse sıfır olmayan; aksi halde sıfır

Açıklamalar

Etiket denetimi, sıralamada sonraki denetim için etiket gibi davranan denetimdir.

COccManager::IsMatchingMnemonic

Geçerli anımsatıcının denetim tarafından temsil edilenle eşleşip eşleşmediğini belirlemek için bu işlevi çağırın.

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

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

Parametreler

pWnd
Denetimi içeren pencerenin işaretçisi.

lpMsg
Eşleşecek anımsatıcıyı içeren ileti işaretçisi.

Dönüş Değeri

Anımsatıcı denetimle eşleşiyorsa sıfır olmayan; aksi halde sıfır

Açıklamalar

COccManager::OnEvent

Belirtilen olayı işlemek için çerçeve tarafından çağrılır.

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

Parametreler

pCmdTarget
Olayı işlemeye CCmdTarget çalışan nesne işaretçisi

idCtrl
Denetimin kaynak kimliği.

pEvent
İşlenen olay.

pHandlerInfo
NULL değilse, OnEvent komutunu göndermek yerine yapısının AFX_CMDHANDLERINFO ve pmf üyelerini doldururpTarget. Genellikle bu parametre NULL olmalıdır.

Dönüş Değeri

Olay işlendiyse sıfır olmayan, aksi takdirde sıfır.

Açıklamalar

Varsayılan olay işleme işlemini özelleştirmek için bu işlevi geçersiz kılın.

COccManager::P ReCreateDialog

Gerçek iletişim kutusunu oluşturmadan önce ActiveX denetimleri için bir iletişim kutusu şablonunu işlemek üzere çerçeve tarafından çağrılır.

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

Parametreler

pOccDialogInfo
İletişim _AFX_OCC_DIALOG_INFO kutusu şablonu ve iletişim kutusu tarafından barındırılan tüm ActiveX denetimleri hakkında bilgi içeren bir yapı.

pOrigTemplate
İletişim kutusunu oluştururken kullanılacak iletişim kutusu şablonunun işaretçisi.

Dönüş Değeri

İletişim kutusunu oluşturmak için kullanılan bir iletişim kutusu şablonu yapısının işaretçisi.

Açıklamalar

Varsayılan davranış, herhangi bir ActiveX denetimi olup olmadığını belirlemek için SplitDialogTemplateçağrısı yapar ve ardından sonuç iletişim kutusu şablonunu döndürür.

ActiveX denetimlerini barındıran bir iletişim kutusu oluşturma işlemini özelleştirmek için bu işlevi geçersiz kılın.

COccManager::P ostCreateDialog

İletişim kutusu şablonu için ayrılan belleği boşaltmak için çerçeve tarafından çağrılır.

virtual void PostCreateDialog(_AFX_OCC_DIALOG_INFO* pOccDialogInfo);

Parametreler

pOccDialogInfo
İletişim _AFX_OCC_DIALOG_INFO kutusu şablonu ve iletişim kutusu tarafından barındırılan tüm ActiveX denetimleri hakkında bilgi içeren bir yapı.

Açıklamalar

Bu bellek, çağrısı SplitDialogTemplatetarafından ayrılmıştır ve iletişim kutusundaki barındırılan ActiveX denetimleri için kullanılmıştır.

İletişim kutusu nesnesi tarafından kullanılan tüm kaynakları temizleme işlemini özelleştirmek için bu işlevi geçersiz kılın.

COccManager::SetDefaultButton

Denetimi varsayılan düğme olarak ayarlamak için bu işlevi çağırın.

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

Parametreler

pWnd
Denetimi içeren pencerenin işaretçisi.

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

Dönüş Değeri

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

Açıklamalar

Not

Denetimin OLEMISC_ACTSLIKEBUTTON durumu biti ayarlanmış olmalıdır. OLEMISC bayrakları hakkında daha fazla bilgi için Windows SDK'sında OLEMISC konusuna bakın.

COccManager::SplitDialogTemplate

ActiveX denetimlerini ortak iletişim kutusu denetimlerinden bölmek için çerçeve tarafından çağrılır.

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

Parametreler

pTemplate
İncelenecek iletişim kutusu şablonunun işaretçisi.

ppOleDlgItems
ActiveX denetimleri olan iletişim kutusu öğelerinin işaretçilerinin listesi.

Dönüş Değeri

Yalnızca ActiveX olmayan denetimleri içeren bir iletişim kutusu şablonu yapısının işaretçisi. ActiveX denetimi yoksa NULL döndürülür.

Açıklamalar

Herhangi bir ActiveX denetimi bulunursa, şablon analiz edilir ve yalnızca ActiveX olmayan denetimleri içeren yeni bir şablon oluşturulur. Bu işlem sırasında bulunan tüm ActiveX denetimleri ppOleDlgItems öğesine eklenir.

Şablonda ActiveX denetimi yoksa NULL döndürülür .

Not

Yeni şablon için ayrılan bellek işlevde PostCreateDialog serbest bırakıldı.

Bu işlemi özelleştirmek için bu işlevi geçersiz kılın.

Ayrıca bkz.

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