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

时间:2024-10-14 11:03:38

常用的处理窗体的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;//调用DLLIMPORT namespace 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, );
Console.ReadKey();
} //实例化回调函数(可以在回调函数中根据窗体名称找到目标窗体句柄)
public static bool Report(int hwnd,int lparm)
{
//分配空间
var sb = new StringBuilder();
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();
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, , ); //发送点击按钮的消息
}
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; {返回类名大小; 失败返回 }获取指定窗口的类名
GetNextWindow(
hWnd: HWND; {指定的窗口句柄}
uCmd: UINT {指定的关系选项}
): HWND; {失败返回0; 成功返回符合的窗口句柄}
//uCmd 可选值:
GW_HWNDNEXT = ; {同级别 Z 序之下}
GW_HWNDPREV = ; {同级别 Z 序之上}获取指定窗口Z上或Z下的窗口的句柄
GetTopWindow(
hWnd: HWND; {指定的窗口句柄}
): HWND; {失败返回0; 成功返回最顶层的子窗口句柄}获取指定窗口的子窗口中最顶层的窗口句柄
GetWindow(
hWnd: HWND; {指定的窗口句柄}
uCmd: UINT {指定的关系选项}
): HWND; {失败返回0; 成功返回符合的窗口句柄}
//uCmd 可选值:
GW_HWNDFIRST = ; {同级别第一个}
GW_HWNDLAST = ; {同级别最后一个}
GW_HWNDNEXT = ; {同级别下一个}
GW_HWNDPREV = ; {同级别上一个}
GW_OWNER = ; {属主窗口}
GW_CHILD = ; {子窗口}获取与指定窗口具有指定关系的窗口的句柄
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(-);
static readonly IntPtr HWND_NOTOPMOST = new IntPtr(-);
static readonly IntPtr HWND_TOP = new IntPtr();
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;