Share via

COleTemplateServer-klasse

Opmerking

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

Wordt gebruikt voor OLE-visualbewerkingsservers, automatiseringsservers en koppelingscontainers (toepassingen die koppelingen naar insluitingen ondersteunen).

Syntax

class COleTemplateServer : public COleObjectFactory

Members

Openbare constructors

Name Description
COleTemplateServer::COleTemplateServer Maakt een COleTemplateServer-object.

Openbare methoden

Name Description
COleTemplateServer::ConnectTemplate Hiermee wordt een documentsjabloon verbonden met het onderliggende COleObjectFactory object.
COleTemplateServer::Unregister De registratie van de gekoppelde documentsjabloon ongedaan maken.
COleTemplateServer::UpdateRegistry Registreert het documenttype bij het OLE-systeemregister.

Remarks

Deze klasse is afgeleid van de klasse COleObjectFactory; meestal kunt u rechtstreeks gebruiken COleTemplateServer in plaats van uw eigen klas af te leiden. COleTemplateServer gebruikt een CDocTemplate-object om de serverdocumenten te beheren. Gebruik COleTemplateServer deze functie bij het implementeren van een volledige server, dat wil gezegd, een server die kan worden uitgevoerd als een zelfstandige toepassing. Volledige servers zijn doorgaans meerdere MDI-toepassingen (Document Interface), hoewel SDI-toepassingen (Single Document Interface) worden ondersteund. Er is één COleTemplateServer object nodig voor elk type serverdocument dat door een toepassing wordt ondersteund. Als uw servertoepassing zowel werkbladen als grafieken ondersteunt, moet u twee COleTemplateServer objecten hebben.

COleTemplateServer overschrijft de OnCreateInstance lidfunctie die is gedefinieerd door COleObjectFactory. Deze lidfunctie wordt aangeroepen door het framework om een C++-object van het juiste type te maken.

Zie het artikel Servers: Een server implementeren voor meer informatie over servers.

Overnamehiërarchie

CObject

CCmdTarget

COleObjectFactory

COleTemplateServer

Requirements

Koptekst: afxdisp.h

COleTemplateServer::COleTemplateServer

Maakt een COleTemplateServer-object.

COleTemplateServer();

Remarks

Zie het overzicht van de COleLinkingDoc-klasse voor een korte beschrijving van het gebruik van de COleTemplateServer klasse.

COleTemplateServer::ConnectTemplate

Hiermee verbindt u de documentsjabloon waarnaar wordt verwezen door pDocTemplate met het onderliggende COleObjectFactory-object .

void ConnectTemplate(
    REFCLSID clsid,
    CDocTemplate* pDocTemplate,
    BOOL bMultiInstance);

Parameters

clsid
Verwijzing naar de OLE-klasse-id die door de sjabloon wordt aangevraagd.

pDocTemplate
Aanwijzer naar de documentsjabloon.

bMultiInstance
Hiermee wordt aangegeven of één exemplaar van de toepassing meerdere instanties kan ondersteunen. Als WAAR is, worden meerdere exemplaren van de toepassing gestart voor elke aanvraag om een object te maken.

Remarks

Zie CLSID-sleutel in de Windows SDK voor meer informatie.

COleTemplateServer::Unregister

De registratie van de gekoppelde documentsjabloon ongedaan maken.

BOOL Unregister();

Retourwaarde

WAAR indien geslaagd; anders ONWAAR.

COleTemplateServer::UpdateRegistry

Laadt bestandsgegevens uit de documentsjabloontekenreeks en plaatst die informatie in het OLE-systeemregister.

void UpdateRegistry(
    OLE_APPTYPE nAppType = OAT_INPLACE_SERVER,
    LPCTSTR* rglpszRegister = NULL,
    LPCTSTR* rglpszOverwrite = NULL,
    BOOL bRegister = TRUE);

Parameters

nAppType
Een waarde uit de OLE_APPTYPE opsomming, die is gedefinieerd in AFXDISP.H. Het kan een van de volgende waarden hebben:

  • OAT_INPLACE_SERVER Server heeft de gebruikersinterface van de volledige server.

  • OAT_SERVER Server ondersteunt alleen insluiten.

  • OAT_CONTAINER Container ondersteunt koppelingen naar ingesloten objecten.

  • OAT_DISPATCH_OBJECT object is IDispatchgeschikt.

  • OAT_DOC_OBJECT_SERVER Server ondersteunt zowel insluiten als het onderdeelmodel documentobject.

rglpszRegister
Een lijst met vermeldingen die alleen in het register worden geschreven als er geen vermeldingen bestaan.

rglpszOverwrite
Een lijst met vermeldingen die in het register worden geschreven, ongeacht of er eerdere vermeldingen bestaan.

bRegister
Bepaalt of de klasse moet worden geregistreerd. Als bRegister TRUE is, wordt de klasse geregistreerd bij het systeemregister. Anders wordt de registratie van de klasse ongedaan maken.

Remarks

De registratiegegevens worden geladen door middel van een aanroep naar CDocTemplate::GetDocString. De opgehaalde subtekenreeksen zijn de subtekenreeksen die worden geïdentificeerd door de indexenregFileTypeIdregFileTypeName, enfileNewName, zoals beschreven in de GetDocString referentiepagina's.

Als de regFileTypeId subtekenreeks leeg is of als de aanroep om GetDocString een andere reden mislukt, mislukt deze functie en wordt de bestandsgegevens niet ingevoerd in het register.

De informatie in de argumenten rglpszRegister en rglpszOverwrite wordt naar het register geschreven via een aanroep naar AfxOleRegisterServerClass. De standaardinformatie, die wordt geregistreerd wanneer de twee argumenten NULL zijn, is geschikt voor de meeste toepassingen. Zie voor informatie over de structuur van de informatie in deze argumenten AfxOleRegisterServerClass.

Zie De IDispatch-interface implementeren voor meer informatie.

Zie ook

MFC-voorbeeld HIERSVR-
COleObjectFactory-klasse
Hiërarchiegrafiek
COleServerDoc-klasse
COleServerItem-klasse

  • Last updated on