CRichEditDoc 類別

發行項
08/04/2024

使用 CRichEditView 和 CRichEditCntrItem，提供 MFC 檔檢視架構內容中豐富編輯控制元件的功能。

語法

class CRichEditDoc : public COleServerDoc

成員

公用方法

名稱	描述
CRichEditDoc：：CreateClientItem	呼叫以執行檔的清除。
CRichEditDoc：：GetStreamFormat	指出數據流輸入和輸出是否應該包含格式資訊。
CRichEditDoc：：GetView	擷取相關聯的 CRichEditView 物件。

公用資料成員

名稱	描述
CRichEditDoc：：m_bRTF	指出數據流 I/O 是否應該包含格式設定。

備註

「豐富編輯控制項」是一個視窗，用戶可以在其中輸入和編輯文字。文字可以指派字元和段落格式，而且可以包含內嵌的 OLE 物件。豐富的編輯控制項提供格式化文字的程式設計介面。然而，應用程式必須實作所有必要的使用者介面元件，讓使用者能夠執行格式化作業。

CRichEditView 會維護文字和文字的格式特性。 CRichEditDoc 會維護檢視中的客戶端專案清單。 CRichEditCntrItem 提供 OLE 用戶端專案的容器端存取。

此 Windows 通用控件（因此 CRichEditCtrl 和相關類別）僅適用於在 Windows 95/98 和 Windows NT 3.51 版和更新版本下執行的程式。

如需在 MFC 應用程式中使用豐富編輯檔的範例，請參閱 WORDPAD 範例應用程式。

繼承階層架構

CRichEditDoc

需求

標頭： afxrich.h

CRichEditDoc：：CreateClientItem

呼叫此函式來建立 CRichEditCntrItem 物件，並將它新增至此檔。

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

參數

preo
描述 OLE 專案的 REOBJECT 結構的指標。這個 OLE 專案周圍會建構新的 CRichEditCntrItem 物件。如果 preo 為 NULL，則新的用戶端專案是空的。

傳回值

已新增至此檔的新 CRichEditCntrItem 物件的指標。

備註

此函式不會執行任何 OLE 初始化。

如需詳細資訊，請參閱 Windows SDK 中的 REOBJECT 結構。

CRichEditDoc：：GetStreamFormat

呼叫此函式，以判斷串流豐富編輯內容的文字格式。

int GetStreamFormat() const;

傳回值

下列其中一個旗標：

SF_TEXT 指出豐富的編輯控制件不會維護格式資訊。
SF_RTF 指出豐富的編輯控件會維護格式資訊。

備註

傳回值是以m_bRTF數據成員為基礎。如果 m_bRTF 為 TRUE，則此函式會傳回SF_RTF，否則為 SF_TEXT。

CRichEditDoc：：GetView

呼叫此函式以存取與此CRichEditDoc對象相關聯的 CRichEditView 物件。

virtual CRichEditView* GetView() const;

傳回值

CRichEditView與文件相關聯的對象指標。

備註

文字和格式資訊包含在物件內 CRichEditView 。物件 CRichEditDoc 會維護 OLE 專案以進行串行化。每個 CRichEditDoc應該只有一個 CRichEditView 。

CRichEditDoc：：m_bRTF

當為 TRUE 時，表示 CRichEditCtrl：：StreamIn 和 CRichEditCtrl：：StreamOut 應該儲存段落和字元格式特性。

BOOL m_bRTF;

另請參閱

MFC 範例 WORDPAD
COleServerDoc 類別
 階層架構圖表
 CRichEditView 類別
 CRichEditCntrItem 類別
 COleDocument 類別
 CRichEditCtrl 類別

共用方式為