CRichEditCtrl

一個“帶格式編輯控制項”是一個視窗，在這個視窗中用戶可以輸入和編輯文本。文本可以是字母或段落格式，也可以包括嵌入的OLE對象。帶格式編輯控制項為格式化文本提供了設計界面。但是，應用程式必須實現需要的用戶部件，以使格式化操作對用戶來說可用。

基本介紹

• 中文名：CRichEditCtrl
• 性質：帶格式編輯控制項
• 運行程式： Window95WindowsNT3.51更新版本
• 重點：必須調用AfxInitRichEdit一次

CRichEditCtrl

CObject

└CCmdTarget

└CWnd

└CRichEditCtrl

CRichEditCntr類提供了帶格式編輯控制項的功能。這個Windows通用控制項（也就是CRichEditCtrl類）只對於運行在Window95和Windows NT 3.51及更新版本下的程式是可用的。

重點

如果你正在使用一個對話框中的帶格式編輯控制項（不管你的應用程式是SDI，MDI，或是基於對話框的），你必須在顯示該對話框之前調用AfxInitRichEdit一次。通常是在你的應用程式的IniInstance成員函式中調用這個函式。你不用在每一次顯示這個對話框的時候都調用此AfxInitRichEdit函式，只要在第一次時調用它就可以了。如果你是在使用CRichEditView，則不用調用AfxInitRichEdit。

有關在一個MFC應用程式中使用帶格式編輯容器項的例子，請參見WORDPAD示例應用程式。

#include <afxcmn.h>

請參閱：CEdit, CRichEditView

CRichEditCtrl類成員

構造

CRichEditCtrl 構造一個CRichEditCtrl對象 Create創建Windows帶格式編輯控制項並將它與這個CRichEditCtrl對象相聯繫

行操作

GetLineCount獲取這個CRichEditCtrl對象中的行數目 GetLine從這個CRichEditCtrl對象中獲取一行文本 GetFirstVisibleLine確定這個CRichEditCtrl對象的最上面的可見行 LineIndex獲取此CRichEditCtrl對象中一個給定行的字元索引 LineFromChar確定是哪一行包含了給定字元 LineLength獲取此CRichEditCtrl對象中的給定行的長度 LineScroll在此CRichEditCtrl對象中滾動文本

選擇操作

Clear清除當前選擇 GetSel獲取此CRichEditCtrl對象中的當前選擇的開始和結束位置 SetSel設定此CRichEditCtrl對象中的選擇 GetSelText獲取此CRichEditCtrl對象中的當前選擇的文本 GetSelectionType獲取此CRichEditCtrl對象中的當前選擇中內容的類型 ReplaceSel用指定的文本替換此CRichEditCtrl對象中的當前選擇 HideSelection顯示或隱藏當前的選擇

格式化操作

GetDefaultCharFormat獲取此CRichEditCtrl對象中當前預設的字元格式屬性 SetDefaultCharFormat設定此CRichEditCtrl對象中的當前預設字元格式的屬性 GetSelectionCharFormat獲取此CRichEditCtrl對象中當前選擇的字元格式屬性 SetSelectionCharFormat設定此CRichEditCtrl對象中當前選擇的字元格式屬性 GetParaFormat獲取此CRichEditCtrl對象中的當前選擇的段落格式屬性 SetParaFormat設定此CRichEditCtrl對象中的當前選擇的段落格式屬性 SetWordCharFormat設定此CRichEditCtrl對象中的當前單詞的字元格式屬性

編輯操作

Undo取消最後一次編輯操作 CanUndo確定是否可以取消一次編輯操作 EmptyUndoBuffer重置（清除）此CRichEditCtrl對象的取消標誌 StreamIn將來自一個輸入流的文本插入此CRichEditCtrl對象中 StreamOut將來自此CRichEditCtrl對象的文本保存到輸出流中

一般操作

GetModify確定在最後一次保存後此CRichEditCtrl對象的內容是否已經被改變了 SetModify為這個CRichEditCtrl對象設定或清除修改標誌 FindText在這個CRichEditCtrl對象中定位文本 GetRect為此CRichEditCtrl對象獲取格式化矩形 SetRect為此CRichEditCtrl對象設定格式化矩形 GetCharPos確定此CRichEditCtrl對象中的一個給定字元的位置 SetOptions為這個CRichEditCtrl對象設定選項 SetReadOnly為這個CRichEditCtrl對象設定唯讀選項 GetTextLength獲取此CRichEditCtrl對象中的文本的長度 GetLimitText獲取一個用戶可以輸入這個CRichEditCtrl對象的文本數量的限制 LimitText限制一個用戶可以輸入此CRichEditCtrl對象的文本數量 GetEventMask獲取此CRichEditCtrl對象的事件掩碼 SetEventMask設定此CRichEditCtrl對象的事件掩碼 RequestResize強迫此CRichEditCtrl對象傳送請求改變大小的通知 SetBackgroundColor設定此CRichEditCtrl對象中的背景顏色 SetTargetDevice設定此CRichEditCtrl對象的目標輸出設備 FormatRange為目標輸出設備格式化一個文本範圍 DisplayBand顯示此CRichEditCtrl對象的一部分內容

剪貼簿操作

Copy將當前選項拷貝到剪貼簿上 Cut將存取選擇剪下到剪貼簿上 Paste剪貼簿上的內容插入到此帶格式編輯控制項中 PasteSpecial將剪貼簿上的內容按指定的數據格式插入到此帶格式編輯控制項中 CanPaste確定剪貼簿上的內容是否可以貼上到此帶格式編輯控制項中

OLE操作

GetIRichEditOle為此帶格式編輯控制項獲取一個指向IrichEdit Ole接口的指針 SetOLECallback為此帶格式編輯控制項設定IrichEditOleCallback COM對象