Partilhar via


Classe CRichEditDoc

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Com o CRichEditView e o CRichEditCntrItem, fornece a funcionalidade do controlo de edição enriquecido no contexto da arquitetura de visualização de documentos do MFC.

Sintaxe

class CRichEditDoc : public COleServerDoc

Membros

Métodos Públicos

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

Membros de Dados Públicos

Nome Description
CRichEditDoc::m_bRTF Indica se a I/O do fluxo deve incluir formatação.

Observações

Um "controlo de edição enriquecido" é uma janela onde o utilizador pode inserir e editar texto. O texto pode ser atribuído a formatação de caracteres e parágrafos, e pode incluir objetos OLE incorporados. Os controlos de edição enriquecidos fornecem uma interface de programação para formatar texto. No entanto, um aplicativo deve implementar todos os componentes da interface do usuário necessários para disponibilizar operações de formatação para o usuário.

CRichEditView Mantém o texto e a formatação característicos do texto. CRichEditDoc mantém a lista dos itens do cliente que estão na visualização. CRichEditCntrItem fornece acesso do lado do contentor aos itens do cliente OLE.

Este controlo Windows Common (e, portanto, CRichEditCtrl e classes relacionadas) está disponível apenas para programas a correr sob Windows 95/98 e Windows NT versões 3.51 e posteriores.

Para um exemplo de utilização de um documento de edição enriquecida numa aplicação MFC, veja a aplicação de exemplo WORDPAD .

Hierarquia de herança

CObject

CCmdTarget

CDocument

COleDocument

COleLinkingDoc

COleServerDoc

CRichEditDoc

Requerimentos

Cabeçalho: afxrich.h

CRichEditDoc::CreateClientItem

Chame esta função para criar um CRichEditCntrItem objeto e adicione-o a este documento.

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

Parâmetros

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

Valor de retorno

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

Observações

Esta função não realiza qualquer inicialização OLE.

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

CRichEditDoc::GetStreamFormat

Chame esta função para determinar o formato de texto para transmitir o conteúdo da edição rica.

int GetStreamFormat() const;

Valor de retorno

Uma das seguintes bandeiras:

  • SF_TEXT Indica que o controlo de edição enriquecida não mantém informação de formatação.

  • SF_RTF Indica que o controlo de edição rica mantém a informação de formatação.

Observações

O valor de retorno baseia-se no m_bRTF membro de dados. Esta função devolve SF_RTF se m_bRTF for VERDADEIRA; caso contrário, SF_TEXT.

CRichEditDoc::GetView

Chame esta função para aceder ao objeto CRichEditView associado a este CRichEditDoc objeto.

virtual CRichEditView* GetView() const;

Valor de retorno

Apontar para o CRichEditView objeto associado ao documento.

Observações

O texto e a informação de formatação estão contidos no CRichEditView objeto. O CRichEditDoc objeto mantém os itens OLE para serialização. Deveria haver apenas um CRichEditView para cada CRichEditDoc.

CRichEditDoc::m_bRTF

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

BOOL m_bRTF;

Consulte também

Exemplo de WORDPAD MFC
Classe COleServerDoc
Gráfico de Hierarquia
Classe CRichEditView
Classe CRichEditCntrItem
COleDocument Classe
Classe CRichEditCtrl