Classe CRichEditDoc

Com a CRichEditView e a CRichEditCntrItem, ela fornece a funcionalidade de controle de edição avançada dentro do contexto da arquitetura de exibição de documento do MFC.

Sintaxe

class CRichEditDoc : public COleServerDoc

Membros

Métodos públicos

Nome	Descrição
CRichEditDoc::CreateClientItem	Chamado para executar a limpeza do documento.
CRichEditDoc::GetStreamFormat	Indica se a entrada e a saída do fluxo devem incluir informações de formatação.
CRichEditDoc::GetView	Recupera o objeto CRichEditView associado.

Membros de Dados Públicos

Nome	Descrição
CRichEditDoc::m_bRTF	Indica se a E/S do fluxo deve incluir a formatação.

Comentários

Um "controle de edição avançada" é uma janela na qual o usuário pode inserir e editar textos. O texto pode ser atribuído a formatação de caracteres e parágrafos e pode incluir objetos OLE incorporados. Os controles de edição avançada fornecem uma interface de programação para formatar texto. No entanto, um aplicativo deve implementar todos os componentes de interface do usuário necessários para disponibilizar operações de formatação para o usuário.

CRichEditView mantém a característica de texto e formatação do texto. CRichEditDoc mantém a lista de itens de clientes que estão na exibição. CRichEditCntrItem fornece acesso do lado do contêiner ao item do cliente OLE.

Esse controle Comum do Windows (e, portanto, o CRichEditCtrl e classes relacionadas) está disponível apenas para programas em execução nas versões 3.51 e posteriores do Windows 95/98 e Windows NT.

Para obter um exemplo de como usar um documento de edição avançada em um aplicativo MFC, consulte o aplicativo de exemplo WORDPAD.

Hierarquia de herança

CObject

CCmdTarget

CDocument

COleDocument

COleLinkingDoc

COleServerDoc

CRichEditDoc

Requisitos

Cabeçalho: afxrich.h

CRichEditDoc::CreateClientItem

Chame essa função para criar um objeto CRichEditCntrItem e adicioná-lo ao documento.

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

Parâmetros

preo
Ponteiro para uma estrutura REOBJECT que descreve um item OLE. O novo objeto CRichEditCntrItem é construído em torno deste item OLE. Se preo for NULL, o item do cliente estará vazio.

Valor de retorno

Ponteiro para um novo objeto CRichEditCntrItem que foi adicionado a este documento.

Comentários

Essa função não executa nenhuma inicialização OLE.

Para mais informações, confira a estrutura REOBJECT no SDK do Windows.

CRichEditDoc::GetStreamFormat

Chame essa função para determinar o formato de texto para transmitir o conteúdo da edição avançada.

int GetStreamFormat() const;

Valor de retorno

Um dos seguintes valores:

• SF_TEXT Indica que o controle de edição avançada não mantém informações de formatação.

• SF_RTF Indica que o controle de edição avançada mantém as informações de formatação.

Comentários

O valor retornado é baseado no membro de dados m_bRTF. Essa função retornará SF_RTF se m_bRTF for TRUE; caso contrário, SF_TEXT.

CRichEditDoc::GetView

Chame essa função para acessar o objeto CRichEditView associado a esse objeto CRichEditDoc.

virtual CRichEditView* GetView() const;

Valor de retorno

Um ponteiro para o objeto CRichEditView associado ao documento.

Comentários

As informações de texto e formatação estão contidas no objeto CRichEditView. O objeto CRichEditDoc mantém os itens OLE para serialização. Deve haver apenas um CRichEditView para cada CRichEditDoc.

CRichEditDoc::m_bRTF

Quando TRUE, indica que CRichEditCtrl::StreamIn e CRichEditCtrl::StreamOut devem armazenar características de parágrafo e formatação de caracteres.

BOOL m_bRTF;

Confira também

WORDPAD de exemplo do MFC
Classe COleServerDoc
Gráfico da hierarquia
Classe CRichEditView
Classe CRichEditCntrItem
Classe COleDocument
Classe CRichEditCtrl