C# 窗体常用API函数 应用程序窗体查找

常用的处理窗体的API函数如下（注意：API函数必须放在窗体中...）：

使用C#语言，要引用DllImport，必须要添加using System.Runtime.InteropServices命名空间

（1）获得当前前台窗体句柄

[DllImport("user32.dll", CharSet = CharSet.Auto, ExactSpelling = true)]public static extern IntPtr GetForegroundWindow();

返回值类型是IntPtr,即为当前获得焦点窗口的句柄

使用方法 : 

IntPtr myPtr=GetForegroundWindow();

（2）枚举所有屏幕上的顶层窗口，并将窗口句柄传送给应用程序定义的回调函数，利用该法可以获得所有当前打开的窗体的句柄信息

[DllImport("user32.dll")]public static extern bool EnumWindows（WNDENUMPROC lpEnumFunc，LPARAM lParam）;

其中lpEnumFunc指向一个应用程序定义的回调函数指针；

lparam指向一个传递给回调函数的应用程序的定义值；

回调函数原型

bool CALLBACK EnumWindowsProc(HWND hwnd,LPARAM lparam);

其中hwnd是一个顶层窗口的句柄

lparam是一个应用程序定义的一个值(即EnumWindows中lParam)

下面用一个例子对该方法说明

程序中要实现一个功能：可以在当前打开的窗体中找到目标窗体，并在需要时将其激活，置为前台窗体

using System;using System.Collections.Generic;using System.Linq;using System.Text;using System.Runtime.InteropServices;//调用DLLIMPORTnamespace EmuWindowInfor{  /// <summary>  /// 调用API的EnumWindows来枚举窗口  /// </summary>  class Program  {    //定义句柄的全局变量    public int HANDLE;    //定义回调函数的委托    public delegate bool CALLBACK(int hwnd,int lparm);    //用于获取前台窗口句柄,设置当前窗口句柄    [DllImport("user32.dll")]    public static extern int EnumWindows(CALLBACK x, int y);    [DllImport("user32.dll", CharSet = CharSet.Auto)]    static extern int GetWindowText(int hWnd, StringBuilder lpText, int nCount);    static void Main(string[] args)    {      CALLBACK myCallBack = new CALLBACK(Report);      EnumWindows(myCallBack, 0);      Console.ReadKey();    }    //实例化回调函数(可以在回调函数中根据窗体名称找到目标窗体句柄)    public static bool Report(int hwnd,int lparm)    {      //分配空间      var sb = new StringBuilder(50);      GetWindowText(hwnd, sb, sb.Capacity);      //注意某些窗口没有标题      if (sb.ToString() != String.Empty)        Console.WriteLine(sb.ToString());      //if (sb.ToString() == "Microsoft PowerPoint - [les_03_使用_rman [兼容模式]]")      //  Console.WriteLine(hwnd.ToString());      //回调函数有返回值      return true;    }  }}

以上代码实现了通过窗体名称找到目标窗体的句柄，再利用API函数SetForegroundWindow来将该窗体激活并前置

[DllImport("user32.dll")]public static extern bool SetForegroundWindow(int hWnd);

其中hWnd就是目标窗体的句柄

（3）根据窗体的类名和窗口的名称获得目标窗体

[DllImport("coredll.dll", EntryPoint = "FindWindow")]private extern static IntPtr FindWindow(string lpClassName, string lpWindowName);

如果coredll.dll，出现找不到，可以使用user32.dll代替

[DllImport("user32.dll", EntryPoint = "FindWindow")]private extern static IntPtr FindWindow(string lpClassName, string lpWindowName);

其中lpClassName是要找的窗口的类

lpWindowName是要找的窗口的标题，当然在搜索的时候不一定两者都要知道，但至少要知道一个。根据窗口标题查找的一般多用在多窗口的应用程序中，因为程序中的窗体标题固定，方便搜索。但要是对于系统中的一些窗体，例如记事本窗体，PPT等，窗体的标题是不定的，所以用窗口类搜索更方便。当然有关常见的窗口类可以很方便找到，下面是一个搜索当前打开文本文档的窗口句柄的代码

IntPtr ParenthWnd = new IntPtr(0);ParenthWnd = FindWindow(null,"窗口标题");//或者用ParenthWnd = FindWindow("窗口类名",null);//判断这个窗体是否有效if (ParenthWnd != IntPtr.Zero){  MessageBox.Show("找到窗口");}else{  MessageBox.Show("没有找到窗口");}

可以使用工具AccExplorer32.exe来查找窗口所属的类和窗体的标题。

如果用VC开发平台，可以使用其中的Spy快速的找到窗口的类型，在Spy++中有一个FindWindow工具，它允许你使用鼠标选择窗口，然后Spy++会显示这个窗口的类。

同时在微软的帮助文档中也给出了对微软常用OFFICE工具窗体句柄查找的方法，同样是用FindWindow（）方法，链接：http://support.microsoft.com/kb/302295/zh-cn

（4）查找子窗体的方法

[DllImport("user32.dll", EntryPoint = "FindWindow")]private static extern IntPtr FindWindowEx( IntPtr hwndParent, IntPtr hwndChildAfter, string lpszClass, string lpszWindow );

其中hwndParent是要查找子窗口的父窗口句柄，如果hwndParent为Null，则函数以桌面窗口为父窗口，查找桌面窗口的所有子窗口；如果hwndParent是HWND_MESSAGE,函数仅查找所有消息窗口；

    hwndChildAfter ：子窗口句柄。查找从在Z序中的下一个子窗口开始。子窗口必须为hwndPareRt窗口的直接子窗口而非后代窗口。如果HwndChildAfter为NULL，查找从hwndParent的第一个子窗口开始。如果hwndParent 和 hwndChildAfter同时为NULL，则函数查找所有的顶层窗口及消息窗口。

    lpszClass：指向一个指定了类名的空结束字符串，或一个标识类名字符串的成员的指针。如果该参数为一个成员，则它必须为前次调用theGlobaIAddAtom函数产生的全局成员。该成员为16位，必须位于lpClassName的低16位，高位必须为0。

    lpszWindow：指向一个指定了窗口名（窗口标题）的空结束字符串。如果该参数为 NULL，则为所有窗口全匹配。返回值：如果函数成功，返回值为具有指定类名和窗口名的窗口句柄。如果函数失败，返回值为NULL。总之，这个函数查找子窗口，从排在给定的子窗口后面的下一个子窗口开始。在查找时不区分大小写。

下面通过一个简单的例子来说明对子窗口的查找。相信大家都有QQ号，那么就写一个简单的外挂：通过查找QQ登陆窗口并模拟按键实现QQ的自动登陆，以下只是介绍其中如何通过父窗体查找子窗体

const int BM_CLICK = 0xF5; IntPtr maindHwnd = FindWindow(null, "QQ用户登录"); //获得QQ登陆框的句柄 if (maindHwnd != IntPtr.Zero) {   IntPtr childHwnd = FindWindowEx(maindHwnd, IntPtr.Zero, null, "登录");  //获得按钮的句柄   if (childHwnd != IntPtr.Zero)   {     SendMessage(childHwnd, BM_CLICK, 0, 0);   //发送点击按钮的消息   }   else   {     MessageBox.Show("没有找到子窗口");   } } else {   MessageBox.Show("没有找到窗口"); }

（5）找到窗体后对其的简单处理，比如开关，隐藏

[DllImport("user32.dll", CharSet = CharSet.Auto, ExactSpelling = true)]public static extern int ShowWindow(IntPtr hwnd, int nCmdShow);

其中ShowWindow(IntPtr hwnd, int nCmdShow);

nCmdShow的含义

0    关闭窗口

1    正常大小显示窗口

2    最小化窗口

3    最大化窗口

（6）获取窗口大小及位置

[DllImport("user32.dll")][return: MarshalAs(UnmanagedType.Bool)]static extern bool GetWindowRect(IntPtr hWnd, ref RECT lpRect);  [StructLayout(LayoutKind.Sequential)]  public struct RECT   {     public int Left;               //最左坐标      public int Top;               //最上坐标      public int Right;              //最右坐标      public int Bottom;            //最下坐标   }示例:   InPtr awin = GetForegroundWindow();  //获取当前窗口句柄   RECT rect = new RECT();   GetWindowRect(awin, ref rect);   int width = rc.Right - rc.Left;            //窗口的宽度   int height = rc.Bottom - rc.Top;          //窗口的高度   int x = rc.Left;                          int y = rc.Top;

（7）常用操作：

GetClassName( hWnd: HWND;     {指定窗口句柄} lpClassName: PChar; {缓冲区} nMaxCount: Integer {缓冲区大小}): Integer;      {返回类名大小; 失败返回 0}获取指定窗口的类名 GetNextWindow( hWnd: HWND; {指定的窗口句柄} uCmd: UINT {指定的关系选项}): HWND;   {失败返回0; 成功返回符合的窗口句柄}//uCmd 可选值:GW_HWNDNEXT = 2; {同级别 Z 序之下}GW_HWNDPREV = 3; {同级别 Z 序之上}获取指定窗口Z上或Z下的窗口的句柄 GetTopWindow( hWnd: HWND; {指定的窗口句柄}): HWND;   {失败返回0; 成功返回最顶层的子窗口句柄}获取指定窗口的子窗口中最顶层的窗口句柄GetWindow( hWnd: HWND; {指定的窗口句柄} uCmd: UINT {指定的关系选项}): HWND;   {失败返回0; 成功返回符合的窗口句柄}//uCmd 可选值:GW_HWNDFIRST = 0; {同级别第一个}GW_HWNDLAST = 1; {同级别最后一个}GW_HWNDNEXT = 2; {同级别下一个}GW_HWNDPREV = 3; {同级别上一个}GW_OWNER   = 4; {属主窗口}GW_CHILD   = 5; {子窗口}获取与指定窗口具有指定关系的窗口的句柄 GetWindowTextLength( hWnd: HWND {窗口句柄}): Integer; {返回窗口标题长度} 获取窗口标题长度 SetWindowText( hWnd: HWND;   {窗口句柄} lpString: PChar {新标题串指针}): BOOL;设置窗口标题 GetDesktopWindow: HWND; {无参数; 返回桌面窗口的句柄}

前面我们提到找到目标句柄后通过SetForeGroudWindow(int hwnd)方法可以将其激活并设置为前台窗口，但是如果只是想将其激活而不设置为前台的话就要用到函数SetActiveWindow()

但是使用该方法要特别注意，当在其他线程中对当前线程窗体进行激活使用该方法是没有作用的。

想在找到目标窗体的前提下，让目标窗体和其它窗体同时出现在桌面上，同时要保证只有目标窗体是处于激活状态，也就是说只有目标窗体可以接受到模拟按键消息。终于找到了，可以通过SetForwardWindow(int handle)方法将目标窗体激活并处于最前窗体。同时利用另外一个API函数SetWindowPos来设置其他窗体，使其可以同处桌面。下面就简单介绍下这个方法：

static extern bool SetWindowPos(　　HWND hWnd, //窗口句柄　　HWND hWndInsertAfter, //排列顺序的句柄　　int X, //水平坐标　　int Y, //垂直坐标　　int cx, //宽　　int cy, //高　　UINT uFlags //窗口定位标识　　);

其中

返回值：

BOOL，如果返回值非零表示成功，返回零表示失败。错误信息请参看GetLastError函数。

参数表：

参数 类型及说明 
hwnd HWND，欲定位的窗口句柄 
hWndInsertAfter HWND，置于hwnd前面的窗口句柄。这个参数必须是窗口的句柄或是下面的值之一：  HWND_BOTTOM 将窗口置于其它所有窗口的底部 
HWND_NOTOPMOST 将窗口置于其它所有窗口的顶部，并位于任何最顶部窗口的后面。如果这个窗口非顶部窗口，这个标记对该窗口并不产生影响 
HWND_TOP 将窗口置于它所有窗口的顶部 
HWND_TOPMOST 将窗口置于其它所有窗口的顶部，并位于任何最顶部窗口的前面。即使这个窗口不是活动窗口，也维持最顶部状态

x：
int，指定窗口新的X坐标

Y：

int，指定窗口新的Y坐标

cx：

int，指定窗口新的宽度

cy：

int，指定窗口新的高度

wFlags：

UINT，指定窗口状态和位置的标记。这个参数使用下面值的组合： SWP_DRAWFRAME 围绕窗口画一个框 
SWP_FRAMECHANGED 发送一条WM_NCCALCSIZE消息进入窗口，即使窗口的大小没有发生改变。如果不指定这个参数，消息WM_NCCALCSIZE只有在窗口大小发生改变时才发送 
SWP_HIDEWINDOW 隐藏窗口 
SWP_NOACTIVATE 不激活窗口 
SWP_NOCOPYBITS 屏蔽客户区域 
SWP_NOMOVE 保持当前位置（X和Y参数将被忽略） 
SWP_NOOWNERZORDER 不改变所有窗口的位置和排列顺序 
SWP_NOREDRAW 窗口不自动重画 
SWP_NOREPOSITION 与SWP_NOOWNERZORDER标记相同 
SWP_NOSENDCHANGING 防止这个窗口接受WM_WINDOWPOSCHANGING消息 
SWP_NOSIZE 保持当前大小（cx和cy会被忽略） 
SWP_NOZORDER 保持窗口在列表的当前位置（hWndInsertAfter将被忽略） 
SWP_SHOWWINDOW 显示窗口 
备注：

如果设置了SWP_SHOWWINDOW或SWP_HIDEWINDOW标记，这个窗口不发生移动或改变大小。窗口成为最顶级窗口后，它的所有子窗口也会进入最顶级。一旦将其设为非最顶级，则它的所有子窗口也会转为非最顶级。

程序中引用如下：

[DllImport("user32.dll", EntryPoint = "SetWindowPos")]static extern bool SetWindowPos(IntPtr hWnd,IntPtr hWndInsertAfter,int X,int Y,int cx,int cy,uint uFlags);static readonly IntPtr HWND_TOPMOST = new IntPtr(-1);static readonly IntPtr HWND_NOTOPMOST = new IntPtr(-2);static readonly IntPtr HWND_TOP = new IntPtr(0);const UInt32 SWP_NOSIZE = 0x0001;const UInt32 SWP_NOMOVE = 0x0002;const UInt32 SWP_NOZORDER = 0x0004;const UInt32 SWP_NOREDRAW = 0x0008;const UInt32 SWP_NOACTIVATE = 0x0010;const UInt32 SWP_FRAMECHANGED = 0x0020;const UInt32 SWP_SHOWWINDOW = 0x0040;const UInt32 SWP_HIDEWINDOW = 0x0080;const UInt32 SWP_NOCOPYBITS = 0x0100;const UInt32 SWP_NOOWNERZORDER = 0x0200;const UInt32 SWP_NOSENDCHANGING = 0x0400;const UInt32 TOPMOST_FLAGS = SWP_NOMOVE | SWP_NOSIZE;

原标题：C# 窗体常用API函数 应用程序窗体查找

关键词：C#