MFC - 富文本编辑控件

Rich Edit 富文本编辑控件控件是用户可以在其中输入和编辑文本的窗口。文本可以指定字符和段落格式，并且可以包含嵌入的 OLE 对象。它由 CRichEditCtrl 类表示。

Here is the list of methods in CRichEditCtrl class.

序号	名称和描述
1	CanPaste 确定剪贴板的内容是否可以粘贴到此丰富的编辑控件中。
2	CanRedo 确定控件重做队列中是否有任何操作。
3	CanUndo 确定是否可以撤消编辑操作。
4	CharFromPos 检索有关编辑控件工作区中最接近指定点的字符的信息。
5	Clear 清除当前选择。
6	Copy 将当前选择复制到剪贴板。
7	Create 创建 Windows Rich Edit 控件并将其与此 CRichEditCtrl 对象关联。
8	CreateEx 使用指定的扩展 Windows 样式创建 Windows Rich Edit 控件，并将其与此 CRichEditCtrl 对象关联。
9	Cut 将当前选择剪切到剪贴板。
10	DisplayBand 显示此 CRichEditCtrl 对象的部分内容。
11	EmptyUndoBuffer 重置（清除）此 CRichEditCtrl 对象的撤消标志。
12	FindText 在此 CRichEditCtrl 对象中查找文本。
13	FindWordBreak 查找指定字符位置之前或之后的下一个分词符，或检索有关该位置处的字符的信息。
14	FormatRange 格式化目标输出设备的文本范围。
15	GetCharPos 确定给定字符在此 CRichEditCtrl 对象中的位置。
16	GetDefaultCharFormat 检索此 CRichEditCtrl 对象中当前默认的字符格式属性。
17	GetEventMask 检索此 CRichEditCtrl 对象的事件掩码。
18	GetFirstVisibleLine 确定此 CRichEditCtrl 对象中最上面的可见行。
19	GetIRichEditOle 检索指向此丰富编辑控件的 IRichEditOle 接口的指针。
20	GetLimitText 获取用户可以在此 CRichEditCtrl 对象中输入的文本量的限制。
21	GetLine 从此 CRichEditCtrl 对象检索一行文本。
22	GetLineCount 检索此 CRichEditCtrl 对象中的行数。
23	GetModify 确定此 CRichEditCtrl 对象的内容自上次保存以来是否已更改。
24	GetOptions 检索丰富的编辑控件选项。
25	GetParaFormat 检索此 CRichEditCtrl 对象中当前选择的段落格式属性。
26	GetPunctuation 检索 Rich Edit 控件的当前标点字符。此消息仅在亚洲语言版本的操作系统中可用。
27	GetRect 检索此 CRichEditCtrl 对象的格式矩形。
28	GetRedoName 检索控件重做队列中下一个操作（如果有）的类型。
29	GetSel 获取此 CRichEditCtrl 对象中当前选择的开始和结束位置。
30	GetSelectionCharFormat 检索此 CRichEditCtrl 对象中当前选择的字符格式属性。
31	GetSelectionType 检索此 CRichEditCtrl 对象中当前选择的内容类型。
32	GetSelText 获取此 CRichEditCtrl 对象中当前选择的文本。
33	GetTextLength 检索此 CRichEditCtrl 对象中文本的长度（以字符为单位）。不包括终止空字符。
34	GetTextLengthEx 检索丰富编辑视图中的字符或字节数。接受标志列表以指示确定丰富编辑控件中文本长度的方法。
35	GetTextMode 检索丰富编辑控件的当前文本模式和撤消级别。
36	GetTextRange 检索指定范围的文本。
37	GetUndoName 检索下一个撤消操作的类型（如果有）。
38	GetWordWrapMode 检索丰富编辑控件的当前自动换行和断字选项。此消息仅在亚洲语言版本的操作系统中可用。
39	HideSelection 显示或隐藏当前选择。
40	LimitText 限制用户可以输入 CRichEditCtrl 对象的文本量。
41	LineFromChar 确定哪一行包含给定字符。
42	LineIndex 检索此 CRichEditCtrl 对象中给定行的字符索引。
43	LineLength 检索此 CRichEditCtrl 对象中给定行的长度。
44	LineScroll 滚动此 CRichEditCtrl 对象中的文本。
45	Paste 将剪贴板的内容插入到此丰富的编辑控件中。
46	PasteSpecial 以指定的数据格式将剪贴板的内容插入到此丰富的编辑控件中。
47	PosFromChar 检索编辑控件中指定字符的客户区坐标。
48	Redo 重做控件重做队列中的下一个操作。
49	ReplaceSel 用指定文本替换此 CRichEditCtrl 对象中的当前选择。
50	RequestResize 强制此 CRichEditCtrl 对象发送请求调整大小通知。
51	SetAutoURLDetect 指示自动 URL 检测在 Rich Edit 控件中是否处于活动状态。
52	SetBackgroundColor 设置此 CRichEditCtrl 对象中的背景颜色。
53	SetDefaultCharFormat 设置此 CRichEditCtrl 对象中的当前默认字符格式属性。
54	SetEventMask 设置此 CRichEditCtrl 对象的事件掩码。
55	SetModify 设置或清除此 CRichEditCtrl 对象的修改标志。
56	SetOLECallback 为此丰富的编辑控件设置 IRichEditOleCallback COM 对象。
57	SetOptions 设置此 CRichEditCtrl 对象的选项。
58	SetParaFormat 设置此 CRichEditCtrl 对象中当前选择的段落格式属性。
59	SetPunctuation 设置 Rich Edit 控件的标点符号。此消息仅在亚洲语言版本的操作系统中可用。
61	SetReadOnly 设置此 CRichEditCtrl 对象的只读选项。
62	SetRect 为此 CRichEditCtrl 对象设置格式矩形。
63	SetSel 设置此 CRichEditCtrl 对象中的选择。
64	SetSelectionCharFormat 设置此 CRichEditCtrl 对象中当前选择的字符格式属性。
65	SetTargetDevice 设置此 CRichEditCtrl 对象的目标输出设备。
66	SetTextMode 设置丰富编辑控件的文本模式或撤消级别。如果控件包含文本，则消息失败。
67	SetUndoLimit 设置可存储在撤消队列中的最大操作数。
68	SetWordCharFormat 设置此 CRichEditCtrl 对象中当前单词的字符格式属性。
69	SetWordWrapMode 设置 Rich Edit 控件的自动换行和断字选项。此消息仅在亚洲语言版本的操作系统中可用。
70	StopGroupTyping 停止控件将其他键入操作收集到当前撤消操作中。控件将下一个键入操作（如果有）存储到撤消队列中的新操作中。
71	StreamIn 将输入流中的文本插入此 CRichEditCtrl 对象
72	StreamOut 将此 CRichEditCtrl 对象中的文本存储到输出流中。
73	Undo 撤消上次编辑操作。

这是 Rich Edit 控件的消息映射列表。

消息	映射条目	描述
EN_CHANGE	ON_EN_CHANGE( <id>, <memberFxn> )	用户执行的操作可能会更改编辑控件中的文本。
EN_ERRSPACE	ON_EN_ERRSPACE( <id>, <memberFxn> )	编辑控件无法分配足够的内存来满足特定请求。
EN_HSCROLL	ON_EN_HSCROLL( <id>, <memberFxn> )	用户单击编辑控件的水平滚动条。屏幕更新之前会通知父窗口。
EN_KILLFOCUS	ON_EN_KILLFOCUS( <id>, <memberFxn> )	编辑控件失去输入焦点。
MAXTEXT	ON_MAXTEXT( <id>, <memberFxn> )	当前插入内容超出了编辑控件指定的字符数，已被截断。
EN_SETFOCUS	ON_EN_SETFOCUS( <id>, <memberFxn> )	当编辑控件收到输入焦点时发送。
EN_UPDATE	ON_EN_UPDATE( <id>, <memberFxn> )	编辑控件即将显示更改后的文本。在控件格式化文本之后但在屏幕文本之前发送，以便可以根据需要更改窗口大小。
EN_VSCROLL	ON_EN_VSCROLL( <id>, <memberFxn> )	用户单击编辑控件的垂直滚动条。屏幕更新之前会通知父窗口。

让我们通过创建一个新的基于 MFC 对话框的应用程序来了解一个简单的示例。

步骤 1 − 删除 TODO 行并从工具箱中拖动一个 Rich Edit 控件和三个按钮。

步骤 2 − 将这三个按钮的标题从粗体、斜体和下划线分别更改为 IDC_BUTTON_BOLD、IDC_BUTTON_ITALIC 和 IDC_BUTTON_UNDERLINE。

步骤 3 − 将以下属性设置为 True:Multiline、Want Return、Vertical Scroll。

步骤 4 − 为 Rich Edit 控件添加控件变量 m_richEdit。

步骤 5 − 转到 CMFCRichEditApp 并调用 CMFCRichEditApp::InitInstance() 函数中的 ::AfxInitRichEdit2()，如以下代码所示。

BOOL CMFCRichEditApp::InitInstance() {
//TODO: call AfxInitRichEdit2() to initialize richedit2 library.
   // InitCommonControlsEx() is required on Windows XP if an application
   // manifest specifies use of ComCtl32.dll version 6 or later to enable
   // visual styles. Otherwise, any window creation will fail.
   INITCOMMONCONTROLSEX InitCtrls;
   InitCtrls.dwSize = sizeof(InitCtrls);
   // Set this to include all the common control classes you want to use
   // in your application.
   InitCtrls.dwICC = ICC_WIN95_CLASSES;
   InitCommonControlsEx(&InitCtrls);

   ::AfxInitRichEdit2();
   CWinApp::InitInstance();

   
   AfxEnableControlContainer();
   
   // Create the shell manager, in case the dialog contains
   // any shell tree view or shell list view controls.
   CShellManager *pShellManager = new CShellManager;

   // Activate "Windows Native" visual manager for enabling themes in MFC controls
   CMFCVisualManager::SetDefaultManager(RUNTIME_CLASS(CMFCVisualManagerWindows));

   // Standard initialization
   // If you are not using these features and wish to reduce the size
   // of your final executable, you should remove from the following
   // the specific initialization routines you do not need
   // Change the registry key under which our settings are stored
   // TODO: You should modify this string to be something appropriate
   // such as the name of your company or organization
   SetRegistryKey(_T("Local AppWizard-Generated Applications"));

   CMFCRichEditDlg dlg;
   m_pMainWnd = &dlg;
   INT_PTR nResponse = dlg.DoModal();
   if (nResponse == IDOK) {
      // TODO: Place code here to handle when the dialog is
      // dismissed with OK
   }else if (nResponse == IDCANCEL) {
      // TODO: Place code here to handle when the dialog is
      // dismissed with Cancel
   }else if (nResponse == -1) {
      TRACE(traceAppMsg, 0, "Warning: dialog creation failed, so
                                application is terminating unexpectedly.\n");
      TRACE(traceAppMsg, 0, "Warning: if you are using MFC controls on
              the dialog, you cannot #define _AFX_NO_MFC_CONTROLS_IN_DIALOGS.\n");
   }
	
   // Delete the shell manager created above.
   if (pShellManager != NULL) {
      delete pShellManager;
   }
	
   // Since the dialog has been closed, return FALSE so that we exit the
   // application, rather than start the application's message pump.
   return FALSE;
}

步骤 6 − 为所有三个按钮添加 Click 事件处理程序。以下是这些事件的实现。

void CMFCRichEditDlg::OnBnClickedButtonBold() { 
   // TODO: Add your control notification handler code here 
   CHARFORMAT Cfm;
	
   m_richEdit.GetSelectionCharFormat(Cfm);  
	
   Cfm.cbSize = sizeof(CHARFORMAT); 
   Cfm.dwMask = CFM_BOLD; 
   Cfm.dwEffects ^= CFE_BOLD; 
	
   m_richEdit.SetSelectionCharFormat(Cfm); 
   m_richEdit.SetFocus(); 
}
  
void CMFCRichEditDlg::OnBnClickedButtonItalic() { 
   // TODO: Add your control notification handler code here
   CHARFORMAT Cfm;  
   
   m_richEdit.GetSelectionCharFormat(Cfm);  
	
   Cfm.cbSize = sizeof(CHARFORMAT); 
   Cfm.dwMask = CFM_ITALIC; 
   Cfm.dwEffects ^= CFE_ITALIC;  
	
   m_richEdit.SetSelectionCharFormat(Cfm); 
   m_richEdit.SetFocus(); 
}
  
void CMFCRichEditDlg::OnBnClickedButtonUnderline() { 
   // TODO: Add your control notification handler code here 
   CHARFORMAT Cfm;  
	
   m_richEdit.GetSelectionCharFormat(Cfm); 
	
   Cfm.cbSize = sizeof(CHARFORMAT); 
   Cfm.dwMask = CFM_UNDERLINE; 
   Cfm.dwEffects ^= CFE_UNDERLINE;  
	
   m_richEdit.SetSelectionCharFormat(Cfm); 
   m_richEdit.SetFocus(); 
}

步骤 7 − 当上面的代码被编译并执行时，您将看到以下输出。现在输入文本并通过选择文本更改其格式，然后单击三个按钮中的任何一个。

❮ mfc_windows_controls.html

MFC教程

MFC - 富文本编辑控件

颜色选择器

读后有收获微信请站长喝咖啡

错误报告

您的建议:

感谢您的帮助！