Поделиться через


Класс CRichEditDoc

С помощью CRichEditView и CRichEditCntrItem предоставляет функциональные возможности элемента управления расширенными изменениями в контексте архитектуры представления документов MFC.

Синтаксис

class CRichEditDoc : public COleServerDoc

Участники

Открытые методы

Имя Описание
CRichEditDoc::CreateClientItem Вызывается для очистки документа.
CRichEditDoc::GetStreamFormat Указывает, должны ли входные и выходные данные потока включать сведения о форматировании.
CRichEditDoc::GetView Извлекает связанный объект CRichEditView .

Открытые члены данных

Имя Описание
CRichEditDoc::m_bRTF Указывает, должен ли поток ввода-вывода включать форматирование.

Замечания

Элемент управления расширенными изменениями — это окно, в котором пользователь может ввести и изменить текст. Текст можно назначить символьным и абзацным форматированием и включать внедренные объекты OLE. Элементы управления расширенными изменениями предоставляют интерфейс программирования для форматирования текста. Однако приложение должно реализовать все компоненты пользовательского интерфейса, необходимые для обеспечения доступности операций форматирования для пользователя.

CRichEditView поддерживает характер текста и форматирования текста. CRichEditDoc поддерживает список клиентских элементов, которые находятся в представлении. CRichEditCntrItem предоставляет доступ на стороне контейнера к элементам клиента OLE.

Этот общий элемент управления Windows (и, следовательно , классы CRichEditCtrl и связанные с ним классы) доступен только для программ под управлением Windows 95/98 и Windows NT версии 3.51 и более поздних версий.

Пример использования полнофункционированного редактирования документа в приложении MFC см. в примере приложения WORDPAD .

Иерархия наследования

CObject

CCmdTarget

CDocument

COleDocument

COleLinkingDoc

COleServerDoc

CRichEditDoc

Требования

Заголовок: afxrich.h

CRichEditDoc::CreateClientItem

Вызовите эту функцию, чтобы создать CRichEditCntrItem объект и добавить его в этот документ.

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

Параметры

preo
Указатель на структуру REOBJECT , описывающую элемент OLE. Новый CRichEditCntrItem объект создается вокруг этого элемента OLE. Если преопустим значение NULL, новый клиентский элемент пуст.

Возвращаемое значение

Указатель на новый объект CRichEditCntrItem , добавленный в этот документ.

Замечания

Эта функция не выполняет инициализацию OLE.

Дополнительные сведения см . в структуре REOBJECT в пакете SDK для Windows.

CRichEditDoc::GetStreamFormat

Вызовите эту функцию, чтобы определить текстовый формат для потоковой передачи содержимого форматированного редактирования.

int GetStreamFormat() const;

Возвращаемое значение

Один из следующих флагов:

  • SF_TEXT Указывает, что элемент управления расширенными изменениями не поддерживает сведения о форматировании.

  • SF_RTF Указывает, что элемент управления расширенными изменениями поддерживает сведения о форматировании.

Замечания

Возвращаемое значение основано на элементе данных m_bRTF . Эта функция возвращает SF_RTF, если m_bRTF имеет значение TRUE; в противном случае SF_TEXT.

CRichEditDoc::GetView

Вызовите эту функцию для доступа к объекту CRichEditView, связанному с этим CRichEditDoc объектом.

virtual CRichEditView* GetView() const;

Возвращаемое значение

Указатель на объект, связанный CRichEditView с документом.

Замечания

В объекте содержатся сведения о тексте CRichEditView и форматировании. Объект CRichEditDoc поддерживает элементы OLE для сериализации. Для каждого должен CRichEditDocбыть только одинCRichEditView.

CRichEditDoc::m_bRTF

Если значение TRUE, указывает, что CRichEditCtrl::StreamIn и CRichEditCtrl::StreamOut должен хранить характеристики абзаца и форматирования символов.

BOOL m_bRTF;

См. также

Пример WORDPAD для MFC
Класс COleServerDoc
Диаграмма иерархии
Класс CRichEditView
Класс CRichEditCntrItem
Класс COleDocument
Класс CRichEditCtrl