RICH EDIT 控件 SDK 参考手册
2017-10-13 12:53
357 查看
摘要: 本文对RichEdit控件底层消息机制进行了讲解,以期读者对Windows平台下的Rich
Edit控件有一个更深入的认识,同时对于使用Win32SDK进行开发的人员具有一定参考价值。因为文章的初衷是引领VB程序员通过Win32
API调用来扩展VB下的RichEdit控件的功能,所以对于每个消息的详细说明和注意事项未作过多说明,感兴趣的朋友可以参考Visual
Studio下的MSDNLibrary。
关键字:RichEditControl、RTF、SDK、MSDN。
Edit控件提供格式化文本的编程接口。不过,应用程序必须实现这些用户接口组件,以便用户可以进行格式化操作。
RichEdit控件几乎支持所有用于多行Edit控件的消息和通知。因此,已经使用了Edit控件的程序可以很容易的改为Rich
Edit控件。额外的消息和通知使得应用程序可以访问RichEdit控件特有的功能。获取更多关于Edit控件的信息,请参阅Edit
Controls。
正如大家所熟知的,Windows控件是基础窗口,它处理那些控制窗口显示和特征的消息。而ActiveX控件是把那些消息变成属性和方法的COM 容器。RichEdit
Windows控件是EditWindows控件的扩展集,TextBoxActiveX控件也是从它派生而来。RichEdit能够识别Edit消息并且加入了自己特有的消息。你可以在Win32帮助文件中认出Edit和RichEdit的消息常数,因为他们均采用EM_作为前缀。
ActiveXRichTextBox控件将绝大多数的这种消息映射为其属性。例如,EM_LIMITTEXT与MaxLength属性相对应。但是你同时会注意到一些感兴趣的消息并没有与之对应的RichTextBox属性。为什么呢?
ActiveX控件为最通用的特性提供方法和属性,更具体讲,是提供给VB设计者最感兴趣的特性。设计者们似乎喜欢每个新版本里更多的特征。 例如,TextBox 和RichTextBox控件现在具备Locked属性。在旧版本的VB中你不得不通过EM_SETREADONLY消息来模拟。但是,还有许多其他隐藏的或者不是很明显的特性在ActiveX控件中尚未提供。为了使用这些特性,我们就必须对Rich
Edit控件的底层消息机制进行较深入的了解。
Edit控件之前,你应该调用LoadLibrary函数来确认安装的Rich
Edit控件的版本。下表显示了不同版本与其DLL间的对应关系。
下表给出了不同版本Windows下与其包含的不同版本的Rich
Edit对应关系:
RichEdit2.0采用与RichEdit1.0一致的Win32函数,结构和消息,极少例外。他们的区别在于:
RichEdit1.0窗体类的名字叫“RichEdit”。RichEdit2.0同时具有ANSI和Unicode窗体类,“RichEdit20A”和“RichEdit20W”分别表示对应的RichEdit窗体类,我们RichEdit.H文件定义的RICHEDIT_CLASS常数来区分,而具体采用哪一个取决于UNICODE编译标志。
在RichEdit2.0中,如果你创建一个Unicode控件,只需在任何发往控件的Window消息中给出Unicode数据。同样的,如果创建了一个ANSI控件,只能发送ANSI或者DBCS数据。你可以使用IsWindowUnicode函数来判断是否一个RichEdit控件是Unicode的。
RichEdit1.0 采用CRLF(回车符和换行符)字符组合表示段落符号。而RichEdit2.0只采用一个回车符号(‘/r’)。
RichEdit2.0包含以下新的消息:
RichEdit2.0 包含以下新的结构:
RichEdit2.0 不支持以下这些在亚洲语言版本的RichEdit1.0中支持的消息:
Edit控件。如果使用1.0版本(RICHED32.DLL),窗体类参数应该为“RichEdit”。如果采用2.0版本(RICHED20.DLL),窗体类参数应该为“RICHEDIT_CLASS”。
RichEdit控件支持大部分的Edit控件采用的窗体样式,同时也支持一些额外的样式。你如果希望控件中的文本支持不止一行的话就应该给出ES_MULTILINE窗体样式。
你可以采用EM_SETPARAFORMAT消息来应用段落格式。获取当前选中文本的段落格式属性,则采用EM_GETPARAFORMAT消息。PARAFORMAT结构将会在这两个消息中用到,它用于描述段落格式属性。
你可以采用EM_SETCHARFORMAT消息来应用字符格式。获取当前选中文本的字符格式属性,则采用EM_GETCHARFORMAT消息。CHARFORMAT结构将会在这两个消息中用到,它用于描述字符格式属性。
你也可以采用EM_SETCHARFORMAT和EM_GETCHARFORMAT消息来设置和获取默认字体格式,它将应用于所有随后插入的字符。例如,应用程序将默认字符格式设置为粗体,则用户随后敲入的字符都将为粗体。
只有在当前选择内容为空的时候默认字符格式才会被应用到新插入的文本上。否则,新的文本将假定沿用其所替换的文本的格式。如果选择内容改变,则默认字体格式将将采用该内容的首字符的格式。
保护(Protected)字符效果是唯一不改变其文本显示的例子。如果用户试图修改保护文本,Rich
Edit控件将发送EN_PROTECTED通知到其父窗口,让其父窗体决定是否允许或者拒绝修改。为了接收该通知,你必须使用EM_SETEVENTMASK消息来启用它。
前景色是一个字符属性,但是背景色是一个RichText控件属性。要设置背景色,请采用EM_SETBKGNDCOLOR消息。
确定RichEdit控件中的当前选中内容,采用EM_EXGETSEL消息。设置当前选择区域,采用EM_EXSETSEL消息。CHARRANGE结构用于在这两个消息中描述字符范围。获取当前选中内容的相关信息,你可以采用EM_SELECTIONTYPE消息。
应用程序可以通过处理EN_SELCHANGE通知来检测当前选中内容何时被改变。该通知通过SELCHANGE结构给出新选中内容的相关信息。Rich
Edit控件只有在你通过EM_SETEVENTMASK消息开启它之后才会发送该通知。
默认情况下,RichEdit控件在获取和失去焦点时将开启和隐藏选中文本的高亮显示。你可以通过EM_HIDESELECTION消息在任何时候开启或者隐藏选中区域的高亮显示。例如,某个应用程序可能提供一个查找对话框用于在Rich
Edit控件中查找文本,这种情况下就必须使用EM_HIDESELECTION消息来保持选中文本的高亮显示。
与Edit控件一样,你可以使用ES_NOHIDESEL窗体样式来防止Rich
Edit控件在失去焦点时隐藏选中区域的高亮显示。你也可以在RichEdit控件创建之后使用EM_HIDESELECTION消息来改变窗体的ES_NOHIDESEL样式。
获取和设置当前选中内容使用EM_GETSEL和EM_SETSEL Edit控件消息,而非EM_EXGETSEL和EM_EXSETSEL消息。EM_GETSEL消息将两个16位字符索引压缩为它的32位返回值,因此,仅仅适用于选中区域的前64K字节。然而,一个Rich
Edit控件不可能包含超过32K字节的文本,除非你使用EM_EXLIMITTEXT消息扩展了这个限制。对于选中文本中超过前64K字节的文本,EM_GETSEL消息将返回-1。
获取RichEdit控件中的选中文本,使用EM_GETSELTEXT消息。文本将被拷贝到指定字符数组中。你必须确保数组大小足以容纳选中文本再加上一个终止NULL字符。
获取给定范围的文本,使用EM_GETTEXTRANGE消息。该消息将使用TEXTRANGE结构,用于描述需要获得的文本范围以及用于获取该文本的字符数组指针。在这里,同样的,你必须确保数组大小足以容纳选中文本再加上一个终止NULL字符。
你可以使用EM_FINDTEXT消息在一个Rich
Edit控件中查找字符串。该消息将使用结构,用于描述文本查找范围及需要查找的字符串。你也可以指定诸如是否区分大小写等搜索选项。
Edit控件发送消息来替换默认的“断字处理过程”,获取断字信息,以及判断一个给定字符属于哪一行。
RichEdit控件的断字处理过程与Edit控件相似,但是它拥有更多能力。两种控件的断字处理过程均可以识别一个字符是否是一个分隔符,并且能够在找到给定位置的前一个或者后一个字分隔符。分隔符指的是一个标志单词结束的字符,比如空格。在Edit控件中,断字只出现在分隔符之后。
RichEdit控件的断字处理过程同时将字符组合为字符类,由到0x00的0x0F值来标识。断字可以出现在分隔符之后或者在不同类的字符之间。因此,在字符串“WIN.COM”中,由于字母数字和标点属于不同类别,断字程序将找到两个字分隔符。
一个字符类别可以由0个或者更多的字分隔符标志位组成一个8位的值。当执行自动换行操作时,Rich
Edit控件使用这些分隔符标志位来决定何处可以换行。有如下这些字分隔标志位:
WBF_BREAKAFTER表示允许在该字符后面折行,但是并不标记单词的结束,比如连字符-。
你可以使用EM_SETWORDBREAKPROC消息来替换Rich
Edit控件的默认断字处理过程。获取更多关于断字处理过程的信息,请参阅EditWordBreakProc函数说明。
另外,你可以使用EM_SETWORDBREAKPROCEX消息来替换默认的扩展断字处理过程EditWordBreakProcEx函数。该函数提供有关该文本的更多信息,比如字符集。你可以使用EM_GETWORDBREAKPROCEX消息来获取当前扩展断字处理过程的地址。
你可以使用EM_FINDWORDBREAK消息来查找断字符或者确定一个字符类和断字标志位。控件依次调用其断字处理过程,获取所需信息。
判断给定字符属于哪一行,你可以使用EM_EXLINEFROMCHAR消息。
Edit控件可以粘贴某种剪贴板格式。
对于一个Edit控件而言,你可以使用WM_COPY或者WM_CUT消息来拷贝或者剪切当前选中内容。同样的,你可以使用WM_PASTE消息将这些剪贴板内容粘贴到一个Rich
Edit控件中。控件将粘贴它所识别的第一个可用格式,这大概是最具描述性的格式。
你可以使用EM_PASTESPECIAL消息来粘贴指定的剪贴板格式。这个消息对具有“特殊粘贴”命令的应用程序很有用,该命令可以让用户选择剪贴板格式。你可以使用EM_CANPASTE消息来决定控件是否识别某种指定的格式。
你也可以使用EM_CANPASTE消息来决定RichEdit控件是否识别所有可用的剪贴板格式。该消息在处理WM_INITMENUPOPUP消息时很有用。应用程序可以启用或者屏蔽“粘贴”命令,取决于控件是否可以粘贴任一个可用类型。
RichEdit控件注册两种剪贴板格式:“富文本格式(RTF)”和一种叫做“RichEdit 文本与对象”的格式。应用程序可以使用RegisterClipboardFormat函数来注册这些格式,其取值为CF_RTF与CF_RETEXTOBJ。
将数据读入RichEdit控件(或者说,数据传入),使用EM_STREAMIN消息。控件将重复调用应用程序的回调函数,该函数每次传入数据的一部分到缓冲区中。
保存RichEdit控件内容(或者说,数据传出),你可以使用EM_STREAMOUT消息。控件将重复写入缓冲区然后调用应用程序的回调函数。对于每次调用,回调函数将保存缓冲区中的内容。
Text文本格式化的输出设备。
对于特殊设备而言,要格式化RichEdit控件中部分内容,你可以使用EM_FORMATRANGE消息。FORMATRANGE结构用于在该消息中描述需要格式化的文本范围以及目标设备的设备场景。
在输出设备文本格式化完成后,你可以使用EM_DISPLAYBAND消息将输出发送至设备。通过反复使用EM_FORMATRANGE和EM_DISPLAYBAND消息,打印Rich
Text控件内容的应用程序可以实现条带化操作。(条带化操作指的是将输出分割为较小部分用于打印目的的操作。)
你可以使用EM_SETTARGETDEVICE消息来指定一个用于Rich
Text文本格式化的目标设备。该消息对于WYSIWYG(所见即所得)模式非常有用,在该模式下应用程序采用默认打印机字体规格而非屏幕字体规格来定位文本。
Edit控件支持这种所谓的“无底”特性,在任何时候若其内容大小改变,它将向其父窗体发送EN_REQUESTRESIZE通知。
在处理EN_REQUESTRESIZE通知时,应用程序应该调整控件尺寸为REQRESIZE结构所给出的大小。应用程序同样可以变换控件相关的任何信息以适应控件的高度改变。调整控件大小,你可以使用SetWindowPos函数。
你可以使用EM_REQUESTRESIZE消息强制一个无底Rich
Edit控件发送EN_REQUESTRESIZE通知。该消息在处理WM_SIZE消息时很有用。
为了接收EN_REQUESTRESIZE通知,你必须采用EM_SETEVENTMASK消息来启用它。
Mask)来判断RichEdit控件发送到其父窗体的是何种通知。
设置RichEdit控件的事件掩码,采用EM_SETEVENTMASK消息。你可以使用EM_GETEVENTMASK消息来获取当前Rich
Edit控件的事件掩码。
RichEdit控件的父窗体可以通过处理EN_MSGFILTER通知来过滤所有的键盘和鼠标输入。父窗体可以防止键盘和鼠标消息被处理,或者可以通过修改指定的MSGFILTER结构来修改这些消息。
应用程序可以处理EN_PROTECTED通知,用以检测何时用户试图修改受保护的文本。为了置某个范围的文本为受保护状态,你可以设置受保护字符效果。获取更多信息,请参阅文本格式。
你可以通过处理EN_DROPFILES通知来允许用户Drop一个文件到Rich
Edit控件中。指定的ENDROPFILES结构包含了即将被Drop的文件的相关信息。
Edit控件所不支持的Edit控件的消息和窗体样式。
下面的消息由Edit控件处理,而不被RichEdit控件所支持。
下面的窗体样式用于多行Edit控件,而不被RichEdit控件所支持:
· 格式化
CHARFORMAT
CHARFORMAT2
EM_GETCHARFORMAT
EM_GETPARAFORMAT
EM_GETRECT
EM_SETBKGNDCOLOR
EM_SETCHARFORMAT
EM_SETEVENTMASK
EM_SETPARAFORMAT
EM_SETRECT
PARAFORMAT2
· 选中区域与Hit测试
CHARRANGE
EM_CHARFROMPOS
EM_EXGETSEL
EM_EXSETSEL
EM_GETFIRSTVISIBLELINE
EM_GETSEL
EM_HIDESELECTION
EM_POSFROMCHAR
EM_SELECTIONTYPE
EM_SETSEL
EN_SELCHANGE
SELCHANGE
· 文本操作
EM_EXLIMITTEXT
EM_FINDTEXT
EM_GETLIMITTEXT
EM_GETSELTEXT
EM_GETTEXTRANGE
EM_REPLACESEL
EM_SETLIMITTEXT
FINDTEXT
TEXTRANGE
· 断字与断行
EM_EXLINEFROMCHAR
EM_FINDWORDBREAK
EM_GETWORDBREAKPROC
EM_SETWORDBREAKPROC
EM_GETWORDBREAKPROCEX
EM_SETWORDBREAKPROCEX
EditWordBreakProcEx
· 行与滚动条
EM_GETLINE
EM_GETLINECOUNT
EM_GETTHUMB
EM_LINEFROMCHAR
EM_LINEINDEX
EM_LINELENGTH
EM_LINESCROLL
EM_SCROLL
EM_SCROLLCARET
· 编辑操作
EM_CANPASTE
EM_CANUNDO
EM_EMPTYUNDOBUFFER
EM_PASTESPECIAL
EM_UNDO
· 流
EDITSTREAM
EM_STREAMIN
EM_STREAMOUT
· 打印
EM_DISPLAYBAND
EM_FORMATRANGE
EM_SETTARGETDEVICE
FORMATRANGE
· 无底RichEdit 控件
EM_REQUESTRESIZE
EN_REQUESTRESIZE
REQRESIZE
· OLE 接口
IRichEditOle
IRichEditOleCallback
· 杂项
EM_GETEVENTMASK
EM_GETIMECOLOR
EM_GETIMEOPTIONS
EM_GETMODIFY
EM_GETOPTIONS
EM_GETPUNCTUATION
EM_GETWORDWRAPMODE
EM_SETEVENTMASK
EM_SETIMECOLOR
EM_SETIMEOPTIONS
EM_SETEVENTMASK
EM_SETMODIFY
EM_SETREADONLY
EM_SETOPTIONS
EM_SETPUNCTUATION
EM_SETWORDWRAPMODE
EN_CHANGE
EN_CORRECTTEXT
EN_DROPFILES
EN_ERRSPACE
EN_HSCROLL
EN_IMECHANGE
EN_KILLFOCUS
EN_MAXTEXT
EN_MSGFILTER
EN_OLEOPFAILED
EN_PROTECTED
EN_SAVECLIPBOARD
EN_SETFOCUS
EN_STOPNOUNDO
EN_UPDATE
EN_VSCROLL
WM_CONTEXTMENU
WM_CTLCOLOREDIT
COMPCOLOR
ENCORRECTTEXT
ENDROPFILES
ENOLEOPFAILED
ENPROTECTED
ENSAVECLIPBOARD
PUNCTUATION
MSGFILTER
Edit控件。EDITSTREAMCALLBACK类型定义了一个指向该回调函数的指针。EditStreamCallback是一个用于该应用程序定义的函数名的占位符。
指定EDITSTREAM结构中的dwCookie成员的值。应用程序在发送EM_STREAMIN和EM_STREAMOUT消息时将指定该值。
pbBuff
用于读取或写入的缓冲区指针。对于一个流入(读)操作,回调函数将数据填入该缓冲区,再传入RichEdit控件。对于流出(写)操作,缓冲区包含从控件中读取的数据,回调函数负责将其写入存储器中。
cb
指出读取和写入的字节数。
pcb
一个变量的指针,回调函数将设置该变量的值为实际读取或写入的字节数。
回调函数返回非0值表示发生错误。一旦发生错误,读写操作将终止,RichEdit控件将放弃pbBuff缓冲区中的任何数据。如果一个回调函数返回一个非0值,Rich
Edit控件将采用EDITSTREAM结构的dwError成员将该值传回应用程序。
Edit控件时,需要为EDITSTREAM结构的pfnCallback成员指定一个EditStreamCallback函数指针。Rich
Edit控件将不断调用该函数来输出或者输入数据。
当你发送EM_STREAMIN和EM_STREAMOUT消息时,你需要给出一个EDITSTREAM结构的dwCookie成员的值。Rich
Edit控件使用dwCookie参数将该值传递到EditStreamCallback函数中。例如,你可能使用dwCookie来传递一个打开的文件的句柄,回调函数就可以使用该dwCookie句柄来读取和写入文件。
控件不断调用回调函数,每次传递部分数据。控件不断调用回调函数,直至出现如下情况之一为止:
回调函数返回一个非0值。
回调函数在*pcb参数中返回0值。
*pcb参数返回的值小于cb参数请求的字节数。
发生错误,该错误拒绝RichEdit控件数据的传出或者传入。例如内存溢出状态,系统函数失败,或者读取缓冲区包含一个无效字符等。
对于一个流入操作,RTF代码包含表示一个RTF块结束的数据。
对于一个单行编辑控件的流入操作,回调函数读取到一个CRLF。
当前位置的文本的指针。如果code指定要向左移动,则文本为元素pchText[-1]到pchText[-cchText]的文本,pchText[0]未定义。对于其他所有操作,文本指的是pchText[0]到pchText[cchText -
1]的文本。
cchText
由code指定的搜索方向上的缓冲区中的字符数。
bCharSet
文本的字符集。
code
所执行的断字动作。可用的取值由EM_FINDWORDBREAK消息的code参数所描述。
Edit控件只有在使用EM_SETEVENTMASK消息启用了它之后才能发送下面的通知。
Edit控件获取一个IRichEditOle接口,该接口允许它控制OLE对象。客户端使用EM_SETOLECALLBACK消息注册一个IRichEditOleCallback接口,控件将使用它获取所需接口和存储。
下列OLE接口用于RichEdit控件:
[/code]
[/code]
RichEdit 控件同样支持下面的Edit控件样式。为了允许多行文本,你就必须指定ES_MULTILINE样式。
RichEdit控件不支持下面的Edit控件样式:
默认事件掩码为ENM_NONE,这种情况下将不会发送任何通知到父窗体。你可以通过ENM_GETEVENTMASK和ENM_SETEVENTMASK消息来获取和设置Rich
Edit控件的事件掩码。
2、Wind32SDK下的RICHEDIT.H头文件(2.0版本):包含了绝大多数函数声明和结构体及常数的C定义。
Edit控件有一个更深入的认识,同时对于使用Win32SDK进行开发的人员具有一定参考价值。因为文章的初衷是引领VB程序员通过Win32
API调用来扩展VB下的RichEdit控件的功能,所以对于每个消息的详细说明和注意事项未作过多说明,感兴趣的朋友可以参考Visual
Studio下的MSDNLibrary。
关键字:RichEditControl、RTF、SDK、MSDN。
一、引言
RichEdit控件是一个可用于输入、编辑、格式化、打印和保存文本的窗体。这些文本可以设置字符和段落格式,并且可以包含嵌入的COM对象。RichEdit控件提供格式化文本的编程接口。不过,应用程序必须实现这些用户接口组件,以便用户可以进行格式化操作。
RichEdit控件几乎支持所有用于多行Edit控件的消息和通知。因此,已经使用了Edit控件的程序可以很容易的改为Rich
Edit控件。额外的消息和通知使得应用程序可以访问RichEdit控件特有的功能。获取更多关于Edit控件的信息,请参阅Edit
Controls。
正如大家所熟知的,Windows控件是基础窗口,它处理那些控制窗口显示和特征的消息。而ActiveX控件是把那些消息变成属性和方法的COM 容器。RichEdit
Windows控件是EditWindows控件的扩展集,TextBoxActiveX控件也是从它派生而来。RichEdit能够识别Edit消息并且加入了自己特有的消息。你可以在Win32帮助文件中认出Edit和RichEdit的消息常数,因为他们均采用EM_作为前缀。
ActiveXRichTextBox控件将绝大多数的这种消息映射为其属性。例如,EM_LIMITTEXT与MaxLength属性相对应。但是你同时会注意到一些感兴趣的消息并没有与之对应的RichTextBox属性。为什么呢?
ActiveX控件为最通用的特性提供方法和属性,更具体讲,是提供给VB设计者最感兴趣的特性。设计者们似乎喜欢每个新版本里更多的特征。 例如,TextBox 和RichTextBox控件现在具备Locked属性。在旧版本的VB中你不得不通过EM_SETREADONLY消息来模拟。但是,还有许多其他隐藏的或者不是很明显的特性在ActiveX控件中尚未提供。为了使用这些特性,我们就必须对Rich
Edit控件的底层消息机制进行较深入的了解。
二、关于RichEdit控件
RichEdit控件的最初规范为1.0版。目前规范为2.0版。(译者注:目前最新版本为4.1版本!)在创建一个RichEdit控件之前,你应该调用LoadLibrary函数来确认安装的Rich
Edit控件的版本。下表显示了不同版本与其DLL间的对应关系。
RichEdit 版本 | DLL名称 | 版本号 |
1.0 | RICHED32.DLL | |
2.0 | RICHED20.DLL | 低于5.30.23.1200 |
3.0 | RICHED20.DLL | 5.30.23.1200或更高 |
4.1 | Msftedit.dll | |
Edit对应关系:
WindowsXPSP1 | 包含 RichEdit4.1,RichEdit3.0, 和一个 RichEdit1.0 仿真程序。 |
WindowsXP | 包含RichEdit3.0和一个 RichEdit1.0 仿真程序。 |
WindowsMe | 包含RichEdit1.0和3.0。 |
Windows2000 | 包含RichEdit3.0和一个 RichEdit1.0 仿真程序。 |
WindowsNT4.0 | 包含RichEdit1.0和2.0。 |
Windows98 | 包含RichEdit1.0和2.0。 |
Windows95 | 只包含RichEdit1.0。不过,Riched20.DLL与Windows 95系统兼容,所以可以在正确安装后使用。 |
2.1 RichEdit2.0
RichEdit2.0包含几个新特性,比如支持Unicode和远东语言,多级撤消,以及大量的增强用户接口。RichEdit2.0采用与RichEdit1.0一致的Win32函数,结构和消息,极少例外。他们的区别在于:
RichEdit1.0窗体类的名字叫“RichEdit”。RichEdit2.0同时具有ANSI和Unicode窗体类,“RichEdit20A”和“RichEdit20W”分别表示对应的RichEdit窗体类,我们RichEdit.H文件定义的RICHEDIT_CLASS常数来区分,而具体采用哪一个取决于UNICODE编译标志。
在RichEdit2.0中,如果你创建一个Unicode控件,只需在任何发往控件的Window消息中给出Unicode数据。同样的,如果创建了一个ANSI控件,只能发送ANSI或者DBCS数据。你可以使用IsWindowUnicode函数来判断是否一个RichEdit控件是Unicode的。
RichEdit1.0 采用CRLF(回车符和换行符)字符组合表示段落符号。而RichEdit2.0只采用一个回车符号(‘/r’)。
RichEdit2.0包含以下新的消息:
消息 | 描述 |
EM_AUTOURLDETECT | 是否开启/关闭自动URL检测。 |
EM_CANREDO | 判断是否在Redo队列中有一些动作。 |
EM_GETIMECOMPMODE | 获取当前输入方式编辑(IME)模式。 |
EM_GETLANGOPTIONS | 获取IME和远东语言支持选项。 |
EM_GETREDONAME | 获取Redo队列中的下一动作的类型名称。 |
EM_GETTEXTMODE | 获取文本模式或者Undo级别。 |
EM_GETUNDONAME | 获取Undo队列中的下一动作的类型名称。 |
EM_REDO | 重做Redo队列中的下一动作。 |
EM_SETLANGOPTIONS | 设置IME和远东语言支持选项。 |
EM_SETTEXTMODE | 设置文本模式或者Undo级别。 |
EM_SETUNDOLIMIT | 设置Undo队列的最大动作数目。 |
EM_STOPGROUPTYPING | 终止当前Undo动作的连续键入动作的组合。 |
消息 | 描述 |
CHARFORMAT2 | 包含字符格式信息。 |
PARAFORMAT2 | 包含段落格式属性。 |
EM_CONVPOSITION |
EM_GETIMECOLOR |
EM_GETIMEOPTIONS |
EM_GETPUNCTUATION |
EM_GETWORDWRAPMODE |
EM_SETIMECOLOR |
EM_SETIMEOPTIONS |
EM_SETPUNCTUATION |
EM_SETWORDWRAPMODE |
2.2 创建 RichEdit 控件
可用通过CreateWindowEx函数中指定RichEdit 窗体类来创建一个RichEdit控件。如果使用1.0版本(RICHED32.DLL),窗体类参数应该为“RichEdit”。如果采用2.0版本(RICHED20.DLL),窗体类参数应该为“RICHEDIT_CLASS”。
RichEdit控件支持大部分的Edit控件采用的窗体样式,同时也支持一些额外的样式。你如果希望控件中的文本支持不止一行的话就应该给出ES_MULTILINE窗体样式。
2.3 文本格式
应用程序可以通过给RichEdit控件发送消息来格式化字符和段落以及获取这些格式化信息。段落格式属性包含对齐、跳格、缩进和编号。对字符而言,你可以指定字体、尺寸、颜色以及如粗体、斜体和保护等效果。你可以采用EM_SETPARAFORMAT消息来应用段落格式。获取当前选中文本的段落格式属性,则采用EM_GETPARAFORMAT消息。PARAFORMAT结构将会在这两个消息中用到,它用于描述段落格式属性。
你可以采用EM_SETCHARFORMAT消息来应用字符格式。获取当前选中文本的字符格式属性,则采用EM_GETCHARFORMAT消息。CHARFORMAT结构将会在这两个消息中用到,它用于描述字符格式属性。
你也可以采用EM_SETCHARFORMAT和EM_GETCHARFORMAT消息来设置和获取默认字体格式,它将应用于所有随后插入的字符。例如,应用程序将默认字符格式设置为粗体,则用户随后敲入的字符都将为粗体。
只有在当前选择内容为空的时候默认字符格式才会被应用到新插入的文本上。否则,新的文本将假定沿用其所替换的文本的格式。如果选择内容改变,则默认字体格式将将采用该内容的首字符的格式。
保护(Protected)字符效果是唯一不改变其文本显示的例子。如果用户试图修改保护文本,Rich
Edit控件将发送EN_PROTECTED通知到其父窗口,让其父窗体决定是否允许或者拒绝修改。为了接收该通知,你必须使用EM_SETEVENTMASK消息来启用它。
前景色是一个字符属性,但是背景色是一个RichText控件属性。要设置背景色,请采用EM_SETBKGNDCOLOR消息。
2.4 RichEdit控件中的当前选择内容
用户可以在RichEdit控件中通过鼠标和键盘来选择文本。当前选择内容指的是选中字符的范围,或者表示没有字符选中时的插入点位置。应用程序可以获取选中内容的相关信息,设置当前选中内容,决定当前选中内容何时改变,显示或者隐藏当前高亮显示的选中内容等。确定RichEdit控件中的当前选中内容,采用EM_EXGETSEL消息。设置当前选择区域,采用EM_EXSETSEL消息。CHARRANGE结构用于在这两个消息中描述字符范围。获取当前选中内容的相关信息,你可以采用EM_SELECTIONTYPE消息。
应用程序可以通过处理EN_SELCHANGE通知来检测当前选中内容何时被改变。该通知通过SELCHANGE结构给出新选中内容的相关信息。Rich
Edit控件只有在你通过EM_SETEVENTMASK消息开启它之后才会发送该通知。
默认情况下,RichEdit控件在获取和失去焦点时将开启和隐藏选中文本的高亮显示。你可以通过EM_HIDESELECTION消息在任何时候开启或者隐藏选中区域的高亮显示。例如,某个应用程序可能提供一个查找对话框用于在Rich
Edit控件中查找文本,这种情况下就必须使用EM_HIDESELECTION消息来保持选中文本的高亮显示。
与Edit控件一样,你可以使用ES_NOHIDESEL窗体样式来防止Rich
Edit控件在失去焦点时隐藏选中区域的高亮显示。你也可以在RichEdit控件创建之后使用EM_HIDESELECTION消息来改变窗体的ES_NOHIDESEL样式。
获取和设置当前选中内容使用EM_GETSEL和EM_SETSEL Edit控件消息,而非EM_EXGETSEL和EM_EXSETSEL消息。EM_GETSEL消息将两个16位字符索引压缩为它的32位返回值,因此,仅仅适用于选中区域的前64K字节。然而,一个Rich
Edit控件不可能包含超过32K字节的文本,除非你使用EM_EXLIMITTEXT消息扩展了这个限制。对于选中文本中超过前64K字节的文本,EM_GETSEL消息将返回-1。
2.5 RichEdit 文本操作
应用程序可以发送消息来获取或者查找RichEdit控件中的文本。你既可以获取选中区域的文本也可以获取给定范围的文本。获取RichEdit控件中的选中文本,使用EM_GETSELTEXT消息。文本将被拷贝到指定字符数组中。你必须确保数组大小足以容纳选中文本再加上一个终止NULL字符。
获取给定范围的文本,使用EM_GETTEXTRANGE消息。该消息将使用TEXTRANGE结构,用于描述需要获得的文本范围以及用于获取该文本的字符数组指针。在这里,同样的,你必须确保数组大小足以容纳选中文本再加上一个终止NULL字符。
你可以使用EM_FINDTEXT消息在一个Rich
Edit控件中查找字符串。该消息将使用结构,用于描述文本查找范围及需要查找的字符串。你也可以指定诸如是否区分大小写等搜索选项。
2.6 断字与断行
RichEdit 控件调用叫做“断字处理过程”的函数来查找单词间分隔符以及判断何处可以换行。控件在执行自动换行操作时以及处理Ctrl+左箭头和Ctrl+右箭头的组合键时将利用这些信息。应用程序可以通过向RichEdit控件发送消息来替换默认的“断字处理过程”,获取断字信息,以及判断一个给定字符属于哪一行。
RichEdit控件的断字处理过程与Edit控件相似,但是它拥有更多能力。两种控件的断字处理过程均可以识别一个字符是否是一个分隔符,并且能够在找到给定位置的前一个或者后一个字分隔符。分隔符指的是一个标志单词结束的字符,比如空格。在Edit控件中,断字只出现在分隔符之后。
RichEdit控件的断字处理过程同时将字符组合为字符类,由到0x00的0x0F值来标识。断字可以出现在分隔符之后或者在不同类的字符之间。因此,在字符串“WIN.COM”中,由于字母数字和标点属于不同类别,断字程序将找到两个字分隔符。
一个字符类别可以由0个或者更多的字分隔符标志位组成一个8位的值。当执行自动换行操作时,Rich
Edit控件使用这些分隔符标志位来决定何处可以换行。有如下这些字分隔标志位:
WBF_BREAKAFTER | 字符后面可以换行。 |
WBF_BREAKLINE | 该字符为一个分隔符。分隔符标记单词的结束。也可以在分隔符后换行。 |
WBF_ISWHITE | 该字符为一个白空格字符。跟随的白空格字符在换行时不包含在行长度中。 |
你可以使用EM_SETWORDBREAKPROC消息来替换Rich
Edit控件的默认断字处理过程。获取更多关于断字处理过程的信息,请参阅EditWordBreakProc函数说明。
另外,你可以使用EM_SETWORDBREAKPROCEX消息来替换默认的扩展断字处理过程EditWordBreakProcEx函数。该函数提供有关该文本的更多信息,比如字符集。你可以使用EM_GETWORDBREAKPROCEX消息来获取当前扩展断字处理过程的地址。
你可以使用EM_FINDWORDBREAK消息来查找断字符或者确定一个字符类和断字标志位。控件依次调用其断字处理过程,获取所需信息。
判断给定字符属于哪一行,你可以使用EM_EXLINEFROMCHAR消息。
2.7 RichEdit 剪贴板操作
应用程序可以粘贴剪贴板中内容到一个RichEdit控件中,采用最佳可用剪贴板格式或者指定的剪贴板格式。你也可以决定是否一个RichEdit控件可以粘贴某种剪贴板格式。
对于一个Edit控件而言,你可以使用WM_COPY或者WM_CUT消息来拷贝或者剪切当前选中内容。同样的,你可以使用WM_PASTE消息将这些剪贴板内容粘贴到一个Rich
Edit控件中。控件将粘贴它所识别的第一个可用格式,这大概是最具描述性的格式。
你可以使用EM_PASTESPECIAL消息来粘贴指定的剪贴板格式。这个消息对具有“特殊粘贴”命令的应用程序很有用,该命令可以让用户选择剪贴板格式。你可以使用EM_CANPASTE消息来决定控件是否识别某种指定的格式。
你也可以使用EM_CANPASTE消息来决定RichEdit控件是否识别所有可用的剪贴板格式。该消息在处理WM_INITMENUPOPUP消息时很有用。应用程序可以启用或者屏蔽“粘贴”命令,取决于控件是否可以粘贴任一个可用类型。
RichEdit控件注册两种剪贴板格式:“富文本格式(RTF)”和一种叫做“RichEdit 文本与对象”的格式。应用程序可以使用RegisterClipboardFormat函数来注册这些格式,其取值为CF_RTF与CF_RETEXTOBJ。
2.8 流(Stream)
你可以使用流(Stream)向RichEdit控件传入或者传出数据。流由EDITSTREAM结构所定义,该结构描述一个缓冲区及一个应用程序定义的回调函数。将数据读入RichEdit控件(或者说,数据传入),使用EM_STREAMIN消息。控件将重复调用应用程序的回调函数,该函数每次传入数据的一部分到缓冲区中。
保存RichEdit控件内容(或者说,数据传出),你可以使用EM_STREAMOUT消息。控件将重复写入缓冲区然后调用应用程序的回调函数。对于每次调用,回调函数将保存缓冲区中的内容。
2.9 打印
你可以向RichEdit控件发送消息来将其输出重定向到指定设备,比如打印机。你也可以指定一个用于RichText文本格式化的输出设备。
对于特殊设备而言,要格式化RichEdit控件中部分内容,你可以使用EM_FORMATRANGE消息。FORMATRANGE结构用于在该消息中描述需要格式化的文本范围以及目标设备的设备场景。
在输出设备文本格式化完成后,你可以使用EM_DISPLAYBAND消息将输出发送至设备。通过反复使用EM_FORMATRANGE和EM_DISPLAYBAND消息,打印Rich
Text控件内容的应用程序可以实现条带化操作。(条带化操作指的是将输出分割为较小部分用于打印目的的操作。)
你可以使用EM_SETTARGETDEVICE消息来指定一个用于Rich
Text文本格式化的目标设备。该消息对于WYSIWYG(所见即所得)模式非常有用,在该模式下应用程序采用默认打印机字体规格而非屏幕字体规格来定位文本。
2.10 无底的RichEdit 控件
应用程序可以调整RichEdit控件的大小以便它总是与其内容大小匹配。RichEdit控件支持这种所谓的“无底”特性,在任何时候若其内容大小改变,它将向其父窗体发送EN_REQUESTRESIZE通知。
在处理EN_REQUESTRESIZE通知时,应用程序应该调整控件尺寸为REQRESIZE结构所给出的大小。应用程序同样可以变换控件相关的任何信息以适应控件的高度改变。调整控件大小,你可以使用SetWindowPos函数。
你可以使用EM_REQUESTRESIZE消息强制一个无底Rich
Edit控件发送EN_REQUESTRESIZE通知。该消息在处理WM_SIZE消息时很有用。
为了接收EN_REQUESTRESIZE通知,你必须采用EM_SETEVENTMASK消息来启用它。
2.11 各种各样的通知
RichEdit控件父窗体可以处理通知,这些消息记录影响该控件的事件。RichEdit控件支持所有Edit控件所使用的通知,同时具有几个新增的通知。你可以通过设置它的事件掩码(EventMask)来判断RichEdit控件发送到其父窗体的是何种通知。
设置RichEdit控件的事件掩码,采用EM_SETEVENTMASK消息。你可以使用EM_GETEVENTMASK消息来获取当前Rich
Edit控件的事件掩码。
RichEdit控件的父窗体可以通过处理EN_MSGFILTER通知来过滤所有的键盘和鼠标输入。父窗体可以防止键盘和鼠标消息被处理,或者可以通过修改指定的MSGFILTER结构来修改这些消息。
应用程序可以处理EN_PROTECTED通知,用以检测何时用户试图修改受保护的文本。为了置某个范围的文本为受保护状态,你可以设置受保护字符效果。获取更多信息,请参阅文本格式。
你可以通过处理EN_DROPFILES通知来允许用户Drop一个文件到Rich
Edit控件中。指定的ENDROPFILES结构包含了即将被Drop的文件的相关信息。
2.11 不支持的Edit控件的特性
RichEdit 控件支持绝大多数而并非全部的多行Edit控件的特性。本节列举出RichEdit控件所不支持的Edit控件的消息和窗体样式。
下面的消息由Edit控件处理,而不被RichEdit控件所支持。
不支持的消息 | 注释 |
EM_FMTLINES | 不支持。 |
EM_GETHANDLE | RichEdit控件并非将文本存储为简单的字符数组。 |
EM_GETMARGINS | 不支持。 |
EM_GETPASSWORDCHAR | 不支持ES_PASSWORD样式。 |
EM_SETHANDLE | RichEdit控件并非将文本存储为简单的字符数组。 |
EM_SETMARGINS | 不支持。 |
EM_SETPASSWORDCHAR | 不支持ES_PASSWORD样式。 |
EM_SETRECTNP | 不支持。 |
EM_SETTABSTOPS | 采用EM_SETPARAFORMAT消息。 |
WM_CTLCOLOR | 采用EM_SETBKGNDCOLOR消息。 |
WM_GETFONT | 采用EM_GETCHARFORMAT消息。 |
ES_LOWERCASE | ES_PASSWORD |
ES_OEMCONVERT | ES_UPPERCASE |
三、RichEdit 控件参考
3.1 总索引
RichText控件相关的消息、通知和结构体分组汇总如下。部分API元素也用于Edit控件。· 格式化
CHARFORMAT
CHARFORMAT2
EM_GETCHARFORMAT
EM_GETPARAFORMAT
EM_GETRECT
EM_SETBKGNDCOLOR
EM_SETCHARFORMAT
EM_SETEVENTMASK
EM_SETPARAFORMAT
EM_SETRECT
PARAFORMAT2
· 选中区域与Hit测试
CHARRANGE
EM_CHARFROMPOS
EM_EXGETSEL
EM_EXSETSEL
EM_GETFIRSTVISIBLELINE
EM_GETSEL
EM_HIDESELECTION
EM_POSFROMCHAR
EM_SELECTIONTYPE
EM_SETSEL
EN_SELCHANGE
SELCHANGE
· 文本操作
EM_EXLIMITTEXT
EM_FINDTEXT
EM_GETLIMITTEXT
EM_GETSELTEXT
EM_GETTEXTRANGE
EM_REPLACESEL
EM_SETLIMITTEXT
FINDTEXT
TEXTRANGE
· 断字与断行
EM_EXLINEFROMCHAR
EM_FINDWORDBREAK
EM_GETWORDBREAKPROC
EM_SETWORDBREAKPROC
EM_GETWORDBREAKPROCEX
EM_SETWORDBREAKPROCEX
EditWordBreakProcEx
· 行与滚动条
EM_GETLINE
EM_GETLINECOUNT
EM_GETTHUMB
EM_LINEFROMCHAR
EM_LINEINDEX
EM_LINELENGTH
EM_LINESCROLL
EM_SCROLL
EM_SCROLLCARET
· 编辑操作
EM_CANPASTE
EM_CANUNDO
EM_EMPTYUNDOBUFFER
EM_PASTESPECIAL
EM_UNDO
· 流
EDITSTREAM
EM_STREAMIN
EM_STREAMOUT
· 打印
EM_DISPLAYBAND
EM_FORMATRANGE
EM_SETTARGETDEVICE
FORMATRANGE
· 无底RichEdit 控件
EM_REQUESTRESIZE
EN_REQUESTRESIZE
REQRESIZE
· OLE 接口
IRichEditOle
IRichEditOleCallback
· 杂项
EM_GETEVENTMASK
EM_GETIMECOLOR
EM_GETIMEOPTIONS
EM_GETMODIFY
EM_GETOPTIONS
EM_GETPUNCTUATION
EM_GETWORDWRAPMODE
EM_SETEVENTMASK
EM_SETIMECOLOR
EM_SETIMEOPTIONS
EM_SETEVENTMASK
EM_SETMODIFY
EM_SETREADONLY
EM_SETOPTIONS
EM_SETPUNCTUATION
EM_SETWORDWRAPMODE
EN_CHANGE
EN_CORRECTTEXT
EN_DROPFILES
EN_ERRSPACE
EN_HSCROLL
EN_IMECHANGE
EN_KILLFOCUS
EN_MAXTEXT
EN_MSGFILTER
EN_OLEOPFAILED
EN_PROTECTED
EN_SAVECLIPBOARD
EN_SETFOCUS
EN_STOPNOUNDO
EN_UPDATE
EN_VSCROLL
WM_CONTEXTMENU
WM_CTLCOLOREDIT
COMPCOLOR
ENCORRECTTEXT
ENDROPFILES
ENOLEOPFAILED
ENPROTECTED
ENSAVECLIPBOARD
PUNCTUATION
MSGFILTER
3.2 RichEdit 回调函数
下列回调函数是RichEdit控件所特有的:EditStreamCallback |
EditWordBreakProcEx |
3.2.1 EditStreamCallback
EditStreamCallback函数是一个应用程序定义的回调函数,用于EM_STREAMIN和EM_STREAMOUT消息。它用于将数据传入或者传出一个RichEdit控件。EDITSTREAMCALLBACK类型定义了一个指向该回调函数的指针。EditStreamCallback是一个用于该应用程序定义的函数名的占位符。
DWORDCALLBACKEditStreamCallback(
DWORD
dwCookie
,
//application-definedvalue[/code]
LPBYTE
pbBuff
,
//
缓冲区指针[/code]
LONG
cb
,
//
读或写的字节数[/code]
LONG
*pcb
//
实际传输的字节数的指针[/code]
);[/code]
参数说明
dwCookie指定EDITSTREAM结构中的dwCookie成员的值。应用程序在发送EM_STREAMIN和EM_STREAMOUT消息时将指定该值。
pbBuff
用于读取或写入的缓冲区指针。对于一个流入(读)操作,回调函数将数据填入该缓冲区,再传入RichEdit控件。对于流出(写)操作,缓冲区包含从控件中读取的数据,回调函数负责将其写入存储器中。
cb
指出读取和写入的字节数。
pcb
一个变量的指针,回调函数将设置该变量的值为实际读取或写入的字节数。
返回值
回调函数返回0表示成功。.回调函数返回非0值表示发生错误。一旦发生错误,读写操作将终止,RichEdit控件将放弃pbBuff缓冲区中的任何数据。如果一个回调函数返回一个非0值,Rich
Edit控件将采用EDITSTREAM结构的dwError成员将该值传回应用程序。
备注
当你发送EM_STREAMIN和EM_STREAMOUT消息到一个RichEdit控件时,需要为EDITSTREAM结构的pfnCallback成员指定一个EditStreamCallback函数指针。Rich
Edit控件将不断调用该函数来输出或者输入数据。
当你发送EM_STREAMIN和EM_STREAMOUT消息时,你需要给出一个EDITSTREAM结构的dwCookie成员的值。Rich
Edit控件使用dwCookie参数将该值传递到EditStreamCallback函数中。例如,你可能使用dwCookie来传递一个打开的文件的句柄,回调函数就可以使用该dwCookie句柄来读取和写入文件。
控件不断调用回调函数,每次传递部分数据。控件不断调用回调函数,直至出现如下情况之一为止:
回调函数返回一个非0值。
回调函数在*pcb参数中返回0值。
*pcb参数返回的值小于cb参数请求的字节数。
发生错误,该错误拒绝RichEdit控件数据的传出或者传入。例如内存溢出状态,系统函数失败,或者读取缓冲区包含一个无效字符等。
对于一个流入操作,RTF代码包含表示一个RTF块结束的数据。
对于一个单行编辑控件的流入操作,回调函数读取到一个CRLF。
3.2.2 EditWordBreakProcEx
EditWordBreakProcEx函数是一个应用程序定义的回调函数,用于EM_SETWORDBREAKPROCEX消息。它决定字符在某段给定文本中的字分隔符的字符索引,或者是字符类和字分隔符标志位。EDITWORDBREAKPROCEX类型定义了一个回调函数的指针。EditWordBreakProcEx是一个应用程序定义的函数名的占位符。LONGEditWordBreakProcEx(
char
*pchText
,
[/code]
LONG
cchText
,
[/code]
BYTE
bCharSet
,
[/code]
INT
code[/code]
);[/code]
参数
pchText当前位置的文本的指针。如果code指定要向左移动,则文本为元素pchText[-1]到pchText[-cchText]的文本,pchText[0]未定义。对于其他所有操作,文本指的是pchText[0]到pchText[cchText -
1]的文本。
cchText
由code指定的搜索方向上的缓冲区中的字符数。
bCharSet
文本的字符集。
code
所执行的断字动作。可用的取值由EM_FINDWORDBREAK消息的code参数所描述。
返回值
返回字母分隔符的字符索引值,除非code参数是WB_CLASSIFY和WB_ISDELIMITER值。备注
应用程序必须安装回调函数,方法是在EM_SETWORDBREAKPROCEX消息中给出回调函数的地址。3.3RichEdit 结构体
下列结构体用于RichEdit控件:CHARFORMAT |
CHARFORMAT2 |
CHARRANGE |
COMPCOLOR |
EDITSTREAM |
ENCORRECTTEXT |
ENDROPFILES |
ENLINK |
ENOLEOPFAILED |
ENPROTECTED |
ENSAVECLIPBOARD |
FINDTEXT |
FINDTEXTEX |
FORMATRANGE |
MSGFILTER |
PARAFORMAT |
PARAFORMAT2 |
PUNCTUATION |
REOBJECT |
REPASTESPECIAL |
REQRESIZE |
SELCHANGE |
TEXTRANGE |
3.4RichEdit 消息
以下消息由RichEdit控件所独有:EM_AUTOURLDETECT |
EM_CANPASTE |
EM_CANREDO |
EM_DISPLAYBAND |
EM_EXGETSEL |
EM_EXLIMITTEXT |
EM_EXLINEFROMCHAR |
EM_EXSETSEL |
EM_FINDTEXT |
EM_FINDTEXTEX |
EM_FINDWORDBREAK |
EM_FORMATRANGE |
EM_GETCHARFORMAT |
EM_GETEVENTMASK |
EM_GETIMECOLOR |
EM_GETIMECOMPMODE |
EM_GETIMEOPTIONS |
EM_GETLANGOPTIONS |
EM_GETOLEINTERFACE |
EM_GETOPTIONS |
EM_GETPARAFORMAT |
EM_GETPUNCTUATION |
EM_GETREDONAME |
EM_GETSELTEXT |
EM_GETTEXTMODE |
EM_GETTEXTRANGE |
EM_GETUNDONAME |
EM_GETWORDBREAKPROCEX |
EM_GETWORDWRAPMODE |
EM_HIDESELECTION |
EM_PASTESPECIAL |
EM_REDO |
EM_REQUESTRESIZE |
EM_SELECTIONTYPE |
EM_SETBKGNDCOLOR |
EM_SETCHARFORMAT |
EM_SETEVENTMASK |
EM_SETIMECOLOR |
EM_SETIMEOPTIONS |
EM_SETLANGOPTIONS |
EM_SETOLECALLBACK |
EM_SETOPTIONS |
EM_SETPARAFORMAT |
EM_SETPUNCTUATION |
EM_SETTARGETDEVICE |
EM_SETTEXTMODE |
EM_SETUNDOLIMIT |
EM_SETWORDBREAKPROCEX |
EM_SETWORDWRAPMODE |
EM_STOPGROUPTYPING |
EM_STREAMIN |
EM_STREAMOUT |
WM_CONTEXTMENU |
3.5RichEdit 通知
RichEdit控件支持绝大多数的Edit控件所使用的通知,同时增加了如下的通知。一个RichEdit控件只有在使用EM_SETEVENTMASK消息启用了它之后才能发送下面的通知。
EN_CORRECTTEXT |
EN_DROPFILES |
EN_IMECHANGE |
EN_LINK |
EN_MSGFILTER |
EN_OLEOPFAILED |
EN_PROTECTED |
EN_REQUESTRESIZE |
EN_SAVECLIPBOARD |
EN_SELCHANGE |
EN_STOPNOUNDO |
3.6RichEditOLE接口
RichEdit 控件支持由OLE所定义的客户端的支持。该控件为大多数的OLE客户端提供完全的支持。它不支持链接到自身内容。客户端负责处理对话框和错误消息、OLE对象的存储处理,以及文档和应用程序窗体级的实时激活支持。客户端可以使用EM_GETOLEINTERFACE消息从RichEdit控件获取一个IRichEditOle接口,该接口允许它控制OLE对象。客户端使用EM_SETOLECALLBACK消息注册一个IRichEditOleCallback接口,控件将使用它获取所需接口和存储。
下列OLE接口用于RichEdit控件:
IRichEditOle |
IRichEditOleCallback |
3.6.1 IRichEditOle
指定用于RichEdit控件执行OLE相关操作的接口。IRichEditOle接口有下列方法:方法列表
IUnknown 方法 | 描述 |
QueryInterface | 返回支持的接口的指针。 |
AddRef | 增加引用计数。 |
Release | 减少引用计数。 |
IRichEditOle方法 | 描述 |
GetClientSite | 在创建一个新对象时获取一个可用的IOleClientSite接口。 |
GetObjectCount | 获取RichEdit控件中包含的对象数目。 |
GetLinkCount | 获取RichEdit控件中链接的对象数目。 |
GetObject | 返回RichEdit控件中一个REOBJECT结构描述的对象信息。 |
InsertObject | 将一个对象插入到RichEdit控件中。 |
ConvertObject | 将一个对象转换为一个新类型。 |
ActivateAs | 卸载属于旧类的对象,告诉OLE将其看做新类对象,然后重新调入这些对象。 |
SetHostNames | 当对象插入到RichEdit控件中时,设置一个“HostNames”给该对象。 |
SetLinkAvailable | 设置对象标志位中的可用链接位的值。 |
SetDvaspect | 设置RichEdit控件用于绘制一个对象的特征。 |
HandsOffStorage | 告诉RichEdit控件释放其指定对象相关的访问存储器接口。 |
SaveCompleted | 告诉RichEdit控件最近的保存操作已经完毕,应该继续存储该对象至不同存储器。 |
InPlaceDeactivate | 告诉RichEdit控件立即使当前激活的对象处于非激活状态。 |
ContextSensitiveHelp | 告诉RichEdit控件进入或者退出上下文相关帮助模式。 |
GetClipboardData | 获取一个剪贴板对象,用于Edit控件的某一区域。 |
ImportDataObject | 导入一个剪贴板对象至RichEdit控件,替换当前选中的内容。 |
3.6.2 IRichEditOleCallback
指定一个用于RichEdit控件从客户端获取OLE相关信息的接口。RichEdit 控件的客户端负责实现该接口,并通过EM_SETOLECALLBACK消息将其指派给一个控件。IRichEditOleCallback接口包含如下方法:方法列表
IUnknown 方法 | 描述 |
QueryInterface | 返回支持的接口的指针。 |
AddRef | 增加引用计数。 |
Release | 减少引用计数。 |
IRichEditOleCallback 方法 | 描述 |
GetNewStorage | 为一个粘贴自剪贴板或者从一个RTF流读取的对象提供存储。 |
GetInPlaceContext | 提供应用程序和文件级的接口以及支持原地激活的必需的信息。 |
ShowContainerUI | 告诉应用程序是否显示其用户接口容器。 |
QueryInsertObject | 询问应用程序是否一个对象应该被插入。 |
DeleteObject | 通知某一对象将在RichEdit中被删除。 |
QueryAcceptData | 访问一个粘贴或者拖拽,以决定是否其粘贴/拖拽的数据应该被接受。 |
ContextSensitiveHelp | 告诉应用程序应该进入或者退出上下文相关帮助模式。 |
GetClipboardData | 允许客户端支持其自身剪贴板对象。 |
GetDragDropEffect | 允许客户端指定其拖放操作的执行结果。 |
GetContextMenu | 在一个鼠标右键按下事件中,询问应用程序提供一个上下文菜单。 |
3.7RichEdit枚举类型
下列枚举类型用于RichEdit控件:TEXTMODE |
UNDONAMEID |
3.7.1 TEXTMODE
TEXTMODE 枚举类型包含用于表示RichEdit控件的文本模式的值。EM_SETTEXTMODE 和 EM_GETTEXTMODE m消息将使用这个枚举类型。typedefenumtagTextMode
{
TM_PLAINTEXT =1,
TM_RICHTEXT =2, //
默认值[/code]
TM_SINGLELEVELUNDO =4,
TM_MULTILEVELUNDO =8, //
默认值[/code]
TM_SINGLECODEPAGE =16,
TM_MULTICODEPAGE =32
}TEXTMODE;
[/code]
常数 | 涵义 |
TM_PLAINTEXT | 纯文本模式,这种模式下控件类似标准编辑控件。 |
TM_RICHTEXT | 富文本模式,这种模式下控件具备标准RichEdit功能。为默认设置。 |
TM_SINGLELEVELUNDO | 控件只允许撤销Undo队列中的最后一个动作。 |
TM_MULTILEVELUNDO | 控件支持多级撤销操作。为默认属性。使用EM_SETUNDOLIMIT消息来设置撤销操作的最大级数。 |
TM_SINGLECODEPAGE | 不支持。 |
TM_MULTICODEPAGE | 不支持。 |
3.7.2 UNDONAMEID
UNDONAMEID 枚举类型包含指示RichEdit控件动作的常数,这些动作可以用于撤销和重做操作。 EM_GETREDONAME 和EM_GETUNDONAME 将使用该枚举类型作为一个返回值。typedefenum_undonameid{
UID_UNKNOWN =0,
UID_TYPING =1,
UID_DELETE =2,
UID_DRAGDROP =3,
UID_CUT =4,
UID_PASTE =5
}UNDONAMEID;
[/code]
常数 | 涵义 |
UID_UNKNOWN | Undo操作类型未知。 |
UID_TYPING | 键入操作。 |
UID_DELETE | 删除操作。 |
UID_DRAGDROP | 拖拽-放下操作。 |
UID_CUT | 剪切操作。 |
UID_PASTE | 粘贴操作。 |
3.8RichEdit 常数
3.8.1 RichEdit控件样式
下列窗体样式属于RichEdit控件所独有:样式 | 描述 |
ES_DISABLENOSCROLL | 在不需要滚动条时将它们置灰,而非隐藏。 |
ES_EX_NOCALLOLEINIT | 禁止控件在创建时调用OleInitialize函数。仅在对话框模式下有用,因为CreateWindowEx不支持该样式。 |
ES_NOIME | 禁止输入方式编辑(IME)操作。只对亚洲语言有效。 |
ES_SAVESEL | 在控件失去焦点时保持选定区域。默认情况下,在控件重新获取焦点时将选择所有内容。 |
ES_SELFIME | 指示RichEdit控件允许应用程序控制所有的IME操作。只对亚洲语言有效。 |
ES_SUNKEN | 控件显示为下凹边框样式,看起来像是嵌入到其父窗体中。 Windows95: Windows95下的应用程序应该使用WS_EX_CLIENTEDGE,而非ES_SUNKEN。 |
ES_VERTICAL | 垂直绘制文本和对象。只对亚洲语言有效。 |
ES_AUTOHSCROLL | ES_NOHIDESEL |
ES_AUTOVSCROLL | ES_READONLY |
ES_CENTER | ES_RIGHT |
ES_LEFT | ES_WANTRETURN |
ES_MULTILINE | |
RichEdit控件不支持下面的Edit控件样式:
ES_LOWERCASE | ES_PASSWORD |
ES_OEMCONVERT | ES_UPPERCASE |
3.8.2 RichEdit控件事件掩码标志
事件掩码用于指定一个RichEdit控件向父窗体发送何种通知。事件掩码可以为0或下列多种取值:值 | 涵义 |
ENM_CHANGE | 发送EN_CHANGE 通知。 |
ENM_CORRECTTEXT | 发送EN_CORRECTTEXT通知。 |
ENM_DROPFILES | 发送EN_DROPFILES通知。 |
ENM_KEYEVENTS | 发送EN_MSGFILTER键盘事件通知。 |
ENM_MOUSEEVENTS | 发送EN_MSGFILTER 鼠标事件通知。 |
ENM_PROTECTED | 发送EN_PROTECTED通知。 |
ENM_RESIZEREQUEST | 发送EN_REQUESTRESIZE通知。 |
ENM_SCROLL | 发送EN_HSCROLL通知。 |
ENM_SELCHANGE | 发送EN_SELCHANGE通知。 |
ENM_UPDATE | 发送EN_UPDATE通知。 |
Edit控件的事件掩码。
四、参考文献
1、MSDNLibraryVisualStudio6.0(CHS),我们在MSDN上可以找到最新版本的SDK文档,地址如下:http://msdn.microsoft.com/library/default.asp?url=/library/en-us/shellcc/platform/commctls/richedit/richeditcontrols/aboutricheditcontrols.asp2、Wind32SDK下的RICHEDIT.H头文件(2.0版本):包含了绝大多数函数声明和结构体及常数的C定义。
相关文章推荐
- RICH EDIT 控件 SDK 参考手册
- RICH EDIT 控件 SDK 参考手册
- RICH EDIT 控件 SDK 参考手册
- Rich Edit 控件 SDK 参考手册
- Rich Edit 控件 SDK 参考手册
- RICH EDIT 控件 SDK 参考手册
- Rich Edit 控件 SDK 参考手册
- RICH EDIT 控件 SDK 参考手册
- RichEdit控件 SDK 参考手册
- RichEdit控件 SDK 参考手册
- RichEdit控件参考手册
- RichEdit控件参考手册
- Flash控件使用参考手册
- 在SDK中使用Rich Edit控件,以及使用LISTVIEW,PROGRESS等控件
- 在SDK中使用Rich Edit控件,以及使用LISTVIEW,PROGRESS等控件
- OpenCV参考手册之CvCapture结构体
- Hadoop 2.6.0分布式部署参考手册
- SDK方式防止List Control控件更新闪烁
- 完整的 HTML 4 + HTML 5 实体参考手册
- CSS 参考手册