COccManager osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Kezeli a különböző egyéni vezérlőhelyeket; és objektumok által COleControlContainerCOleControlSite implementálva.

Szemantika

class COccManager : public CNoTrackObject

Tagok

Nyilvános metódusok

Név	Description
COccManager::CreateContainer	Létrehoz egy objektumot COleContainer .
COccManager::CreateDlgControls	Létrehozza a társított COleContainer objektum által üzemeltetett ActiveX-vezérlőket.
COccManager::CreateSite	Létrehoz egy objektumot COleClientSite .
COccManager::GetDefBtnCode	Lekéri az alapértelmezett gomb kódját.
COccManager::IsDialogMessage	Meghatározza egy párbeszédpanel üzenetének célját.
COccManager::IsLabelControl	Meghatározza, hogy a megadott vezérlő címkevezérlő-e.
COccManager::IsMatchingMnemonic	Meghatározza, hogy az aktuális mnemonikus egyezik-e a megadott vezérlőelem mnemonikus értékével.
COccManager::OnEvent	Megkísérli kezelni a megadott eseményt.
COccManager::P ostCreateDialog	Felszabadítja a párbeszédpanel létrehozása során lefoglalt erőforrásokat.
COccManager::P reCreateDialog	Az ActiveX-vezérlők párbeszédpanelsablonjának kezelése.
COccManager::SetDefaultButton	A megadott vezérlőelem alapértelmezett állapotának váltása.
COccManager::SplitDialogTemplate	Elválasztja a meglévő ActiveX-vezérlőket a megadott párbeszédpanelsablonban található gyakori vezérlőktől.

Megjegyzések

Az alaposztály egy CNoTrackObjectnem dokumentált alaposztály (az AFXTLS-ben található). H). Az MFC-keretrendszer által való használatra tervezett osztály az osztályból származó osztályok mentesülnek a CNoTrackObject memóriaszivárgás észlelése alól. Nem ajánlott közvetlenül a forrásból CNoTrackObjectszármazni.

Öröklési hierarchia

CNoTrackObject

COccManager

Requirements

Fejléc: afxocc.h

COccManager::CreateContainer

A keretrendszer meghívta egy vezérlőtároló létrehozásához.

virtual COleControlContainer* CreateContainer(CWnd* pWnd);

Paraméterek

pWnd
Az egyéni helytárolóhoz társított ablakobjektumra mutató mutató.

Visszaadott érték

Mutató az újonnan létrehozott tárolóra; ellenkező esetben NULL.

Megjegyzések

További információ az egyéni webhelyek létrehozásáról: COleControlContainer::AttachControlSite.

COccManager::CreateDlgControls

Hívja meg ezt a függvényt a pOccDialogInfo paraméter által megadott ActiveX-vezérlők létrehozásához.

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

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

Paraméterek

pWndParent
A párbeszédpanel-objektum szülőjének mutatója.

lpszResourceName
A létrehozott erőforrás neve.

pOccDialogInfo
A párbeszédpanel-objektum létrehozásához használt párbeszédpanelsablonra mutató mutató.

lpResource
Egy erőforrásra mutató mutató.

Visszaadott érték

Nemzero, ha a vezérlő sikeresen létrejött; ellenkező esetben nulla.

COccManager::CreateSite

A keretrendszer meghívta egy vezérlőhely létrehozására, amelyet a pCtrlCont által mutatott tároló üzemeltet.

virtual COleControlSite* CreateSite(COleControlContainer* pCtrlCont);

Paraméterek

pCtrlCont
Mutató az új vezérlőwebhelyet üzemeltető vezérlőtárolóra.

Visszaadott érték

Mutató az újonnan létrehozott vezérlőwebhelyre.

Megjegyzések

A függvény felülbírálása egyéni vezérlőwebhely létrehozásához a COleControlSite-alapú osztály használatával.

Minden vezérlőtároló több helyet is üzemeltethet. Hozzon létre további webhelyeket több hívással.CreateSite

COccManager::GetDefBtnCode

Hívja meg ezt a függvényt annak megállapításához, hogy a vezérlő alapértelmezett leküldéses gomb-e.

static DWORD AFX_CDECL GetDefBtnCode(CWnd* pWnd);

Paraméterek

pWnd
A gombvezérlőt tartalmazó ablakobjektum.

Visszaadott érték

Az alábbi értékek egyike:

• DLGC_DEFPUSHBUTTON Vezérlőelem az alapértelmezett gomb a párbeszédpanelen.

• DLGC_UNDEFPUSHBUTTON Vezérlőelem nem az alapértelmezett gomb a párbeszédpanelen.

• 0 A vezérlő nem gomb.

COccManager::IsDialogMessage

A keretrendszer meghívta, hogy megállapítsa, hogy egy üzenet a megadott párbeszédpanelre van-e szánva, és ha igen, feldolgozza az üzenetet.

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

Paraméterek

pWndDlg
Mutató az üzenet kívánt cél párbeszédpanelére.

lpMsg
Az ellenőrizni kívánt üzenetet tartalmazó struktúra mutatója MSG .

Visszaadott érték

Nonzero, ha az üzenet feldolgozása folyamatban van; ellenkező esetben nulla.

Megjegyzések

Az alapértelmezett viselkedés IsDialogMessage az, hogy ellenőrizze a billentyűzetüzeneteket, és azokat a megfelelő párbeszédpanelen kijelölt elemekké alakítsa. A TAB billentyű lenyomásakor például kiválasztja a következő vezérlőt vagy vezérlőelemcsoportot.

Felülbírálja ezt a függvényt, hogy egyéni viselkedést biztosítson a megadott párbeszédpanelre küldött üzenetekhez.

COccManager::IsLabelControl

Hívja meg ezt a függvényt annak megállapításához, hogy a megadott vezérlő címkevezérlő-e.

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

Paraméterek

pWnd
Mutató a vezérlőt tartalmazó ablakra.

Visszaadott érték

Nonzero, ha a vezérlő címke; egyébként nulla

Megjegyzések

A címkevezérlő olyan, amely címkeként működik a sorrendben következő vezérlőelemhez.

COccManager::IsMatchingMnemonic

Hívja meg ezt a függvényt annak megállapításához, hogy az aktuális mnemonikus egyezések a vezérlőelem által képviseltek-e.

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

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

Paraméterek

pWnd
Mutató a vezérlőt tartalmazó ablakra.

lpMsg
Az egyező mnemonikát tartalmazó üzenetre mutató mutató.

Visszaadott érték

Nonzero, ha a mnemonic megfelel a vezérlőnek; egyébként nulla

Megjegyzések

COccManager::OnEvent

A keretrendszer meghívta a megadott esemény kezelésére.

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

Paraméterek

pCmdTarget
Az eseményt kezelni próbáló objektum mutatója CCmdTarget

idCtrl
A vezérlő erőforrás-azonosítója.

pEvent
A kezelt esemény.

pHandlerInfo
Ha nem NULL, OnEvent akkor a parancs elküldése helyett kitölti a pTarget struktúra és pmf a AFX_CMDHANDLERINFO tagok szövegét. Ennek a paraméternek általában NULL értékűnek kell lennie.

Visszaadott érték

Nonzero, ha az eseményt kezelték, egyébként nulla.

Megjegyzések

A függvény felülbírálása az alapértelmezett eseménykezelési folyamat testreszabásához.

COccManager::P reCreateDialog

A keretrendszer meghívta az ActiveX-vezérlők párbeszédpanelsablonjának feldolgozására a tényleges párbeszédpanel létrehozása előtt.

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

Paraméterek

pOccDialogInfo
A _AFX_OCC_DIALOG_INFO párbeszédpanelsablonra vonatkozó információkat és a párbeszédpanel által üzemeltetett ActiveX-vezérlőket tartalmazó struktúra.

pOrigTemplate
A párbeszédpanel létrehozásához használandó párbeszédpanelsablonra mutató mutató.

Visszaadott érték

A párbeszédpanel létrehozásához használt párbeszédpanelsablon-struktúra mutatója.

Megjegyzések

Az alapértelmezett viselkedés meghív egy hívást SplitDialogTemplate, amely meghatározza, hogy vannak-e ActiveX-vezérlők, majd visszaadja az eredményül kapott párbeszédpanelsablont.

A függvény felülbírálása az ActiveX-vezérlőket futtató párbeszédpanel létrehozásának folyamatának testreszabásához.

COccManager::P ostCreateDialog

A keretrendszer meghívta a párbeszédpanelsablonhoz lefoglalt memória felszabadítására.

virtual void PostCreateDialog(_AFX_OCC_DIALOG_INFO* pOccDialogInfo);

Paraméterek

pOccDialogInfo
A _AFX_OCC_DIALOG_INFO párbeszédpanelsablonra vonatkozó információkat és a párbeszédpanel által üzemeltetett ActiveX-vezérlőket tartalmazó struktúra.

Megjegyzések

Ezt a memóriát egy hívás SplitDialogTemplatefoglalta le, és a párbeszédpanelen lévő összes üzemeltetett ActiveX-vezérlőhöz használták.

A függvény felülbírálása a párbeszédpanel-objektum által használt erőforrások eltávolításának folyamatának testreszabásához.

COccManager::SetDefaultButton

A függvény meghívásával állítsa be a vezérlőt alapértelmezett gombként.

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

Paraméterek

pWnd
Mutató a vezérlőt tartalmazó ablakra.

bDefault
Nonzero, ha a vezérlő legyen az alapértelmezett gomb; ellenkező esetben nulla.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

Megjegyzés:

A vezérlőnek OLEMISC_ACTSLIKEBUTTON állapotbitkészlettel kell rendelkeznie. Az OLEMISC-jelzőkkel kapcsolatos további információkért tekintse meg az OLEMISC témakört a Windows SDK-ban.

COccManager::SplitDialogTemplate

A keretrendszer meghívta az ActiveX-vezérlőket a gyakori párbeszédpanel-vezérlőkről való felosztására.

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

Paraméterek

pTemplate
A vizsgálandó párbeszédpanel-sablonra mutató mutató.

ppOleDlgItems
Az ActiveX-vezérlőket tartalmazó párbeszédpanelelemek mutatóinak listája.

Visszaadott érték

Mutató egy olyan párbeszédpanelsablon-struktúrára, amely csak nem ActiveX-vezérlőket tartalmaz. Ha nincsenek ActiveX-vezérlők, a null értéket adja vissza.

Megjegyzések

Ha bármilyen ActiveX-vezérlőt talál, a rendszer elemzi a sablont, és létrehoz egy új sablont, amely csak nem ActiveX-vezérlőket tartalmaz. A folyamat során talált ActiveX-vezérlők a ppOleDlgItems elemhez lesznek hozzáadva.

Ha a sablonban nincsenek ActiveX-vezérlők, a null értéket adja vissza a rendszer.

Megjegyzés:

Az új sablonhoz lefoglalt memória felszabadul a PostCreateDialog függvényben.

A folyamat testreszabásához felülbírálja ezt a függvényt.

Lásd még

hierarchiadiagram
COleControlSite osztály
COleControlContainer osztály