Clase CDocTemplate

Artículo
04/10/2013

Una clase abstracta que define la funcionalidad básica para las plantillas de documento.

class CDocTemplate : public CCmdTarget

Members

Constructores protegidos

Name	Descripción
CDocTemplate::CDocTemplate	Crea un objeto CDocTemplate.

Métodos públicos

Name	Descripción
CDocTemplate::AddDocument	Agrega un documento a una plantilla.
CDocTemplate::CloseAllDocuments	Cierre todos los documentos asociados a esta plantilla.
CDocTemplate::CreateNewDocument	crea un nuevo documento.
CDocTemplate::CreateNewFrame	Crea una nueva ventana de marco que contiene un documento y una vista.
CDocTemplate::CreateOleFrame	Crea una ventana OLE- habilitada de marco.
CDocTemplate::CreatePreviewFrame	Crea un marco secundario utilizado para la vista previa enriquecidas.
CDocTemplate::GetDocString	Recupera una cadena asociado al tipo de documento.
CDocTemplate::GetFirstDocPosition	Recupera la posición del primer documento asociado a esta plantilla.
CDocTemplate::GetNextDoc	Recupera un documento y la posición del siguiente.
CDocTemplate::InitialUpdateFrame	Inicializa la ventana de marco, y opcionalmente hace visible.
CDocTemplate::LoadTemplate	Carga los recursos para CDocTemplate o una clase derivada especificado.
CDocTemplate::MatchDocType	determina el grado de confianza en la coincidencia entre un tipo de documento y esta plantilla.
CDocTemplate::OpenDocumentFile	Abra un archivo especificado por un nombre de ruta de acceso.
CDocTemplate::RemoveDocument	Quita un documento de una plantilla.
CDocTemplate::SaveAllModified	Guarda todos los documentos asociados a esta plantilla se hayan modificado.
CDocTemplate::SetContainerInfo	Determina los recursos para los contenedores de OLE al editar un elemento OLE en contexto.
CDocTemplate::SetDefaultTitle	Muestra el título predeterminado en la barra de título de la ventana de documento.
CDocTemplate::SetPreviewInfo	Configuración fuera del controlador de la vista previa.
CDocTemplate::SetServerInfo	Determina los recursos y las clases cuando se inserta el documento del servidor o en contexto editado.

Comentarios

Se suele crear una o más plantillas de documento en la implementación de la función de InitInstance de la aplicación.Una plantilla de documento define las relaciones entre tres tipos de clases:

Una clase de documento, que se deriva de CDocument.
Una clase de vista, que muestra los datos de la clase document enumerados anteriormente.Puede derivar esta clase de CView, de CScrollView, de CFormView, o de CEditView.(También puede usar CEditView directamente.)
Una clase de ventana de marco, que contiene la vista.Para una aplicación de (SDI) de interfaz de un único documento, derive esta clase de CFrameWnd.Para una aplicación de (MDI) de interfaz de múltiples documentos, derive esta clase de CMDIChildWnd.Si no necesita personalizar el comportamiento de la ventana de marco, puede utilizar CFrameWnd o CMDIChildWnd directamente sin derivar su propia clase.

La aplicación tiene una plantilla de documento para cada tipo de documento que admite.Por ejemplo, si la aplicación admite hojas de cálculo y documentos de texto, la aplicación tiene dos objetos de plantilla de documento.Cada plantilla de documento es responsable de crear y administrar todos los documentos de su tipo.

Plantilla de documento almacena punteros a objetos de CRuntimeClass para el documento, vista, y las clases de ventana de marco.Se especifican estos objetos de CRuntimeClass al crear una plantilla de documento.

Plantilla de documento contiene el id. de los recursos utilizados con el tipo de documento (como menú, icono, o recursos de la tabla de aceleradores).Plantilla de documento también tiene cadenas que contienen información adicional sobre el tipo de documento.Éstos incluyen el nombre de tipo de documento (por ejemplo, “hoja de cálculo”) y la extensión de archivo (por ejemplo, “.xls”).Opcionalmente, puede contener otras cadenas utilizadas por la interfaz de usuario de la aplicación, el administrador de archivos de Windows, y el objeto vinculando e insertar compatibilidad (OLE).

Si la aplicación es un contenedor o servidor OLE, plantilla de documento también define el id. de menú utilizado durante la activación en contexto.Si la aplicación es un servidor OLE, plantilla de documento define el id. de la barra de herramientas y del menú utilizados durante la activación en contexto.Especifique estos recursos de OLE adicionales llamando SetContainerInfo y SetServerInfo.

Dado que CDocTemplate es una clase abstracta, no puede usar la clase directamente.Una aplicación típica utiliza uno de dos CDocTemplate- clases derivadas proporcionadas por la biblioteca Microsoft Foundation Class: CSingleDocTemplate, que implementa el SDI, y CMultiDocTemplate, que implementa MDI.Vea esas clases para obtener más información sobre cómo utilizar las plantillas de documento.

Si la aplicación requiere un paradigma de la interfaz de usuario que es fundamentalmente diferente SDI o MDI, puede derivar su propia clase de CDocTemplate.

Para obtener más información sobre CDocTemplate, vea Plantillas de documento y el proceso de Creación de documentos y vistas.