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對象