Klasa COleTemplateServer

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

Składnia

class COleTemplateServer : public COleObjectFactory

Elementy członkowskie

Konstruktory publiczne

Metody publiczne

Uwagi

Ta klasa pochodzi z klasy COleObjectFactory. Zwykle można jej używać COleTemplateServer bezpośrednio, a nie wyprowadzać własnej klasy. COleTemplateServerużywa obiektu CDocTemplate do zarządzania dokumentami serwera. 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.

Hierarchia dziedziczenia

Obiekt CObject

CCmdTarget

COleObjectFactory

COleTemplateServer

Wymagania

Nagłówek: afxdisp.h

COleTemplateServer::COleTemplateServer

COleTemplateServer Tworzy obiekt.

COleTemplateServer();

Uwagi

Krótki opis użycia COleTemplateServer klasy można znaleźć w temacie COleLinkingDoc class overview (Omówienie klasy COleLinkingDoc ).

COleTemplateServer::ConnectTemplate

Łączy szablon dokumentu wskazywany przez element pDocTemplate z bazowym obiektem COleObjectFactory .

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

Parametry

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.

Uwagi

Aby uzyskać więcej informacji, zobacz CLSID Key in the Windows SDK (Klucz CLSID w zestawie WINDOWS SDK).

COleTemplateServer::Wyrejestrowywanie

Wyrejestrowuje skojarzony szablon dokumentu.

BOOL Unregister();

Wartość zwracana

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

Uwagi

EnterRemarks

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);

Parametry

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. Jeśli wartość bRegister ma wartość TRUE, klasa jest zarejestrowana w rejestrze systemowym. W przeciwnym razie wyrejestruje klasę.

Uwagi

Informacje o rejestracji są ładowane za pomocą wywołania metody 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.

Informacje w argumentach rglpszRegister i rglpszOverwrite są zapisywane w rejestrze za pomocą wywołania klasy 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.

Zobacz też

Przykład MFC HIERSVR
Klasa COleObjectFactory
Wykres hierarchii
Klasa COleServerDoc
Klasa COleServerItem