MFC Library Reference Using CRichEditCtrl
(http://sobar.soso.com/tie/7576199.html)
rich edit控件是用戶(hù)能夠輸入和編輯文本的窗口。文本能被指定字符和段落格式，并且也能包含嵌入式OLE對象。rich edit控件在MFC中通過(guò)CRichEditCtrl類(lèi)描繪。
關(guān)于哪些你想知道更多？
RichEdit控件概述
如果你在對話(huà)框中使用richedit控件（不管你的程序是SDI，MDI，還是基本對話(huà)框），你必須在對話(huà)框顯示之前調用AfxInitRichEdit一次。調用此函數的典型位置在你的程序的InitInstance成員函數中。你不必每次顯示對話(huà)框時(shí)調用它，僅僅第一次就可以了。如果你使用CRichEditView你不必調用AfxInitRichEdit.
Richedit控件（CRichEditCtrl）為格式化文本提供程序接口。然而，一個(gè)程序必須實(shí)現任一用戶(hù)接口組件，這個(gè)組件對于用戶(hù)格式化操作可用是必要的。那就是，Richedit控件支持選定文本的字符或段落屬性的改變。字符屬性的一些例子就是黑粗體，斜體，字體系列，和點(diǎn)大小。段落屬性的例子如對齊，頁(yè)邊空白，和移字鍵（英文原文：tab stops.表示在richedit中按下tab鍵光標會(huì )移動(dòng)一段距離）。然而，這是給你提供的用戶(hù)接口，不管那是一個(gè)工具條按鈕，菜單項，或是一個(gè)格式化字符對話(huà)框。也有函數對目前選擇查詢(xún)r(jià)ichedit控件。使用這些函數顯示當前屬性設置，比如，設置一個(gè)選定標記在用戶(hù)接口上，如果當前選擇是黑粗體字符格式屬性。
參見(jiàn)CharacterFomatting和paragraph formatting查看更多字符段落格式化信息。
rich edit控件支持幾乎所有多行編輯控件( multiline editcontrols)的操作和通知消息。因此,使用EDIT控件的應用程序很容易的變換為使用RICHEDIT控件。附加的消息和通知(notifications)能使程序訪(fǎng)問(wèn)richedit的其它特性。參看CEdit查看編輯控件消息。
與rich edit控件有關(guān)的類(lèi)
CRichEditView,CRichEditDoc, 和 CRichEditCntrItem類(lèi)提供在MFC的文檔/視圖結構環(huán)境內的RICHEDIT控件的功能。CRichEditView保持著(zhù)文本和文本的格式化特性。CRichEditDoc保持著(zhù)視圖中OLE客戶(hù)項的序列。CRichEditCntrItem提供對OLE客戶(hù)項的container-side訪(fǎng)問(wèn)。要修改CRichEditView內容，使用CRichEditView::GetRichEditCtrl
Rich Edit Control例子
一個(gè)MFC OLE例子，“寫(xiě)字板”，使用CRichEditView, CRichEditDoc, and CRichEditCntrItem 類(lèi)。具體講是它使用CRichEditCtrl.
Character Formatting in Rich Edit Controls
你能使用CRichEditCtrl成員函數來(lái)格式化字符和檢索格式化信息。對于字符，你能指定字體，尺寸，顏色，和效果比如黑粗體，斜體，以及受保護的（protected)。
通過(guò)使用 SetSelectionCharFormat and SetWordCharFormat成員函數你能應用字符格式化。為確定當前所選文本字符格式化，使用GetSelectionCharFormat 成員函數。 CHARFORMAT結構用于指定字符屬性的成員函數。CHARFORMAT中一個(gè)重要的成員是dwMask。在SetSelectionCharFormat和SetWordCharFormat中，通過(guò)函數調dwMask指定哪種字符屬性將被設置。GetSelectionCharFormat記述選定內容中第一個(gè)字符的屬性;dwMask指定整個(gè)選定內容中屬性是一致的。
你也能取得和設置“默認字符格式化”（這種格式化也應用到后來(lái)所插入的字符中）。比如你的程序設置默認默認字符格式化為粗體，然后用戶(hù)輸入一個(gè)字符，這個(gè)字符是粗體字。取得和設置默認字符屬性，使用 GetDefaultCharFormat and SetDefaultCharFormat。
“受保護”（protected)字體屬性不改變文本外觀(guān)。假如用戶(hù)嘗試修改受保護文本，rich editcontrol將會(huì )向父窗口發(fā)送一個(gè)EN_PROTECTED通知消息，這個(gè)消息通知父窗口來(lái)允許或阻止這個(gè)改變。為接收這個(gè)通知消息，你必須啟用它通過(guò)SetEventMask成員函數。For more information about the event mask, seeNotifications from a Rich Edit Control,
前景顏色是一個(gè)字符屬性，但背景顏色是rich edit control 屬性。要設置背景顏色，使用 SetBackgroundColor。
Paragraph Formatting in Rich Edit Controls
你能使用CRichEditCtrl來(lái)格式化段落和檢索格式化信息。段落格式化屬性包括對齊，tab stops（上有說(shuō)明），縮進(jìn)，和編號。
你能通過(guò)SetParaFormat來(lái)應用段落格式化。為確定當前所選文本的段落格式編排，使用GetParaFormat成員函數。PARAFORMAT結構為這些指定段落屬性的成員函數所使用。PARAFORMAT中一個(gè)重要的成員是dwMask.在SetParaFormat中，dwMask指定在函數調用中哪個(gè)段落屬性將被設置。GetParaFormat記述選定內容中第一個(gè)段落的屬性;dwMask指定選定內容中屬性是一致的。
Current Selection in a Rich Edit Control
用戶(hù)通過(guò)鼠標或鍵盤(pán)能夠選擇richedit控件中的文本。當前選擇就是所選擇的字符這個(gè)域，或是沒(méi)有字符被選擇時(shí)插入點(diǎn)的位置。應用程序能取得當前選定內容的信息，設置當前選定內容，確定什么時(shí)候當前選定內容發(fā)生改變，以及顯示或隱藏選定內容的突出顯示（highlight:比如像鼠標選中幾個(gè)字符時(shí)那種反相顯示，下同）。
為確定rich edit控件中當前選定的內容，使用GetSel成員函數。為設置當前選定內容，使用SetSel成員函數。CHARRANGE結構在指定字符范圍(就是你選定哪些字符這個(gè)范圍內）函數中使用。為檢索當前選定內容的信息，你能使用GetSelectionType成員函數。
默認情況下，richedit控件顯示和隱藏選定內容的突出顯示（highlight)當它取得和失去焦點(diǎn)時(shí)。任何時(shí)候通過(guò)使用HideSelection成員函數你能顯示和隱藏選定內容的highlight。例如，應用程序可能提供一個(gè)搜索對話(huà)框來(lái)在richedit控件中尋找文本。這個(gè)應用程序可能選擇配匹的文本而沒(méi)有關(guān)掉對話(huà)框，這種情況下它必須使用HideSelection來(lái)突出顯示選定內容。
要取得rich edit控件中的選定文本，使用GetSelText成員函數。文本被復制到指定的字符數組中。你必須確保數組足夠大以容納選定的文本加上NULL終止符。
你能通過(guò)FindText成員函數來(lái)搜尋rich edit控件中的一個(gè)字符串。FINDTEXTEX結構在那些指定文本搜尋范圍和要搜索的字符串的函數中使用。你也能指定例如這種選項——搜索是否區分大小寫(xiě)。
Word Breaks in Rich Edit Controls
rich edit控件調用函數稱(chēng)為"word breakprocedure“來(lái)尋找字與字間的間隔和確定哪兒能斷開(kāi)行（lines)。當執行自動(dòng)換行（word-wrap)操作時(shí)和當處理CTRL+LEFT和CTRL+RIGHT 鍵組合控件可以使用這個(gè)信息。應用程序能發(fā)送這個(gè)消息到rich edit控件來(lái)取代默認的word-breakprocedure,檢索word-break信息，和確定給定字符落到哪一行上。
Clipboard Operations in Rich Edit Controls
你的程序使用最佳的剪貼板格式或指定的剪貼板格式來(lái)把剪貼板上的內容粘貼到richedit控件上。你也能確定richedit控件是否能粘貼剪貼板格式。
通過(guò)使用Copy和Cut成員函數你能復制和剪切當前選定的內容。類(lèi)似的，通過(guò)使用Paste成員函數你也能將剪貼板上的內容粘貼到richedit控件上?？丶迟N第一個(gè)它所識別的可用的格式，這種格式可能是描述得最好的格式。
要粘貼指定的剪貼板格式，使用PasteSpecial成員函數。這個(gè)函數對于粘貼指定命令的程序是很用的，它能使用戶(hù)選擇剪貼板格式。你能使用CanPaste成員函數來(lái)確定所給的格式是不是控件所能辨識的。
你也能使用CanPaste來(lái)確定任一可用的剪貼板格式能否被rich edit控件所辨識。這個(gè)函數在OnInitMenuPopup操作是有用的。應用程序可能使它的粘貼命令可用或變灰，這個(gè)依賴(lài)于控件是否能粘貼任何可用格式。
rich edit控件注冊了兩種剪貼板格式：rich-text格式和一種稱(chēng)為RichEdit Text and Objects.應用程序通過(guò)RegisterClipboardFormat函數（指定CF_RTF和CF_RETEXTOBJ值)注冊這些格式。
Stream Operations in Rich Edit Controls
你能使用流（streams)來(lái)傳送數據進(jìn)入rich edit控件或從其中輸出。流由EDITSTREAM結構來(lái)定義，這個(gè)結構指定了一個(gè)緩沖區和一個(gè)應用程序定義的回調函數。
要讀取數據到rich edit控件中（也就是,數據進(jìn)入流（stream the data in)）,使用StreamIn成員函數?？丶貜驼{用應用程序定義的回調函數，這個(gè)函數每次傳送一部分數據到緩沖區中去。
要保存rich edit控件內容（那就是，數據輸出流(stream the data out)),使用StreamOut成員函數?？丶貜蛯?xiě)緩沖區，然后調用應用程序定義回調函數。每次調用時(shí)，回調函數保存緩沖區的內容。
注：緩沖區 buffer
Printing in Rich Edit Controls
你能告訴rich edit 控件為一個(gè)指定的設備提供輸出，例如打印機。You can also specify the output device for which a rich edit control formats its text.
要為指定設備格式化rich edit控件內的部分內容，使用FormatRange成員函數。The FORMATRANGE structureused with this function specifies the range of text to format as wellas the device context (DC) for the target device.
在為輸出設備格式化文本后，使用DisplayBand成員函數你能發(fā)送輸出到設備。通過(guò)重復使用FormatRange和DisplayBand，打印rich edit控件的程序能實(shí)現banding (Banding is division of output into smallerparts for printing purposes.)
使用SetTargetDevice成員函數指定目標設備對于rich edit控件格式化它的文本。這個(gè)函數對WYSIWYG(所見(jiàn)即所得）格式化是有用的，在這個(gè)格式化中程序決定文本的位置使用默認打印機字體以替代顯示器的。
Bottomless Rich Edit Controls
你的程序能調整rich edit 控件的大小作為必須的以致于它總是與他的內容尺寸相同。通過(guò)向他的父窗口發(fā)送EN_REQUESTRESIZE通知消息，rich edit控件支持這種所謂的"bottomless"函數功能性，無(wú)論什么時(shí)候他的內容尺寸發(fā)生改變.
當處理EN_REQUESTRESIZE通知消息時(shí)，程序應該調整控件為REQRESIZE結構里的大小。程序可能也傳送控件附近的信息來(lái)調節控件垂直方向上的改變。為調整控件大小，你可以使用CWnd函數SetWindowPos.
你能使bottomless rich edit控件發(fā)送EN_REQUESTRESIZE通知消息通過(guò)使用RequsetResize成員函數。這個(gè)消息在OnSize操作中是很有用的。
為接收EN_REQUSETRESIZE通知消息，你必須啟用通知通過(guò)使用SetEventMask成員函數。
