LabWindows/CVI虚拟仪器之： 移动控件

4.1 移动控件

4.1.1 移动控件设计方法

在应用程序中，面板是可以拖拽的，其他控件因不具备Movable 属性而不能移动。通常情况下，在运行时，控件设计好后很少会被移动到其他位置或者改变大小尺寸，而在程序设计阶段却需要经常改变。在程序运行期间，某些控件会影响界面的美观性，希望把它们挪个位置，以使界面更完美。对于一些游戏类开发，控件的移动是必需的功能，而且需要支持键盘和鼠标移动控件。LabWindows/CVI 在…CVIxxtoolslibcustctrl 目录下提供了movectrl.h 、movectrl.c 、movectrl.fp 、movectrl.sub 等文件，可以在运行时状态方便地拖拽控件，改变位置与大小。

对于一般开发工具而言，如Visual Basic 控件具有MouseDown 事件，可在其中用全局坐标变量OldX 和OldY 记录下鼠标按下时的位置，并使全局布尔型变量标识为True 用以标志鼠标被按下。在控件的MouseMove 事件中，如果标识为True ，则使该控件的左边界在原来的基础上加上水平方向的移动量(x - OldX) ，上边界在原来的基础上加上垂直方向的移动量(y - OldY)。在MouseUp 事件中，使标识变为False，表示鼠标已松开。在LabWindows/CVI 中，由于鼠标不支持MouseDown 事件，主要采用相近的鼠标事件EVENT_MOUSE_POINTER_MOVE 和EVENT_LEFT_CLICK 来记录OldX 和OldY，为控件的鼠标拖拽操作提供了一种思路。

4.1.2 移动控件程序设计

（1）面板设计

编写一个运行程序时，利用鼠标调整Graph 控件的大小和位置，当鼠标放置于控件内时，显示手形，此时可以按下鼠标左键移动控件，当鼠标放置于控件右侧、下侧或右下角时，显示箭头形状，按下鼠标左键拖拽控件，可改变控件的大小尺寸。控件移动采用面板回调函数实现，控件尺寸改变采用Timer 定时器控制实现。面板设计如图4-1 所示，面板中主要控件属性设置如表4-1 所示。

edatop.com

图4-1 移动控件面板

表4-1 控件属性设置表

（2）程序源代码

//头文件声明
#include
#include
#include "utility.h"
#include "移动控件.h"
static int panelHandle;
//主函数
int main (int argc, char *argv[])
{
if (InitCVIRTE (0, argv, 0) == 0)
return –1; /* out of memory */
if ((panelHandle = LoadPanel (0, " 移动控件.uir", PANEL)) < 0)
return –1;
DisplayPanel (panelHandle);
RunUserInterface ();
DiscardPanel (panelHandle);
return 0;
}
//面板回调函数
int CVICALLBACK PanelCB (int panel, int event, void *callbackData,
int eventData1, int eventData2)
{
int LeftButtonDown;
int y;
int x;
int CtrlTop;
int CtrlLeft;
int CursorStyle;
//局部静态变量，旧X、坐标值
static int OldX = 0;
static int OldY = 0;
switch (event)
{
//鼠标移动事件
case EVENT_MOUSE_POINTER_MOVE:
GetCtrlAttribute (panelHandle, PANEL_GRAPH, ATTR_LEFT, &CtrlLeft);

GetCtrlAttribute (panelHandle, PANEL_GRAPH, ATTR_TOP, &CtrlTop);
// 获得鼠标绝对位置、按键等属性
GetGlobalMouseState (&panel, &x, &y, &LeftButtonDown, NULL, NULL);
// 当鼠标左键按下时
if (LeftButtonDown == 1)
{
// 获得鼠标指针形状
GetMouseCursor (&CursorStyle);
if (CursorStyle == VAL_OPEN_HAND_CURSOR)
{
SetCtrlAttribute (panelHandle, PANEL_GRAPH, ATTR_LEFT, CtrlLeft + (x – OldX));
SetCtrlAttribute (panelHandle, PANEL_GRAPH, ATTR_TOP, CtrlTop + (y – OldY));
// 将旧X、Y 坐标值以当前新值代替
OldX = x;
OldY = y;
}
}
break; 
//鼠标左击事件
case EVENT_LEFT_CLICK:
// 获得鼠标绝对位置、按键等属性
GetGlobalMouseState (&panel, &x, &y, &LeftButtonDown, NULL, NULL);
// 获得鼠标指针形状
GetMouseCursor (&CursorStyle);
// 将旧X、坐标值以当前新值代替
if (CursorStyle == VAL_OPEN_HAND_CURSOR)
{
OldX = x;
OldY = y;
}
break;
//关闭面板事件
case EVENT_CLOSE:
QuitUserInterface (0);
break;
} 
return 0;
} 
//定时器
int CVICALLBACK timer (int panel, int control, int event,
void *callbackData, int eventData1, int eventData2)
{
int CtrlWidth;
int CtrlHeight;
int RightButtonDown;
int LeftButtonDown;
int y;
int x;
int CursorStyle;
//定义为局部静态变量，始终保存鼠标指针形状参数
static int MouseStyle = 0;
switch (event)
{
case EVENT_TIMER_TICK:
GetCtrlAttribute (panelHandle, PANEL_GRAPH, ATTR_HEIGHT, &CtrlHeight);
GetCtrlAttribute (panelHandle, PANEL_GRAPH, ATTR_WIDTH, &CtrlWidth);
//获得鼠标相对位置、按键等属性
GetRelativeMouseState (panel, PANEL_GRAPH, &x, &y, &LeftButtonDown, &RightButton
Down, NULL);
//判断鼠标相对控件位置
if (x > CtrlWidth – 5 && x < CtrlWidth + 5 && y > 0 && y < CtrlHeight)
{
//左右箭头
MouseStyle = 1;
}
if (y > CtrlHeight – 5 && y < CtrlHeight + 5 && x > 0 && x < CtrlWidth)
{
//上下箭头
MouseStyle = 2;
}
if (x > CtrlWidth – 5 && x < CtrlWidth + 5 && y > CtrlHeight – 5 && y < CtrlHeight + 5)
{
//"↖↘"箭头
MouseStyle = 3;
}
if (x > 5 && x < CtrlWidth – 5 && y > 5 && y < CtrlHeight – 5)
{
//手型箭头
MouseStyle = 4;
}
if (x < 0 || x > CtrlWidth + 5 || y < 0 || y > CtrlHeight + 5)
{
//默认箭头
MouseStyle = 0;
}
//设置鼠标指针形状
if (LeftButtonDown == 0)
{
switch (MouseStyle) {
case 0:
SetMouseCursor (VAL_DEFAULT_CURSOR);
break;
case 1:
SetMouseCursor (VAL_SIZE_EW_CURSOR); break;
case 2:
SetMouseCursor (VAL_SIZE_NS_CURSOR);
break;
case 3:
SetMouseCursor (VAL_SIZE_NW_SE_CURSOR); break;
case 4:
SetMouseCursor (VAL_OPEN_HAND_CURSOR);
break;
}
} // 设置控件大小
if (LeftButtonDown == 1 && x > 0 && y > 0) {
GetMouseCursor (&CursorStyle); switch (CursorStyle)
{ case VAL_SIZE_EW_CURSOR:
SetCtrlAttribute (panelHandle, PANEL_GRAPH, ATTR_WIDTH, x); break;
case VAL_SIZE_NS_CURSOR:
SetCtrlAttribute (panelHandle, PANEL_GRAPH, ATTR_HEIGHT, y);
break;
case VAL_SIZE_NW_SE_CURSOR:
SetCtrlAttribute (panelHandle, PANEL_GRAPH, ATTR_WIDTH, x); SetCtrlAttribute (panelHandle, PANEL_GRAPH, ATTR_HEIGHT, y);
break;
}
} break;
} return 0; 
} 

3:程序注释

① GetGlobalMouseState 函数获得鼠标状态信息，包括获得相对于屏幕的鼠标坐标。函数原型为：

int GetGlobalMouseState (int *Panel_Handle, int *XCoordinate, int *YCoordinate, int *Left_Button_ Down, int *Right_Button_Down, int *Key_Modifiers);

*Panel_Handle ：鼠标经过的面板句柄。如果鼠标没有经过面板，则值为0。如果不需要返回参数值，可输入NULL。

*XCoordinate：X轴坐标（相对于屏幕左侧边缘）。如果不需要返回参数值，可输入NULL。

*YCoordinate：Y轴坐标（相对于屏幕顶部）。如果不需要返回参数值，可输入NULL。

*Left_Button_Down ：鼠标左键状态。0 表示左键弹起，1 表示左键按下。如果不需要返回参数值，可输入NULL 。

*Right_Button_Down ：鼠标右键状态。0 表示右键弹起，1 表示右键按下。如果不需要返回参数值，可输入NULL 。

*Key_Modifiers ：是否有Ctrl 、Alt 和Shift 键被按下，如果没有键被按下时值为0，否则为VAL_MENUKEY_MODIFIER 、VAL_UNDERLINE_MODIFIER 、VAL_SHIFT_MODIFIER 和VAL_SHIFT_AND_MENUKEY 按位或操作结果。常量说明如表4-2 所示。

表4-2 Key Modifiers 参数表

② GetMouseCursor 函数返回鼠标指针形状参数。函数原型为：

int GetMouseCursor (int *Mouse_Cursor_Style);

*Mouse_Cursor_Style ：鼠标指针形状值。指针形状说明如表4-3 所示。

表4-3 鼠标指针参数表

③ GetRelativeMouseState 函数

获得鼠标状态信息，包括获得相对于控件的鼠标坐标。如果Control_ID 为0，返回相对于面板的坐标。函数原型为：

int GetRelativeMouseState (int Panel_Handle, int Control_ID, int *XCoordinate, int *YCoordinate, int *Left_Button_Down, int *Right_Button_Down, int *Key_Modifiers);

④ SetMouseCursor 函数设置鼠标指针形状参数。函数原型为：

int SetMouseCursor (int Mouse_Cursor_Style);

⑤ 控件拖拽操作

在LabWindows/CVI 中，虽然有鼠标的拖拽操作函数，但主要是针对文件拖拽功能的EnableDragAndDrop 函数，需要为面板回调函数安装EVENT_FILESDROPPED 事件，很难用于控件的拖拽操作。在本例程中，利用GetGlobalMouseState 函数查询鼠标左键是否被按下，利用面板EVENT_MOUSE_POINTER_MOVE 事件来响应控件拖拽操作，并确定控件的新位置。对于EVENT_LEFT_CLICK 事件，只是在鼠标点击时会产生触发响应，而EVENT_MOUSE_POINTER_ MOVE 事件只要鼠标移动就会产生，具有实时响应特性，因此，拖拽操作的主要过程可以写在该事件中。EVENT_LEFT_CLICK 事件的作用是更新一次点击操作完成后的新的X和Y轴坐标。另外，改变控件大小的代码写到了Timer 控件里，并且，当鼠标处于控件的左侧边缘、下部边缘以及左下角时，鼠标会显示不同的形状，当按下鼠标时，通过实时响应鼠标相对于控件的坐标位置来调整控件的尺寸大小。

（4）运行效果图

点击工具栏中的Debug Project 按钮，程序开始运行，其效果如图4-2 所示。

edatop.com

4-2 运行效果图