COleTemplateServer Class

Służy do edytowania wizualizacji serwerów OLE, serwerów automatyzacji i łączenia kontenerów (aplikacje, które obsługują linki do osadzania).

Syntax

class COleTemplateServer : public COleObjectFactory

Members

Public Constructors

Public Methods

Remarks

This class is derived from the class COleObjectFactory; usually, you can use COleTemplateServer directly rather than deriving your own class. COleTemplateServer uses a CDocTemplate object to manage the server documents. Należy użyć COleTemplateServer podczas implementowania pełnego serwera, czyli serwera, który może być uruchamiany jako aplikacja autonomiczna. Pełne serwery są zwykle wieloma aplikacjami interfejsu dokumentów (MDI), chociaż obsługiwane są aplikacje interfejsu pojedynczego dokumentu (SDI). Jeden COleTemplateServer obiekt jest wymagany dla każdego typu dokumentu serwera obsługiwanego przez aplikację. Oznacza to, że jeśli aplikacja serwera obsługuje arkusze i wykresy, musisz mieć dwa COleTemplateServer obiekty.

COleTemplateServer zastępuje funkcję składową zdefiniowaną OnCreateInstance przez COleObjectFactoryelement . Ta funkcja składowa jest wywoływana przez platformę w celu utworzenia obiektu języka C++ odpowiedniego typu.

Aby uzyskać więcej informacji na temat serwerów, zobacz artykuł Serwery: implementowanie serwera.

Inheritance Hierarchy

CObject

CCmdTarget

COleObjectFactory

COleTemplateServer

Requirements

Header: afxdisp.h

COleTemplateServer::COleTemplateServer

COleTemplateServer Tworzy obiekt.

COleTemplateServer();

Remarks

For a brief description of the use of the COleTemplateServer class, see the COleLinkingDoc class overview.

COleTemplateServer::ConnectTemplate

Connects the document template pointed to by pDocTemplate to the underlying COleObjectFactory object.

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

Parameters

clsid
Odwołanie do identyfikatora klasy OLE, którego żąda szablon.

pDocTemplate
Wskaźnik do szablonu dokumentu.

bMultiInstance
Wskazuje, czy pojedyncze wystąpienie aplikacji może obsługiwać wiele wystąpień. Jeśli wartość TRUE, dla każdego żądania zostanie uruchomionych wiele wystąpień aplikacji w celu utworzenia obiektu.

Remarks

For more information, see CLSID Key in the Windows SDK.

COleTemplateServer::Unregister

Wyrejestrowuje skojarzony szablon dokumentu.

BOOL Unregister();

Return Value

Wartość TRUE, jeśli operacja zakończyła się pomyślnie; w przeciwnym razie FAŁSZ.

COleTemplateServer::UpdateRegistry

Ładuje informacje o typie pliku z ciągu szablonu dokumentu i umieszcza te informacje w rejestrze systemowym OLE.

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

Parameters

nAppType
Wartość z wyliczenia OLE_APPTYPE, która jest zdefiniowana w AFXDISP.H. Może mieć dowolną z następujących wartości:

• OAT_INPLACE_SERVER Server ma pełny interfejs użytkownika serwera.

• OAT_SERVER Server obsługuje tylko osadzanie.

• OAT_CONTAINER Container obsługuje łącza do obiektów osadzonych.

• obiekt OAT_DISPATCH_OBJECT jest IDispatchzdolny.

• OAT_DOC_OBJECT_SERVER Server obsługuje zarówno osadzanie, jak i model składnika Document Object.

rglpszRegister
Lista wpisów zapisywanych w rejestrze tylko wtedy, gdy nie istnieją żadne wpisy.

rglpszOverwrite
Lista wpisów zapisywanych w rejestrze niezależnie od tego, czy istnieją jakiekolwiek poprzednie wpisy.

bRegister
Określa, czy klasa ma być zarejestrowana. If bRegister is TRUE, the class is registered with the system registry. W przeciwnym razie wyrejestruje klasę.

Remarks

The registration information is loaded by means of a call to CDocTemplate::GetDocString. Pobrane podciągy są identyfikowane przez indeksy regFileTypeId, regFileTypeNamei fileNewName, zgodnie z opisem na stronach referencyjnych GetDocString .

regFileTypeId Jeśli podciąg jest pusty lub wywołanie nie powiedzie się GetDocString z jakiegokolwiek innego powodu, ta funkcja nie powiedzie się, a informacje o pliku nie są wprowadzane w rejestrze.

The information in the arguments rglpszRegister and rglpszOverwrite is written to the registry through a call to AfxOleRegisterServerClass. Informacje domyślne, które są rejestrowane, gdy dwa argumenty mają wartość NULL, są odpowiednie dla większości aplikacji. Aby uzyskać informacje na temat struktury informacji w tych argumentach, zobacz AfxOleRegisterServerClass.

Aby uzyskać więcej informacji, zobacz Implementowanie interfejsu IDispatch.

See also

Przykład MFC HIERSVR
COleObjectFactory Class
Hierarchy Chart
COleServerDoc Class
COleServerItem Class