COleTemplateServer – třída

Používá se pro vizuální úpravy serverů OLE, automatizačních serverů a kontejnerů propojení (aplikace, které podporují odkazy na vkládání).

Syntaxe

class COleTemplateServer : public COleObjectFactory

Členové

Veřejné konstruktory

Jméno	popis
COleTemplateServer::COleTemplateServer	COleTemplateServer Vytvoří objekt.

Veřejné metody

Jméno	popis
COleTemplateServer::Připojení Template	Připojení šablonu dokumentu k podkladovému COleObjectFactory objektu.
COleTemplateServer::Unregister	Zruší registraci přidružené šablony dokumentu.
COleTemplateServer::UpdateRegistry	Zaregistruje typ dokumentu v systémovém registru OLE.

Poznámky

Tato třída je odvozena z třídy COleObjectFactory; obvykle můžete použít COleTemplateServer přímo místo odvození vlastní třídy. COleTemplateServer používá objekt CDocTemplate ke správě dokumentů serveru. Používá se COleTemplateServer při implementaci úplného serveru, tj. serveru, který lze spustit jako samostatnou aplikaci. Úplné servery jsou obvykle více aplikací rozhraní dokumentů (MDI), i když se podporují jedno rozhraní dokumentů (SDI). Pro každý typ dokumentu serveru je potřeba jeden COleTemplateServer objekt, který aplikace podporuje. To znamená, že pokud serverová aplikace podporuje listy i grafy, musíte mít dva COleTemplateServer objekty.

COleTemplateServer přepíše členovu OnCreateInstance funkci definovanou funkcí COleObjectFactory. Tato členová funkce je volána rozhraním k vytvoření objektu C++ správného typu.

Další informace o serverech naleznete v článku Servery: Implementace serveru.

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

COleObjectFactory

COleTemplateServer

Požadavky

Hlavička: afxdisp.h

COleTemplateServer::COleTemplateServer

COleTemplateServer Vytvoří objekt.

COleTemplateServer();

Poznámky

Stručný popis použití COleTemplateServer třídy naleznete v přehledu třídy COleLinkingDoc .

COleTemplateServer::Připojení Template

Připojení šablonu dokumentu, na kterou odkazuje pDocTemplate na podkladový objekt COleObjectFactory.

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

Parametry

Identifikátor clsid
Odkaz na ID třídy OLE, které šablona požaduje.

pDocTemplate
Ukazatel na šablonu dokumentu

bMultiInstance
Určuje, jestli může jedna instance aplikace podporovat více instancí. Pokud je hodnota TRUE, pro každý požadavek se spustí více instancí aplikace, aby se vytvořil objekt.

Poznámky

Další informace najdete v tématu KLÍČ CLSID v sadě Windows SDK.

COleTemplateServer::Unregister

Zruší registraci přidružené šablony dokumentu.

BOOL Unregister();

Vrácená hodnota

TRUE v případě úspěchu; jinak NEPRAVDA.

Poznámky

EnterRemarks

COleTemplateServer::UpdateRegistry

Načte informace o typu souboru z řetězce šablony dokumentu a umístí je do systémového registru OLE.

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

Parametry

nAppType
Hodnota z OLE_APPTYPE výčtu, která je definována v AFXDISP.H. Může mít některou z následujících hodnot:

• OAT_INPLACE_SERVER Server má úplné uživatelské rozhraní serveru.

• OAT_SERVER Server podporuje pouze vkládání.

• OAT_CONTAINER Container podporuje odkazy na vložené objekty.

• OAT_DISPATCH_OBJECT Objekt je IDispatchschopný.

• OAT_DOC_OBJECT_SERVER Server podporuje vkládání i model komponent Document Object.

rglpszRegister
Seznam položek, které jsou zapsány do registru pouze v případě, že neexistují žádné položky.

rglpszOverwrite
Seznam položek, které jsou zapsány do registru bez ohledu na to, zda existují jakékoli předchozí položky.

bRegister
Určuje, zda má být třída registrována. Pokud je bRegister PRAVDA, třída je registrována v systémovém registru. V opačném případě zruší registraci třídy.

Poznámky

Informace o registraci se načtou prostřednictvím volání CDocTemplate::GetDocString. Načtené podřetětěce jsou ty, které jsou identifikovány indexy regFileTypeId, regFileTypeNamea fileNewName, jak je popsáno na GetDocString referenčních stránkách.

regFileTypeId Pokud je podřetězce prázdný nebo pokud volání selže GetDocString z nějakého jiného důvodu, tato funkce selže a informace o souboru nejsou zadané v registru.

Informace v argumentech rglpszRegister a rglpszOverwrite jsou zapsány do registru prostřednictvím volání AfxOleRegisterServerClass. Výchozí informace, které jsou registrovány, když jsou dva argumenty NULL, jsou vhodné pro většinu aplikací. Informace o struktuře informací v těchto argumentech naleznete v tématu AfxOleRegisterServerClass.

Další informace naleznete v tématu Implementace rozhraní IDispatch.

Viz také

MFC – Ukázka HIERSVR
COleObjectFactory – třída
Graf hierarchie
COleServerDoc – třída
COleServerItem – třída