WIN32汇编语言教程:第09章 通用控件 · 9.4 使用Richedit控件(6)

2. 创建Richedit控件

创建Richedit控件的工作一般在主窗口的WM_CREATE消息中完成,创建的办法是使用CreateWindowEx函数:

              .const
szClassEdit db 'RichEdit20A',0
             ...
             .code
       invoke CreateWindowEx,WS_EX_CLIENTEDGE,offset szClassEdit,NULL,\
            WS_CHILD OR WS_VISIBLE OR WS_VSCROLL OR WS_HSCROLL \
             OR ES_MULTILINE or ES_NOHIDESEL,\
             0,0,0,0,hWinMain,0,hInstance,NULL
   mov    hWinEdit,eax

注意类名使用上的区别:1.0版使用“RichEdit”,2.0和3.0版本的类名有两种,ANSI版本使用的类名是“RichEdit20A”,Unicode版本使用的类名是“RichEdit20W”,例子中使用的是ANSI版本。

Richedit控件可以使用的风格有3组:标准的窗口风格、Edit控件风格和Richedit控件特有的风格。

在Edit控件可以使用的风格中,可供Richedit控件使用的有:

● ES_MULTILINE——可以编辑多行文字。

● ES_AUTOHSCROLL和ES_AUTOVSCROLL——自动滚动。

● ES_NOHIDESEL——失去键盘输入焦点的时候仍然显示选择区域。

● ES_READONLY——只读属性。

● ES_CENTER,ES_RIGHT和ES_LEFT——文本的对齐方式。

● ES_WANTRETURN——允许用户按回车键插入新的行。

但下列Edit控件风格不能在Richedit控件中使用:

● ES_LOWERCASE或ES_UPPERCASE——将控件中的文字全部转换成小写或大写。

● ES_PASSWORD——将控件中的文字显示为密码方式(显示为星号)。

下面列出的是部分Richedit控件特有的风格:

● ES_DISABLENOSCROLL——指定这个风格后,控件在不需要滚动条的时候(文字没有超出客户区大小)显示灰化状态的滚动条,而默认情况下,当不需要滚动条的时候,控件根本不会显示它。

● ES_NOIME——禁止输入法(IME)操作,仅用于亚洲语言版本。

● ES_SAVESEL——在失去键盘输入焦点的时候保存当前选择区域,默认状态下当控件在重新获得焦点的时候会将全部文本选中。

创建控件以后,需要发送EM_EXLIMITTEXT消息设置控件中能够容纳字符的总数,虽然Richedit控件中的文字长度可以支持到最大的文件尺寸,但默认情况下,控件还是将最大字符数限制为64 KB,所以如果读者发现Richedit控件也只能编辑64 KB字符的话,那并不是控件的错,而是没有告诉它具体的要求,EM_EXLIMITTEXT消息的使用方法是:

   invoke SendMessage,hWinEdit,EM_EXLIMITTEXT,0,dwTextMax

其中dwTextMax指定了最大字符数。

9.4.2  Richedit控件的控制消息

1. 选择区域

选择区域就是用户在控件中通过拖动鼠标来选定的多个文字,选择了一段文字以后,用户以后的操作就是针对这段文字的,如按下Delete键可以删除整段文字,按Ctrl+C键将这段文字拷贝到剪贴板中,按Ctrl+V键用剪贴板中的内容替换这段文字等。

在程序中,选择区域可以被程序获取,也可以由程序自由设置,从编程角度来看,选择区域的用处有两个:

● 选定操作文本——与用户手工选定一段文本以便进行各种操作类似,程序在对文本进行操作之前也需要预先设置选择区域。

● 定位光标——控件中并没有专门的用来定位光标的控制消息,定位光标也是靠设置选择区域完成的。如果把选择区域的起始位置和结束位置设置为相同的,那么就相当于把光标定位到这个位置而不选定任何文字。

在Edit控件中,获取选择区域可以通过向控件发送EM_GETSEL消息:

   invoke SendMessage,hRichedit,EM_GETSEL,lpdwStart,lpdwEnd

lpdwStart和lpdwEnd指向两个用来返回选定区域起始位置和结束位置的双字变量,也可以将这两个参数全部设置为NULL,因为消息的返回值也是位置数据,返回值的低16位是选定区域的起始位置,高16位是结束位置。

但是EM_GETSEL消息仅适用于控件中文本长度不超过64 KB的情况,如果Richedit中选择区域的起始位置或结束位置有一个落在了64 KB以外,那么消息仅返回−1,而不是正确的数值,所以最好还是使用EM_EXGETSEL消息,EM_EXGETSEL消息是Richedit的特有消息,不能在Edit控件中使用:

invoke SendMessage,hRichedit,EM_EXGETSEL,0,lpchr

lpchr参数指向一个CHARRANGE结构,用来接收选择区域的起始和结束位置,该结构定义如下:

CHARRANGE STRUCT
  cpMin DWORD     ?     ;选择区域的起始位置
  cpMax DWORD     ?     ;选择区域的结束位置
CHARRANGE ENDS

如果cpMinx字段等于cpMax字段,表示选择区域的长度为0,而光标位于这个位置;如果cpMin等于0而cpMax等于−1,表示选定的是控件中的所有内容。

程序也可以通过发送对应的消息来设置选择区域:

invoke SendMessage,hRichedit,EM_SETSEL,dwStart,dwEnd
   invoke SendMessage,hRichedit,EM_EXSETSEL,0,lpchr

EM_SETSEL的参数中直接用dwStart和dwEnd指定选择区域的开始和结束位置,但是这个消息同样有64 KB长度的限制;EM_EXSETSEL消息没有这个限制,lpchr参数同样指向一个CHARRANGE结构,结构中包含了需要设定的位置。如果仅是移动光标而不选择任何区域,可以将起始位置和结束位置设置为相同的数值。

在程序中设置了选择区域(或改变了光标位置)后,可能这个区域和原来的选择区域位置相差太多,以至于落在了客户区的外面,用户已经看不到它了,如果希望控件能够卷动文字以便将新的位置落在客户区中,可以发送EM_SCROLLCARET消息,这个消息没有任何参数:

   invoke SendMessage,hRichedit,EM_SCROLLCARET,0,0

在例子程序中,根据是否存在选择区域来决定是否允许拷贝和剪切功能。因为如果不存在选择区域,就没有文本可供拷贝或剪切,所以在_SetStatus子程序中使用下面的代码首先获取选择区域,并根据情况允许或禁止拷贝和剪切菜单项:

invoke SendMessage,hWinEdit,EM_EXGETSEL,0,addr @stRange
   mov    eax,@stRange.cpMin
   .if    eax == @stRange.cpMax ;不存在选择区域
      invoke EnableMenuItem,hMenu,IDM_COPY,MF_GRAYED
          invoke EnableMenuItem,hMenu,IDM_CUT,MF_GRAYED
   .else                          ;存在选择区域
          invoke EnableMenuItem,hMenu,IDM_COPY,MF_ENABLED
          invoke EnableMenuItem,hMenu,IDM_CUT,MF_ENABLED
   .endif

另外,在查找文本的_FindText子程序中,一开始也通过发送EM_EXGETSEL消息获取选择区域,这是为了获得光标位置以便设置查找的起始点,当找到文本以后,文本的位置在FINDTEXTEX结构的chrgText字段中返回,chrgText字段本身是一个CHARRANGE结构,所以直接在EM_EXSETSEL消息中使用它就可以将选择区域设置到找到的文字上:

invoke SendMessage,hWinEdit,EM_EXSETSEL,0,addr @stFindText.chrgText
   invoke SendMessage,hWinEdit,EM_SCROLLCARET,NULL,NULL

最后程序发送EM_SCROLLCARET消息卷动文字,以便找到的文本能够出现在用户的视野中。

2. 文本管理

文本管理涉及获取文本,设置文本以及一些辅助操作。

Richedit控件本身就是一个窗口,所以可以通过常规的函数对其中的文本进行操作,比如要获取和设置文本,可以调用GetWindowText或SetWindowText函数,也可以通过发送WM_GETTEXT和WM_SETTEXT消息来完成;如果需要获取控件中的文本长度,可以通过GetWindowTextLength函数或发送WM_GETTEXTLENGTH消息,不过所有这些操作针对的都是控件中的全部文字,无法实现细微的操作。

向控件发送控制消息仅针对选择区域操作则灵活得多,当通过EM_EXSETSEL消息设置好选择区域后,再通过EM_GETSELTEXT消息就可以获取当前选定的文本:

上页:第09章 通用控件 · 9.4 使用Richedit控件(5) 下页:第09章 通用控件 · 9.4 使用Richedit控件(7)

第09章 通用控件

版权所有 © 中山市飞娥软件工作室 证书:粤ICP备09170368号