Unix/Linux下的Curses库开发指南——第四章 鼠标支持

第4 章鼠标支持

4.1鼠标支持简介

终端支持鼠标操作目前是一个比较高级的话题，很少有资料涉及。另一方面支持鼠标操作的终端实际上目前非常的少，除了xterm 类型的终端外，其余的终端都不支持。因此这部分大多数人可能不需要，所以本书开始不准备涉及这方面的讨论，但考虑到书籍的完整性，还是把这部分加入。 (ScoUnix 、 Solaris 等操作系统终端环境下都不支持鼠标 ) 。本章的示例程序可以在 Linux 下的 XWindow 中通过。

鼠标能够让用户的操作更加方便和容易，但存在着一个非常严重的问题，即就是程序的移植性问题。curses 库的引入正是为了解决终端的移植问题，如果过多的使用鼠标支持，将使得程序的移植性非常的差，在那些不支持鼠标的终端上操作将无法进行，这将违背于 curses 库当初的设计。因此我们应该避免使用鼠标，对于那些使用鼠标的程序最好同时能够提供键盘解决方案，除非你能保证你使用的所有终端都能够支持鼠标。

4.2鼠标支持概念和数据结构

鼠标操作将引入一个新的概念：事件。每一个鼠标操作都对应于一个鼠标事件，同时会触发该鼠标事件。一旦鼠标事件触发，我们就可以执行特定的程序。目前，curses 库中支持的所有的鼠标事件如表 4.1 。

表4.1curses库中的所有鼠标事件

鼠标事件	鼠标操作
BUTTON1_PRESSED	按下鼠标键1
BUTTON1_RELEASED	松开鼠标键1
BUTTON1_CLICKED	单击鼠标键1
BUTTON1_DOUBLE_CLICKED	双击鼠标键1
BUTTON1_TRIPLE_CLICKED	连续三次点击鼠标键1
BUTTON2_PRESSED	按下鼠标键2
BUTTON2_RELEASED	松开鼠标键2
BUTTON2_CLICKED	单击鼠标键2
BUTTON2_DOUBLE_CLICKED	双击鼠标键2
BUTTON2_TRIPLE_CLICKED	连续三次点击鼠标键2
BUTTON3_PRESSED	按下鼠标键3
BUTTON3_RELEASED	松开鼠标键3
BUTTON3_CLICKED	单击鼠标键3
BUTTON3_DOUBLE_CLICKED	双击鼠标键3
BUTTON3_TRIPLE_CLICKED	连续三次点击鼠标键3
BUTTON4_PRESSED	按下鼠标键4
BUTTON4_RELEASED	松开鼠标键4
BUTTON4_CLICKED	单击鼠标键4
BUTTON4_DOUBLE_CLICKED	双击鼠标键4
BUTTON4_TRIPLE_CLICKED	连续三次点击鼠标键4
BUTTON_SHIFT	在鼠标状态改变期间按下SHIFT 键
BUTTON_CTRL	在鼠标状态改变期间按下CTRL 键
BUTTON_ALT	在鼠标状态改变期间按下ALT 键
ALL_MOUSE_ENENT	报告所有的鼠标的状态改变
REPORT_MOUSE_POSITION	鼠标移动

为了能够描述每个鼠标事件，curses 中使用结构 MEVENT ，它的结构如下：

typedefstruct{

shortid；

intx， y ， z ；

mmask_tbstate；

}MEVENT；

其中bstate 是我们最感兴趣的成员，它描述了事件发生的时候鼠标按键的状态；

其余的id 用来区分消息来源的不同的设备，比如鼠标，图形板等等； x ， y 给出了事件发生时候的鼠标位置，至于 z 暂时没有使用。

另一方面，为了能够保存鼠标事件，curses 中引入了鼠标事件队列。所有的鼠标事件触发后，它们将被压入鼠标事件队列中等候处理。实际上所有的鼠标函数都是通过鼠标事件队列获取相应的鼠标事件。

4.3开始使用鼠标

4.3.1鼠标操作函数

curses中的鼠标支持函数包括下面的七个：

■ mmask_tmousemask(mmask_tnewmask， mmask_t*oldmask) ；

这个函数是所有的鼠标函数中第一个调用的，它的作用相当于initscr() ，它初始化鼠标系统，通知系统必须截获并处理参数 newmask 指定的鼠标事件，指定之外的事件则可以忽略。如果设置之前系统指定的处理事件 oldmask 不为 NULL ，则原有的事件保存在 oldmask 中，这样一旦处理结束后可以恢复为原来的设置。默认情况下，函数不对任何事件进行处理。因此如果需要使用鼠标进行处理，我们必须自己进行设置。如果我们对所有的鼠标事件都需要处理的话，那可以使用 ALL_MOUSE_EVENT 事件；如果需要关闭所有的鼠标事件， newmask 可以设置为 0 。

如果函数执行错误，将返回0 ；否则返回设置的当前位置。如果我们需要处理鼠标的所有双击事件，那么函数用法可以如下：

mousemask(BUTTON1_DOUBLE_CLICKED|BUTTON2_DOUBLE_CLICKED|

BUTTON3_DOUBLE_CLICKED|BUTTON4_DOUBLE_CLICKED,

Old_mask);

■int mouseinterval(interval);

该函数用来设置鼠标一次点击的时间间隔。一次鼠标点击定义为在一定的时间间隔内鼠标被按下又被释放的过程。默认情况下这个时间间隔为1/5 秒。通过 mouseinterval() 函数我们可以修改这个时间间隔。 erval 就是需要设定的时间间隔。它的单位是毫秒。如果将鼠标点击的时间间隔从默认值更改为 1 秒，则函数用法如下：

mouseinterval(1000)；

如果函数执行成功，将返回OK ，否则返回 ERR 。

■ intgetmouse(MEVENT*envnt);

■ intungetmouse(MEVENT*event);

与使用getch() 和 wgetch() 从键盘接受输入一样，我们也同样使用 getch() 和 wgetch() 从鼠标接受输入。但是为了区别键盘输入和鼠标输入，我们定义了 KEY_MOUSE 常量。如果是鼠标输入， getch() 和 wgetch() 将返回 KEY_MOUSE 。因此我们可以通过判断 getch() 和 wgetch() 的返回值是否为 KEY_MOUSE 判断是否是鼠标输入。

如果输入为鼠标，则getmouse() 函数用来从鼠标事件队列中获取下一个鼠标事件。如果执行成功，它将根据鼠标事件填充结构 mevent 。因此通过获取该 event 结构中的 bstate 成员可以知道具体的鼠标事件。

因此整个鼠标处理的代码可以如下：

MEVENTevent;

ch=getch();

if(ch==KEY_MOUSE)

if(getmouse(&event)==OK)

./* 事件处理代码 */

.

.

■ boolwenclose(WINDOW*win,inty,intx);

ungetmouse()的作用与 ungetch() 类似，它将 KEY_MOUSE 事件返回给 getch() 和 wgetch() 函数的输入队列，同时将鼠标事件返回给鼠标事件队列。

■ boolwmouse_trafo(constWINDOW*win,int*pY,int*pX,boolto_screen);

这两个函数用来处理MEVENT 结构中的 x ， y 坐标。 wenclose() 用来判断参数中的 (x ； y) 坐标是否在给定的窗口 win 中。对于前面的函数 getmouse() ，它返回的 MEVENT 结构中的 (x ， y) 坐标是相对于屏幕的左上角而言。而 wenclose() 是相对于指定窗口的。 getmouse() 用来获取整个屏幕上的指定的鼠标事件，而 wenclose() 只能处理指定窗口内的鼠标事件。发生在窗口之外的其余的鼠标事件， wenclose() 无法获取。一旦在窗口内触发鼠标事件， wmouse_trafo() 函数将把屏幕坐标转换为窗口坐标，这时候最后一个参数 to_screen 必需设置为 FALSE ；如果 to_screen 设置为 TRUE ，则函数将把窗口坐标转换为屏幕相对坐标。

4.3.2鼠标程序开发步骤

鼠标程序的开发一般遵循下面的一些步骤：

(1) 使用mousemask() 函数初始化需要获取的鼠标事件。

(2) 循环使用getch() 或者 wgetch() 函数获取键盘或者鼠标输入，如果 getch() 和 wgetch() 返回 KEY_MOUSE ，则表明是鼠标输入。

(3) 通过getmouse() 获取触发的鼠标事件，根据具体的事件进行处理。

下面我们根据这三个开发步骤看下面的一个示例程序。

4.3.3示例程序

下面的程序演示了如何使用鼠标进行菜单选择，

#include<curses.h>

#defineWIDTH30

#defineHEIGHT10

intstartx=0;

intstarty=0;

char*choices[]={

"Choice1",

"Choice2",

"Choice3",

"Choice4",

"Exit",

};

intn_choices=sizeof(choices)/sizeof(char*);

voidprint_menu(WINDOW*menu_win,inthighlight);

voidreport_choice(intmouse_x,intmouse_y,int*p_choice);

intmain()

{

intc,choice=0;

WINDOW*menu_win;

MEVENTevent;

initscr();

clear();

noecho();

cbreak();

/* 在屏幕上输出窗口 */

startx=(80-WIDTH)/2;

starty=(24-HEIGHT)/2;

attron(A_REVERSE);

mvprintw(23,1,"ClickonExittoquit");

refresh();

attroff(A_REVERSE);

/*Printthemenuforthefirsttime*/

menu_win=newwin(HEIGHT,WIDTH,starty,startx);

print_menu(menu_win,1);

/*Getallthemouseevents*/

mousemask(ALL_MOUSE_EVENTS,NULL);

while(1)

{c=wgetch(menu_win);

switch(c)

{caseKEY_MOUSE:

if(getmouse(&event)==OK)

{/* 一旦用户按下左键 */

if(event.bstate&BUTTON1_PRESSED)

{report_choice(event.x+1,event.y+1,&choice);

if(choice==-1)//Exitchosen

gotoend;

mvprintw(22,1,"Choicemadeis:%dStringChosenis/"%10s/"",choice,choices[choice-1]);

refresh();

}

}

print_menu(menu_win,choice);

break;

}

}

end:

endwin();

return0;

}

voidprint_menu(WINDOW*menu_win,inthighlight)

{

intx,y,i;

x=2;

y=2;

box(menu_win,0,0);

for(i=0;i<n_choices;++i)

{if(highlight==i+1)

{wattron(menu_win,A_REVERSE);

mvwprintw(menu_win,y,x,"%s",choices[i]);

wattroff(menu_win,A_REVERSE);

}

else

mvwprintw(menu_win,y,x,"%s",choices[i]);

++y;

}

wrefresh(menu_win);

}

voidreport_choice(intmouse_x,intmouse_y,int*p_choice)

{inti,j,choice;

i=startx+2;

j=starty+3;

for(choice=0;choice<n_choices;++choice)

if(mouse_y==j+choice&&mouse_x>=i&&mouse_x<=i+strlen(choices[choice]))

{if(choice==n_choices-1)

*p_choice=-1;

else

*p_choice=choice+1;

break;

}

}