基于Window32 API的UI测试

句柄，

     是整个windows编程的基础，一个句柄是指使用的一个唯一的整数值，是指一个四字节长的数值，用于标志应用程序中的不同对象和同类对象中的不同的实例，诸如，一个窗口，按钮，图标，滚动条，输出设备，控件或者文件等，应用程序能够通过句柄访问相应的对象的信息。但是，句柄不是一个指针，程序不能利用它句柄来直接阅读文件中的信息。如果句柄不用在I/O文件中，它是毫无用处的。 句柄是windows用来标志应用程序中建立的或是使用的唯一整数，windows使用了大量的句柄来标志很多对象。

 

     WINDOWS程序中并不是用物理地址来标识一个内存块，文件，任务或动态装入模块的。相反，WINDOWS API给这些项目分配确定的句柄，并将句柄返回给应用程序，然后通过句柄来进行操作。

     句柄是WINDOWS用来标识被应用程序所建立或使用的对象的唯一整数，WINDOWS使用各种各样的句柄标识诸如应用程序实例，窗口，控制，位图，GDI对象等等。WINDOWS句柄有点象C语言中的文件句柄。

 

　　从上面的2个定义中我们可以看到，句柄是一个标识符，是拿来标识对象或者项目的。它就像我们的车牌号一样，每一辆注册过的车都会有一个确定的号码，不同的车号码各不相同，但是也可能会在不同的时期出现两辆号码相同的车，只不过它们不会同时处于使用之中罢了。从数据类型上来看它只是一个32位的无符号整数。应用程序几乎总是通过调用一个WINDOWS函数来获得一个句柄，之后其他的WINDOWS函数就可以使用该句柄，以引用相应的对象。在WINDOWS编程中会用到大量的句柄，比如：HINSTANCE（实例句柄），HBITMAP（位图句柄），HDC（设备描述表句柄），HICON（图标句柄）等等。这当中还有一个通用的句柄，就是HANDLE。

 

      内核对象句柄，是用来标识某个内核对象的一个ID　同一个对象的该id对于每个进程是不同的，具体如何实现是ms不公开的算法，以下是一个近似的，可能的算法：

　　进程创建时，windows系统为进程构造了一个句柄表

　　当该进程希望获得一个内核对象句柄或者创建一个内核对象从而获得该对象句柄时

　　系统会将在句柄表中增加一个表项，表项的内容中存储了指向目标内核对象的指针

　　同时，系统返回这个表项在句柄表中的索引作为句柄

　　

　　这样，进程就通过句柄查询句柄表得到对象指针，从而可以访问该对象。

　　同时又由于有了句柄表的保护，可以防止对内核对象的非法操作。

using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Diagnostics; using System.Reflection; using System.Runtime.InteropServices; using System.Threading; namespace TestingNotePad { class Program { #region 引用System.Runtime.InteropServices下的DLLImport方法和P/Invoke机制 //通过.NET P/Invoke机制，使用Win32 API函数FindWindow() [DllImport("user32.dll", EntryPoint = "FindWindow", CharSet = CharSet.Auto)] static extern IntPtr FindWindow(string lpClassName, string lpWindowName); //通过.NET P/Invoke机制，使用Win32 API函数FindWindowEx() [DllImport("user32.dll", EntryPoint = "FindWindowEx", CharSet = CharSet.Auto)] static extern IntPtr FindCtrl(IntPtr hwndWindow, IntPtr hwndStartCtrl, string lpszClass, string lpCtrlName); //使用Win32的SendMessage()函数以及WM_CHAR消息，发送字符给控件 [DllImport("user32.dll", EntryPoint = "SendMessage", CharSet = CharSet.Auto)] static extern void SendMessageToCtrl//第一个参数是目标窗体/控件的句柄；第二个参数是要发给该控件的Windows消息； //wParam指定的是被按下按键的字符代码, lParam指定的是不同的按键状态掩码，比如重复次数，扫描码，扩展键标识等. (IntPtr hwndWindow, uint Msg, int wParam, int lParam);//第三四个参数的意思和数据类型取决于相应的Windows消息。 //使用Win32的PostMessage()函数以及WM_LBUTTONDOWN和WM_LBUTTONUP消息 [DllImport("user32.dll", EntryPoint = "PostMessage", CharSet = CharSet.Auto)] static extern bool PostMessage1//第二个参数Msg是要发给该控件的Windows消息 //所有的Windows消息都有可能要求不同的数据类型. (IntPtr hwndWindow, uint Msg, int wParam, int lParam); #endregion [STAThread] static void Main(string[] args) { #region 运行待测程序 //Launch the app which need to be tested. try { Console.WriteLine("/nLaunching the application under test..."); /*process.start()方法有四个不同的重载版本，常用的是有一个参数的和有两个参数的两个： Process.Start(string fileName) Process.Start(string fileName, string Arguments) Arguments代表待启动程序的命令行参数 */ //Testing Notepad. //string path = @"C:/Windows/System32/notepad.exe"; //string path1 = @"C:/Users/btslabs/Desktop/TE/WinUiTesting/TestingCode/Somefile.txt"; //Process p = Process.Start(path,path1); string path = @"C:/Users/btslabs/Desktop/TE/UI_AUT/AUT/bin/Debug/AUT.exe"; Process p = Process.Start(path); if (p == null) { Console.WriteLine("Warning: process may already exist"); } //Run the test scenario here //..................................... Console.WriteLine("/nThe app under test launched!"); } catch (Exception MainException) { Console.WriteLine("Fatal error : {0}", MainException.Message); } #endregion //获得待测程序主窗体句柄 IntPtr MwdHandle = FindMainWindowHandle("Form1"); //获得窗体上一个控件的句柄 IntPtr butt = FindCtrlHandle(MwdHandle, "button1"); //获得窗体上一个无名控件的句柄 IntPtr ctrlHandle3 = FindCtrlByIndex(MwdHandle,3); Console.WriteLine("The 3th ctrl's handle is: "+ctrlHandle3.ToString()); //给index为3的控件发送字符C SendChar(ctrlHandle3, 'C'); //发送字符串给控件 IntPtr ctrlHandle4 = FindCtrlByIndex(MwdHandle, 4); SendString(ctrlHandle4, "Hello world"); //点击button1 for (int i = 0; i <3; i++) { ClickOn(butt); } Console.ReadKey(); } #region 获得待测程序主窗体句柄 static IntPtr FindMainWindowHandle(string MwdCaption) { try { IntPtr mwh = IntPtr.Zero;//主窗体句柄 bool formFonud = false; int attempts = 0; do { if (mwh == IntPtr.Zero) { Console.WriteLine("Form not yet found"); Thread.Sleep(100); ++attempts; //The second para is a windows caption. Console.WriteLine("Form finding....."); mwh = FindWindow(null, MwdCaption); } else { Console.WriteLine("Form has been found"); Console.WriteLine("Via the P-Invoke method, we get an {0} value of the form", mwh.GetType().ToString()); formFonud = true; } } while (!formFonud && attempts < 25); if (mwh != IntPtr.Zero) return mwh; else throw new Exception("Could not find main window!"); } catch (Exception MwdhException) { Console.WriteLine("Fatal error in getting the Main window handle: " + MwdhException.Message); return IntPtr.Zero; } } #endregion #region 获得待测窗体中有名字控件的句柄 static IntPtr FindCtrlHandle(IntPtr MwdH, string CtrlCaption) { Console.WriteLine("Now, start to find the ctrl handle..."); /*要访问并且操纵窗体上的控件，必须获得该控件的句柄。 在Windows环境下，所有的GUI控件本身都是窗体。button是一个窗体，textbox也是一个窗体…… 要得到一个控件/窗体的句柄，要调用Win32 API函数FindWindowEx()。*/ try { int attemptC = 0; bool ctrlFound = false; IntPtr CtrlH = IntPtr.Zero; do { if (CtrlH == IntPtr.Zero) { CtrlH = FindCtrl(MwdH,IntPtr.Zero,null,CtrlCaption); Thread.Sleep(100); ++attemptC; } else { Console.WriteLine("Ctrl found! it is {0}",CtrlH); ctrlFound = true; } } while (!ctrlFound && attemptC < 35); if (CtrlH != IntPtr.Zero) return CtrlH; else throw new Exception("Couldn't find the ctrl "); } catch (Exception ctrlFoundException) { Console.WriteLine("Fatal error: " + ctrlFoundException.Message + CtrlCaption); return IntPtr.Zero; } } #endregion #region 获得窗体上一个无名控件的句柄 //通过Index来获取,通过无名控件的顺序索引值来返回控件的句柄 static IntPtr FindCtrlByIndex(IntPtr MwdH, int index) { try { if(index==0) { return MwdH; } else { int ct = 0; IntPtr result = IntPtr.Zero; do { //FindWindowEx()的第二个参数指定该方法从什么地方开始查找 result =FindCtrl(MwdH, result, null, null); if (result != IntPtr.Zero) ++ct; Console.WriteLine("The handle of ctrl{0} is {1}.",ct, result); } while (ct < index && result != IntPtr.Zero); return result; } } catch (Exception ex) { Console.WriteLine("Fatal error:" + ex.Message); return IntPtr.Zero; } } #endregion #region 发送字符给控件 //使用Win32的SendMessage()函数以及WM_CHAR消息，发送字符给控件 static void SendChar(IntPtr TrgCtrl, char c) { Console.WriteLine("Now, Begining to send {0} to ctrl {1}...", c, TrgCtrl.ToString()); uint WM_CHAR = 0x0102;//WM_CHAR 是一个Windows常量符号，它定义为0x0102 SendMessageToCtrl(TrgCtrl, WM_CHAR, c, 0); } //使用Win32的SendMessage()函数以及WM_CHAR消息，发送字符串给控件 static void SendString(IntPtr TrgCtrl, string s) { Console.WriteLine("Now, Begining to send {0} to ctrl {1}...", s, TrgCtrl.ToString()); foreach (char c in s) { SendChar(TrgCtrl, c); } } #endregion #region 鼠标单击一个控件 //使用Win32的PostMessage()函数以及WM_LBUTTONDOWN和WM_LBUTTONUP消息 static void ClickOn(IntPtr CtrlClick) { Console.WriteLine("Clicking On CtrlClick: button1"); uint WM_LBUTTONDOWN = 0x0201; uint WM_LBUTTONUP = 0x0202; //一个点击的动作就是“先下后上” PostMessage1(CtrlClick, WM_LBUTTONDOWN, 0, 0); PostMessage1(CtrlClick, WM_LBUTTONUP, 0, 0); } #endregion } }