Compartir a través de


CDocument Class

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.

Jerarquía de herencia

CObject

CCmdTarget

CDocument

Requisitos

Encabezado: afxwin.h

Vea también

Referencia

CCmdTarget Class

Gráfico de jerarquías

CCmdTarget Class

CView (Clase)

CDocTemplate Class

Conceptos

ejemplo MDIDOCVW de MFC

ejemplo SNAPVW de MFC

NPP de ejemplo de MFC