COleTemplateServer Class

Usado para servidores de edição visual OLE, servidores de automação e contêineres de link (aplicativos que dão suporte a links para incorporações).

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. Use COleTemplateServer ao implementar um servidor completo, ou seja, um servidor que pode ser executado como um aplicativo autônomo. Os servidores completos normalmente são vários aplicativos MDI (interface de documento), embora haja suporte para aplicativos SDI (interface de documento único). Um objeto COleTemplateServer é necessário para cada tipo de documento de servidor compatível com um aplicativo; ou seja, se o aplicativo para servidores dá suporte a planilhas e gráficos, você deve ter dois objetos COleTemplateServer.

COleTemplateServer substitui a função de membro OnCreateInstance definida por COleObjectFactory. Essa função de membro é chamada pela estrutura para criar um objeto C++ do tipo adequado.

Para mais informações sobre servidores, confira o artigo Servidores: como implementar um servidor.

Inheritance Hierarchy

CObject

CCmdTarget

COleObjectFactory

COleTemplateServer

Requirements

Header: afxdisp.h

COleTemplateServer::COleTemplateServer

Constrói um objeto COleTemplateServer.

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
Referência à ID da classe OLE que o modelo solicita.

pDocTemplate
Ponteiro para o modelo de documento.

bMultiInstance
Indica se uma só instância do aplicativo pode dar suporte a várias instanciações. Se TRUE, várias instâncias do aplicativo serão iniciadas para cada solicitação para criar um objeto.

Remarks

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

COleTemplateServer::Unregister

Cancela o registro do modelo de documento associado.

BOOL Unregister();

Return Value

TRUE se tiver êxito; caso contrário, FALSE.

COleTemplateServer::UpdateRegistry

Carrega informações de tipo de arquivo da cadeia de caracteres de modelo de documento e coloca essas informações no Registro do sistema OLE.

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

Parameters

nAppType
Um valor da enumeração OLE_APPTYPE, que é definido em AFXDISP.H. Pode ter qualquer um dos seguintes valores:

• OAT_INPLACE_SERVER O servidor tem interface de usuário completa do servidor.

• OAT_SERVER O servidor dá suporte apenas à inserção.

• OAT_CONTAINER O contêiner dá suporte a links para objetos inseridos.

• OAT_DISPATCH_OBJECT O objeto é capaz de IDispatch.

• OAT_DOC_OBJECT_SERVER O servidor dá suporte à inserção e ao modelo de componente objeto de documento.

rglpszRegister
Uma lista de entradas que serão gravadas no Registro somente se não existirem entradas.

rglpszOverwrite
Uma lista de entradas que serão gravadas no Registro independentemente de haver entradas anteriores.

bRegister
Determina se a classe deve ser registrada. If bRegister is TRUE, the class is registered with the system registry. Caso contrário, o registro da classe será cancelado.

Remarks

The registration information is loaded by means of a call to CDocTemplate::GetDocString. As substrings recuperadas são aquelas identificadas pelos índices regFileTypeId, regFileTypeName e fileNewName, conforme descrito nas páginas de referência GetDocString.

Se a substring regFileTypeId estiver vazia ou se a chamada a GetDocString falhar por qualquer outro motivo, essa função falhará e as informações do arquivo não serão inseridas no Registro.

The information in the arguments rglpszRegister and rglpszOverwrite is written to the registry through a call to AfxOleRegisterServerClass. As informações padrão, que são registradas quando os dois argumentos são NULL são adequadas para a maioria dos aplicativos. Para informações sobre a estrutura das informações nesses argumentos, confira AfxOleRegisterServerClass.

Para obter mais informações, confira Como implementar a interface IDispatch.

See also

HIERSVR de exemplo do MFC
COleObjectFactory Class
Hierarchy Chart
COleServerDoc Class
COleServerItem Class