Share via

COccManager-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Beheert verschillende aangepaste beheersites; geïmplementeerd door COleControlContainer en COleControlSite objecten.

Syntaxis

class COccManager : public CNoTrackObject

Leden

Openbare methoden

Naam Description
COccManager::CreateContainer Hiermee maakt u een COleContainer object.
COccManager::CreateDlgControls Hiermee maakt u ActiveX-besturingselementen, gehost door het bijbehorende COleContainer object.
COccManager::CreateSite Hiermee maakt u een COleClientSite object.
COccManager::GetDefBtnCode Haalt de code van de standaardknop op.
COccManager::IsDialogMessage Bepaalt het doel van een dialoogvensterbericht.
COccManager::IsLabelControl Bepaalt of het opgegeven besturingselement een label besturingselement is.
COccManager::IsMatchingMnemonic Bepaalt of de huidige mnemonic overeenkomt met het opgegeven besturingselement.
COccManager::OnEvent Pogingen om de opgegeven gebeurtenis af te handelen.
COccManager::P ostCreateDialog Resources vrij die zijn toegewezen tijdens het maken van het dialoogvenster.
COccManager::P reCreateDialog Hiermee wordt een dialoogvenstersjabloon voor ActiveX-besturingselementen verwerkt.
COccManager::SetDefaultButton Hiermee schakelt u de standaardstatus van het opgegeven besturingselement in.
COccManager::SplitDialogTemplate Scheidt bestaande ActiveX-besturingselementen van algemene besturingselementen in de opgegeven dialoogvenstersjabloon.

Opmerkingen

De basisklasse, CNoTrackObjectis een niet-gedocumenteerde basisklasse (in AFXTLS). H). Klassen die zijn afgeleid van de klasse zijn ontworpen voor gebruik door het CNoTrackObject MFC-framework, zijn uitgesloten van detectie van geheugenlekken. Het wordt niet aanbevolen dat u rechtstreeks afgeleid bent van CNoTrackObject.

Overnamehiërarchie

CNoTrackObject

COccManager

Requirements

Koptekst: afxocc.h

COccManager::CreateContainer

Aangeroepen door het framework om een besturingscontainer te maken.

virtual COleControlContainer* CreateContainer(CWnd* pWnd);

Parameterwaarden

pWnd
Een aanwijzer naar het vensterobject dat is gekoppeld aan de aangepaste sitecontainer.

Retourwaarde

Een aanwijzer naar de zojuist gemaakte container; anders NULL.

Opmerkingen

Zie COleControlContainer::AttachControlSite voor meer informatie over het maken van aangepaste sites.

COccManager::CreateDlgControls

Roep deze functie aan om ActiveX-besturingselementen te maken die zijn opgegeven door de 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);

Parameterwaarden

pWndParent
Een aanwijzer naar het bovenliggende element van het dialoogvensterobject.

lpszResourceName
De naam van de resource die wordt gemaakt.

pOccDialogInfo
Een aanwijzer naar de dialoogvenstersjabloon die wordt gebruikt om het dialoogvensterobject te maken.

lpResource
Een aanwijzer naar een resource.

Retourwaarde

Niet-nul als het besturingselement is gemaakt; anders nul.

COccManager::CreateSite

Aangeroepen door het framework om een beheersite te maken, gehost door de container die wordt verwezen door pCtrlCont.

virtual COleControlSite* CreateSite(COleControlContainer* pCtrlCont);

Parameterwaarden

pCtrlCont
Een aanwijzer naar de besturingscontainer die als host fungeert voor de nieuwe beheersite.

Retourwaarde

Een aanwijzer naar de zojuist gemaakte besturingssite.

Opmerkingen

Overschrijf deze functie om een aangepaste besturingssite te maken met behulp van uw COleControlSite-afgeleide klasse.

Elke besturingscontainer kan meerdere sites hosten. Maak extra sites met meerdere aanroepen naar CreateSite.

COccManager::GetDefBtnCode

Roep deze functie aan om te bepalen of het besturingselement een standaardknop is.

static DWORD AFX_CDECL GetDefBtnCode(CWnd* pWnd);

Parameterwaarden

pWnd
Het vensterobject met het knop besturingselement.

Retourwaarde

Een van de volgende waarden:

  • DLGC_DEFPUSHBUTTON Control is de standaardknop in het dialoogvenster.

  • DLGC_UNDEFPUSHBUTTON Control is niet de standaardknop in het dialoogvenster.

  • 0 Control is geen knop.

COccManager::IsDialogMessage

Aangeroepen door het framework om te bepalen of een bericht is bedoeld voor het opgegeven dialoogvenster en, als dat het is, het bericht verwerkt.

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

Parameterwaarden

pWndDlg
Een aanwijzer naar het beoogde doeldialoogvenster van het bericht.

lpMsg
Een aanwijzer naar een MSG structuur die het bericht bevat dat moet worden gecontroleerd.

Retourwaarde

Niet-nul als het bericht wordt verwerkt; anders nul.

Opmerkingen

Het standaardgedrag is IsDialogMessage om te controleren op toetsenbordberichten en deze te converteren naar selecties voor het bijbehorende dialoogvenster. Wanneer u bijvoorbeeld op tab drukt, selecteert u het volgende besturingselement of de volgende groep besturingselementen.

Overschrijf deze functie om aangepast gedrag te bieden voor berichten die naar het opgegeven dialoogvenster worden verzonden.

COccManager::IsLabelControl

Roep deze functie aan om te bepalen of het opgegeven besturingselement een label besturingselement is.

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

Parameterwaarden

pWnd
Een aanwijzer naar het venster met het besturingselement.

Retourwaarde

Niet-nul als het besturingselement een label is; anders nul

Opmerkingen

Een labelbesturingselement is een besturingselement dat fungeert als een label voor elk besturingselement dat de volgende is in de volgorde.

COccManager::IsMatchingMnemonic

Roep deze functie aan om te bepalen of de huidige nemonische overeenkomsten zijn die worden vertegenwoordigd door het besturingselement.

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

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

Parameterwaarden

pWnd
Een aanwijzer naar het venster met het besturingselement.

lpMsg
Een aanwijzer naar het bericht met de nemonic die overeenkomt.

Retourwaarde

Nonzero als de nemonic overeenkomt met het besturingselement; anders nul

Opmerkingen

COccManager::OnEvent

Aangeroepen door het framework om de opgegeven gebeurtenis te verwerken.

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

Parameterwaarden

pCmdTarget
Een aanwijzer naar het CCmdTarget object dat de gebeurtenis probeert te verwerken

idCtrl
De resource-id van het besturingselement.

pEvent
De gebeurtenis die wordt verwerkt.

pHandlerInfo
Als dat niet NULL is, OnEvent vult u de pTarget en pmf leden van de AFX_CMDHANDLERINFO structuur in in plaats van de opdracht te verzenden. Deze parameter moet doorgaans NULL zijn.

Retourwaarde

Niet-nul als de gebeurtenis is verwerkt, anders nul.

Opmerkingen

Overschrijf deze functie om het standaardproces voor gebeurtenisafhandeling aan te passen.

COccManager::P reCreateDialog

Wordt aangeroepen door het framework voor het verwerken van een dialoogvenstersjabloon voor ActiveX-besturingselementen voordat u het daadwerkelijke dialoogvenster maakt.

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

Parameterwaarden

pOccDialogInfo
Een _AFX_OCC_DIALOG_INFO structuur met informatie over de dialoogvenstersjabloon en alle ActiveX-besturingselementen die worden gehost door het dialoogvenster.

pOrigTemplate
Een aanwijzer naar de dialoogvenstersjabloon die moet worden gebruikt bij het maken van het dialoogvenster.

Retourwaarde

Een aanwijzer naar een dialoogvenstersjabloonstructuur die wordt gebruikt om het dialoogvenster te maken.

Opmerkingen

Het standaardgedrag roept een aanroep uit, SplitDialogTemplatebepaalt of er ActiveX-besturingselementen aanwezig zijn en retourneert vervolgens de resulterende dialoogvenstersjabloon.

Overschrijf deze functie om het proces voor het maken van een dialoogvenster met ActiveX-besturingselementen aan te passen.

COccManager::P ostCreateDialog

Aangeroepen door het framework om geheugen vrij te maken dat is toegewezen voor de dialoogvenstersjabloon.

virtual void PostCreateDialog(_AFX_OCC_DIALOG_INFO* pOccDialogInfo);

Parameterwaarden

pOccDialogInfo
Een _AFX_OCC_DIALOG_INFO structuur met informatie over de dialoogvenstersjabloon en alle ActiveX-besturingselementen die worden gehost door het dialoogvenster.

Opmerkingen

Dit geheugen is toegewezen door een aanroep aan SplitDialogTemplateen is gebruikt voor gehoste ActiveX-besturingselementen in het dialoogvenster.

Overschrijf deze functie om het proces voor het opschonen van resources die door het dialoogvensterobject worden gebruikt, aan te passen.

COccManager::SetDefaultButton

Roep deze functie aan om het besturingselement in te stellen als de standaardknop.

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

Parameterwaarden

pWnd
Een aanwijzer naar het venster met het besturingselement.

bDefault
Niet-nul als het besturingselement de standaardknop moet worden; anders nul.

Retourwaarde

Niet-nul indien geslaagd; anders nul.

Opmerkingen

Opmerking

Voor het besturingselement moet de OLEMISC_ACTSLIKEBUTTON statusbit zijn ingesteld. Zie het OLEMISC-onderwerp in de Windows SDK voor meer informatie over OLEMISC-vlaggen.

COccManager::SplitDialogTemplate

Aangeroepen door het framework om de ActiveX-besturingselementen te splitsen van algemene dialoogvensterbesturingselementen.

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

Parameterwaarden

pTemplate
Een aanwijzer naar de dialoogvenstersjabloon die moet worden onderzocht.

ppOleDlgItems
Een lijst met aanwijzers naar dialoogvensteritems die ActiveX-besturingselementen zijn.

Retourwaarde

Een aanwijzer naar een dialoogvenstersjabloonstructuur met alleen niet-ActiveX-besturingselementen. Als er geen ActiveX-besturingselementen aanwezig zijn, wordt NULL geretourneerd.

Opmerkingen

Als er ActiveX-besturingselementen worden gevonden, wordt de sjabloon geanalyseerd en wordt er een nieuwe sjabloon gemaakt die alleen niet-ActiveX-besturingselementen bevat. ActiveX-besturingselementen die tijdens dit proces worden gevonden, worden toegevoegd aan ppOleDlgItems.

Als de sjabloon geen ActiveX-besturingselementen bevat, wordt NULL geretourneerd .

Opmerking

Geheugen toegewezen voor de nieuwe sjabloon wordt vrijgemaakt in de PostCreateDialog functie.

Overschrijf deze functie om dit proces aan te passen.

Zie ook

Hiërarchiegrafiek
COleControlSite-klasse
COleControlContainer-klasse

  • Last updated on