Clase CRichEditDoc

  • Artículo

Junto con CRichEditView y CRichEditCntrItem, proporciona la función del control de edición enriquecida en el contexto de la arquitectura de vista de documentos de MFC.

Sintaxis

class CRichEditDoc : public COleServerDoc

Miembros

Métodos públicos

Nombre Descripción
CRichEditDoc::CreateClientItem Se llama para realizar la limpieza del documento.
CRichEditDoc::GetStreamFormat Indica si la entrada y la salida del flujo deben incluir información de formato.
CRichEditDoc::GetView Recupera el objeto CRichEditView asociado.

Miembros de datos públicos

Nombre Descripción
CRichEditDoc::m_bRTF Indica si la E/S de secuencia debe incluir formato.

Comentarios

Un "control de edición enriquecida" es una ventana en la que el usuario puede escribir y editar texto. Al texto se le puede asignar un formato de caracteres y párrafos, y puede incluir objetos OLE insertados. Los controles de edición enriquecida proporcionan una interfaz de programación para dar formato al texto. Pero una aplicación debe implementar los componentes de la interfaz de usuario necesarios a fin de que las operaciones de formato estén disponibles para el usuario.

CRichEditView mantiene el texto y la característica de formato del texto. CRichEditDoc mantiene la lista de elementos de cliente que se encuentran en la vista. CRichEditCntrItem proporciona acceso del lado contenedor a los elementos de cliente OLE.

Este control común de Windows (y, por tanto, la clase CRichEditCtrl y relacionadas) solo está disponible para los programas que se ejecutan en Windows 95/98 y Windows NT 3.51, así como en versiones posteriores.

Para obtener un ejemplo de uso de un documento de edición enriquecida en una aplicación MFC, vea la aplicación de ejemplo WORDPAD.

Jerarquía de herencia

CObject

CCmdTarget

CDocument

COleDocument

COleLinkingDoc

COleServerDoc

CRichEditDoc

Requisitos

Encabezado: afxrich.h

CRichEditDoc::CreateClientItem

Llame a esta función para crear un objeto CRichEditCntrItem y agregarlo a este documento.

virtual CRichEditCntrItem* CreateClientItem(REOBJECT* preo = NULL) const = 0;

Parámetros

preo
Puntero a una estructura REOBJECT que describe un elemento OLE. El objeto CRichEditCntrItem nuevo se construye alrededor de este elemento OLE. Si preo es NULL, el elemento de cliente nuevo está vacío.

Valor devuelto

Puntero a un objeto CRichEditCntrItem nuevo que se ha agregado a este documento.

Comentarios

Esta función no realiza ninguna inicialización OLE.

Para más información, consulte la estructura REOBJECT en Windows SDK.

CRichEditDoc::GetStreamFormat

Llame a esta función para determinar el formato de texto a fin de transmitir el contenido de la edición enriquecida.

int GetStreamFormat() const;

Valor devuelto

Una de las siguientes marcas:

  • SF_TEXT indica que el control de edición enriquecida no mantiene la información de formato.

  • SF_RTF indica que el control de edición enriquecida mantiene la información de formato.

Comentarios

El valor devuelto se basa en el miembro de datos m_bRTF. Esta función devuelve SF_RTF si m_bRTF es TRUE; de lo contrario, devuelve SF_TEXT.

CRichEditDoc::GetView

Llame a esta función para acceder al objeto CRichEditView asociado a este objeto CRichEditDoc.

virtual CRichEditView* GetView() const;

Valor devuelto

Puntero al objeto CRichEditView asociado al documento.

Comentarios

El texto y la información de formato se encuentran en el objeto CRichEditView. El objeto CRichEditDoc mantiene los elementos OLE para la serialización. Solo debe haber un elemento CRichEditView para cada CRichEditDoc.

CRichEditDoc::m_bRTF

Cuando es TRUE, indica que CRichEditCtrl::StreamIn y CRichEditCtrl::StreamOut deben almacenar características de formato de párrafo y caracteres.

BOOL m_bRTF;

Consulte también

WORDPAD de ejemplo de MFC
COleServerDoc (clase)
Gráfico de jerarquías
CRichEditView (clase)
CRichEditCntrItem (clase)
COleDocument (clase)
CRichEditCtrl (clase)