CDocument Class

Artículo
06/10/2015

Proporciona la funcionalidad básica para las clases definidas por el usuario del documento.

class CDocument : public CCmdTarget

Members

Constructores públicos

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

Métodos públicos

Name	Descripción
CDocument::AddView	Adjunta una vista al documento.
CDocument::BeginReadChunks	Inicializa la lectura del fragmento.
CDocument::CanCloseFrame	Overridable avanzada; se llama antes de cerrar una ventana de marco que ve este documento.
CDocument::ClearChunkList	Borra la lista de fragmentos.
CDocument::ClearPathName	Borra la ruta de acceso del objeto de documento.
CDocument::DeleteContents	Denominado para realizar la limpieza del documento.
CDocument::FindChunk	Busca un fragmento con el GUID especificado.
CDocument::GetAdapter	Devuelve un puntero al objeto que implementa la interfaz de IDocument .
CDocument::GetDocTemplate	Devuelve un puntero a la plantilla de documento que describe el tipo de documento.
CDocument::GetFile	Devuelve un puntero al objeto deseado de CFile .
CDocument::GetFirstViewPosition	Devuelve la posición del primero en la lista de vistas; se utiliza para iniciar iteración.
CDocument::GetNextView	Recorre en iteración la lista de vistas asociado al documento.
CDocument::GetPathName	Devuelve la ruta de acceso del archivo del documento.
CDocument::GetThumbnail	Denominado para crear un mapa de bits que va a utilizar el proveedor de miniaturas para mostrar la miniatura.
CDocument::GetTitle	Devuelve el título del documento.
CDocument::InitializeSearchContent	Denominado para inicializar contenido de búsqueda para el controlador de búsqueda.
CDocument::IsModified	Indica si se ha modificado el documento desde que se guardó por última vez.
CDocument::IsSearchAndOrganizeHandler	Indica si esta instanciaCDocument del objeto se creó para la búsqueda y organizar el controlador.
CDocument::LoadDocumentFromStream	Denominado para cargar datos de la secuencia.
CDocument::OnBeforeRichPreviewFontChanged	Se llama antes de cambiar la fuente de vista previa enriquecidas.
CDocument::OnChangedViewList	Se llama después de que una vista se agregue a o se quite del documento.
CDocument::OnCloseDocument	denominado para cerrar el documento.
CDocument::OnCreatePreviewFrame	Llamado por el marco cuando necesita crear un cuadro de vista previa para la vista previa enriquecidas.
CDocument::OnDocumentEvent	Llamado por el marco en respuesta a un evento de documento.
CDocument::OnDrawThumbnail	Invalide este método en una clase derivada para dibujar el contenido de miniaturas.
CDocument::OnLoadDocumentFromStream	Llamado por el marco cuando necesita cargar los datos de la secuencia.
CDocument::OnNewDocument	denominado para crear un nuevo documento.
CDocument::OnOpenDocument	denominado para abrir un documento existente.
CDocument::OnPreviewHandlerQueryFocus	Indica al controlador preview devolver el HWND de llamar a la función de GetFocus.
CDocument::OnPreviewHandlerTranslateAccelerator	Indica al controlador preview controlar una pulsación de tecla última hacia arriba de suministro de mensajes del proceso en el que el controlador preview ejecuta.
CDocument::OnRichPreviewBackColorChanged	Se llama cuando el color de fondo de la vista previa enriquecidas ha cambiado.
CDocument::OnRichPreviewFontChanged	Llamado cuando la fuente de vista previa enriquecidas ha cambiado.
CDocument::OnRichPreviewSiteChanged	Se llama cuando el sitio de la vista previa enriquecidas ha cambiado.
CDocument::OnRichPreviewTextColorChanged	Se llama cuando el color del texto de la vista previa enriquecidas ha cambiado.
CDocument::OnSaveDocument	Denominado para guardar el documento en el disco.
CDocument::OnUnloadHandler	Llamado por el marco cuando se descarga el controlador preview.
CDocument::PreCloseFrame	Se llama antes de la ventana de marco se cierra.
CDocument::ReadNextChunkValue	Valor del siguiente fragmento de las lecturas.
CDocument::ReleaseFile	Libere un archivo para que quede disponible para su uso en otras aplicaciones.
CDocument::RemoveChunk	Quita un fragmento con el GUID especificado.
CDocument::RemoveView	Desasocia una vista en el documento.
CDocument::ReportSaveLoadException	Overridable avanzada; llamado cuando una operación abierto o de guardar no se puede completar debido a una excepción.
CDocument::SaveModified	Overridable avanzada; denominado para preguntar al usuario si el documento debe protegerse.
CDocument::SetChunkValue	Establece un valor de fragmento.
CDocument::SetModifiedFlag	Establece una marca que indica que se ha modificado el documento desde que fue guardado por última vez.
CDocument::SetPathName	Establece la ruta de acceso del archivo de datos utilizado por el documento.
CDocument::SetTitle	Establece el título del documento.
CDocument::UpdateAllViews	Notifica a todas las vistas que se ha modificado el documento.

Métodos protegidos

Name	Descripción
CDocument::OnFileSendMail	Envía un mensaje de correo con el documento asociado.
CDocument::OnUpdateFileSendMail	Habilita el comando de correo Send si la compatibilidad de correo está presente.

Miembros de datos públicos

Name	Descripción
CDocument::m_bGetThumbnailMode	Especifica que el objeto de CDocument creó el dllhost para las miniaturas. Debe protegerse CView::OnDraw.
CDocument::m_bPreviewHandlerMode	Especifica que el objeto de CDocument creó el prevhost para Rich Preview. Debe protegerse CView::OnDraw.
CDocument::m_bSearchMode	Especifica que el objeto de CDocument creó el indizador u otra aplicación de búsqueda.
CDocument::m_clrRichPreviewBackColor	Especifica el color de fondo de la ventana de vista previa enriquecidas. este color es establecido por el host.
CDocument::m_clrRichPreviewTextColor	Especifica el color de primer plano de la ventana de vista previa enriquecidas. este color es establecido por el host.
CDocument::m_lfRichPreviewFont	Especifica la fuente de texto de la ventana de vista previa enriquecidas. Esta información de fuentes establecida por el host.

Comentarios

Un documento representa la unidad de datos que el usuario abre normalmente con el comando para Abrir archivos y guarda con el comando para guardar archivos.

CDocument admite operaciones estándar como crear un documento, cargarlo, y guardarlo. El marco manipular documentos mediante la interfaz definida por CDocument.

Una aplicación puede admitir más de un tipo de documento; por ejemplo, una aplicación podría admitir las hojas de cálculo y documentos de texto. Cada tipo de documento tiene una plantilla de documento asociado; plantilla de documento especifica qué recursos (por ejemplo, menú, icono, o tabla de aceleradores) se utilizan para ese tipo de documento. Cada documento contiene un puntero al objeto asociado de CDocTemplate .

Los usuarios interactúan con un documento a través de los objetos de CView asociado. Una vista representa una imagen del documento en una ventana de marco e interpreta los datos proporcionados por el usuario como operaciones en el documento. Un documento puede tener varias vistas asociado. Cuando el usuario abre una ventana en un documento, el marco de trabajo crea una vista y la agrega al documento. Plantilla de documento especifica lo que utilizan el tipo de ventana de la vista y el cuadro para mostrar cada tipo de documento.

Los documentos son parte de enrutamiento estándar del marco y por consiguiente reciben comandos de los componentes de la interfaz de usuario estándar (como el elemento de menú para guardar archivos). un documento recibe los comandos reenviados por la vista activa. Si el documento no controla un comando determinado, transmite el comando plantilla de documento que lo administra.

Cuando se modifican los datos de un documento, cada una de sus vistas debe reflejar esos cambios. CDocument proporciona la función miembro de UpdateAllViews para que se notifique a las vistas de estos cambios, por lo que las vistas pueden representar según sea necesario. El marco de trabajo también pide al usuario guardar un archivo modificado antes de cerrarlo.

Para implementar documentos en una aplicación típica, debe hacer lo siguiente:

Derive una clase de CDocument para cada tipo de documento.
Agregue las variables miembro para almacenar los datos de cada documento.
El miembro de implemente funciones para leer y modificar los datos del documento. Las vistas de documento son los usuarios más importantes de estas funciones miembro.
Reemplace la función miembro de CObject:: serialice en la clase document para escribir y leer los datos del documento a y desde el disco.

CDocument admite el envío del documento mediante correo si la compatibilidad de correo (MAPI) está presente. consulte los artículos MAPI y Compatibilidad con MAPI en MFC.

Para obtener más información sobre CDocument, vea serialización, Temas de la arquitectura documento/vista, y Creación de documentos y vistas.