1、第 1 章 Windows 系统的消息机制对诸如 PowerBuilder(后文简写为 PB)、Visual Basic 和 Dephi 等大多数可视化程序设计语言来讲,程序设计的核心是对象的事件、属性和方法,但对 Windows 系统本身而言,却是以消息处理为其控制机制。Windows 把系统中的对象都作为窗口来对待,每个窗口都有一个用来标识其身份的句柄。Windows 通过向窗口发送消息,在开发语言中转化为对象的事件,然后驱动对象,响应用户的动作。在许多面向对象的可视化程序设计语言中,Windows 的众多消息已经演变成了对象的属性或方法。本章内容包括 Windows 系统的消息机制、消息
2、的发送、消息的应用实例等。1.1 Windows 的工作机制1.1.1 Windows 的工作方式窗口、事件和消息全面地讨论 Windows 的内部工作机制需要很大的篇幅,对于一般的 PB 用户当然没有必要深入了解所有的技术细节。Windows 系统的工作机制,简单地说就是 3 个关键的概念:窗口、事件和消息。不妨简单地将窗口看做带有边界的矩形区域。读者也许已经了解多种不同类型的窗口,如 Windows 系统的“资源管理器 ”窗口、文字处理程序中的文档窗口或者弹出提示有约会信息的消息对话框窗口等。除了这些最普通的窗口外,实际上还有许多其他类型的窗口。命令按钮是一个窗口,图标、文本框、选项按钮和
3、菜单条也都是窗口。Windows 操作系统通过给每一个窗口指定一个惟一的标识号(窗口句柄,常用 hWnd 表示)来管理所有的窗口。操作系统连续地监视每一个窗口的活动或事件的信号。事件可以通过诸如单击鼠标或按下按键的操作而产生,也可以通过程序的控制而产生,甚至可以由另一个窗口的操作而产生。每发生一次事件,将引发一条消息发送至操作系统。操作系统处理该消息并广播给其他窗口。然后,每一个窗口才能根据自身处理该条消息的指令而采取适当的操作(例如,当窗口解除了其他窗口的覆盖时,重新绘制自身窗口)。可以想象,处理各种窗口、事件和消息的所有可能的组合将有惊人的工作量。幸运的是,PB 使用户摆脱了所有的低层消息
4、处理。许多消息由 PB 自动处理了,其他的作为事件过程由编程者自行处理,这样可以快速创建强大的应用程序,而毋需涉及不必要的细节。1.1.2 句柄的概念在解释消息之前,首先了解系统如何准确地将消息发送到指定的窗口。当一个应用或多第 1 章 Windows 系统的消息机制 3个应用运行后,会同时创建许多个窗口,Windows 作为系统的“大总管”,那么它又是如何识别每一个窗口呢?在程序设计时,通过窗口的名称属性,为每个窗口命名,然后在程序其他部分把窗口名作为识别窗口的标识。这种通过为窗口命名来识别不同窗口的方法,对Windows 系统来讲显然是不现实的。 Windows 系统是通过称之为句柄的标识
5、符来识别每一个窗口。句柄是系统动态分配给窗口的 32 位整型数标识值,常用 hWnd 表示,即英文 handle to a window 的缩写。大量 API 函数都需要窗口句柄作参数,或返回一个窗口或设备场境的句柄。句柄可以通俗地理解为 Windows 为系统中所有存在的窗口动态分配的身份识别号码。在 PB 中,可以通过 handle 函数来取得窗口和控件的句柄,当声明 API 函数时,常把保存句柄的变量声明为 Long 或 Ulong 长整型数据类型。Windows 为窗口和控件分配句柄标识是动态,同样的程序每次运行时和在不同计算机上运行时所分配的窗口句柄标识可能是完全不一样的。窗口的句柄
6、属性仅能在运行时访问,该属性对窗口的外观并没有任何影响,它仅作为API 函数调用的参数或返回值,或其他需识别窗口或对象的地方。在后面章节中,读者将会看到几乎所有涉及窗口的 API 函数都需要传递 hWnd 参数,以便函数准确获得用户要处理的窗口或对象。句柄作为由操作系统定义的惟一的长整型值,可以用它来引用窗体和控件等对象。在Windows 系统中,API 函数的调用常用的句柄包括窗口句柄,菜单句柄、设备对象句柄、设备场景句柄,等等。如果函数需要用句柄作为参数,则应该把参数声明为传值,对于返回句柄的 API 函数,应将返回的句柄值声明为 Long 或 Ulong 类型数据类型。句柄是一种标识符(
7、ID)编号,而不是指针或者数值,不要试图对它们进行任何数学运算。1.1.3 消息的概念Windows 系统是以消息处理为其控制机制,系统通过消息为窗口过程(windows procedure)传递输入。系统和应用两者都可以产生消息。对于每个输入事件,例如用户按下了键盘上的某个键、移动了鼠标、单击了一个控件上的滚动条,等等,系统都将产生一系列消息。此外,对于应用带给系统的变化,如字体资源的改变、应用本身窗口的改变,系统都将通过消息以响应这种变化。应用通过产生消息指示应用的窗口完成特定的任务,或与其他应用的窗口进行通信。每个窗口都有一个处理 Windows 系统发送消息的处理程序,称为窗口程序。它
8、是隐含在窗口背后的一段程序脚本,其中包含对事件进行处理的代码。Windows 系 统 为 每 条 消 息 指 定 了 一 个 消 息 编 号 , 例 如 当 一 个 窗 口 变 为 活 动 窗 口 时 , 它 事实 上 是 收 到 一 条 来 自 Windows 系 统 的 WM_ACTIVATE 消 息 , 该 消 息 的 编 号 为 6, 它 对 应 于PB 窗 口 的 Activate 事 件 。 对 于 窗 口 来 说 , 诸 如 Open、 Activate、 MouseDown、 Resize 等 事 件 ,实 际 上 对 应 的 是 窗 口 内 部 的 消 息 处 理 程 序 ,
9、 这 些 程 序 对 于 用 户 来 讲 是 不 可 见 的 。 类 似 地 , 命令 按 钮 也 有 消 息 处 理 程 序 , 它 的 处 理 程 序 响 应 诸 如 WM_LBUTTONDOWN 和WM_RBUTTONDOWN 之类的消息,即激活命令按钮的 MouseDown 事件。系统向窗口发送的消息通常包含 3 个参数,分别是:PowerBuilder Win32 API 程序设计(高级卷)4(1)窗口句柄(a window handle):窗口句柄用来标识消息将要发送到的窗口对象,系统使用窗口句柄来确定哪一个窗口句柄应该接收该消息。(2)消息标识符(a message identi
10、fier):消息标识符是用来区分不同消息的命名常量,当窗口过程接收到一个消息时,它使用消息标识符来确定如何处理该消息。例如,消息标识符 WM_PAINT 告诉窗口过程“窗口的客户区已经发生变化,窗口必须进行重新绘制”。(3)消息参数(message parameters):消息参数用来表述窗口过程处理消息时所使用的数据或数据的位置,通常用一对参数表示。消息参数的意义和取值取决于消息。消息参数取值可以是整型数、Bit 位标识、指向结构的指针,等等,当不需要使用消息参数时,通常将其设置为 NULL。窗口过程必须通过检查消息标识符来确定如何对消息参数进行解释。有关消息标识符、消息参数的具体使用,将在
11、后面介绍 Sendmessage 函数时给予进一步 解释。1.1.4 消息的类型1系统定义的消息当系统与应用进行通信时,系统将发送或邮寄消息。系统通过这些消息控制应用的运行,并为应用的进程提供输入或其他信息。应用内部也可发送或邮寄系统定义的消息,应用通常使用这些消息控制由预先注册的窗口类创建的窗口的操作。每一个系统定义的消息都有一个惟一的消息标识符(值),并用一个表明消息用途标识符常量表示(这些在 SDK 的头文件中定义)。如 WM_PAINT 消息标识符表示要求窗口进行重绘的消息。消息标识符常量前缀表示消息所属的消息类别,如 WM_表示窗口类消息,BM_表示按钮类消息,表 1-1 给出了不同
12、类别消息的前缀。 在 PB 中,消息标识符常量通常声明为窗口或对象的实例常量,例如:CONSTANT long WM_MOUSEMOVE = 512CONSTANT long WM_LBUTTONDOWN = 513CONSTANT long WM_LBUTTONUP = 514CONSTANT long WM_LBUTTONDBLCLK = 515CONSTANT long WM_RBUTTONDOWN = 516CONSTANT long WM_RBUTTONUP = 517CONSTANT long WM_RBUTTONDBLCLK = 518表 1-1 Windows 系统定义的消息类
13、别消息标识符前缀 消息分类ABM 应用桌面工具栏消息BM 按钮控件消息CB 组合框控件消息CBEM 扩展组合框控件消息CDM 通用对话框消息DBT 设备消息DL 拖曳列表框控件消息第 1 章 Windows 系统的消息机制 5DM 默认按钮控件消息DTM 日期时间选取控件消息续表消息标识符前缀 消息分类EM 编辑控件消息HDM 头控件消息HKM 热键控件消息IPM IP 地址控件消息LB 列表框控件消息LVM 列表视图控件消息MCM 月历控件消息PBM 进度条控件消息PGM Pager 控件消息PSM 属性页面消息RB Rebar 控件消息SB 状态栏窗口消息SBM 滚动条控件消息STM 静态
14、控件消息TB 工具栏消息TBM 跟踪条控件消息TCM Tab 控件消息TTM Tooltip 控件消息TVM 树形控件消息UDM Up-down 控件消息WM 普通窗口消息Windows 系统使用了成千上万条消息。从窗口到控件都有一组可接收和响应的消息。在Visual Basic 的 API 浏览器中,以常量的方式列出了 Windows 的大部分消息。据粗略统计,微软在 MSDN 中列出的消息约有数千种,全部弄清楚这么多种消息是不现实的,也是没有必要的。这是因为 PB 已经将很多消息封装为了对象的 “属性”(例如窗口的 Title 和 WindowState 属性)和“方法(函数)”(例如关闭
15、窗口函数 Close)。可以发现,消息可能演变成 PB 对象的属性、方法(函数)和事件。既然 PB 已经对消息进行了封装,那么又何必使用消息来进行程序设计呢?这时因为,PB 提供的事件、属性和方法并未完全涵盖所有消息,为了弥补 PB 在某些功能的不足,常使用系统消息或应用自定义的消息来强化 PB的程序设计。2应用定义的消息应用也可以创建自己的消息,并将消息应用于它的窗口或与其他窗口的进程进行通信。如果应用创建了自己的消息,接收消息的窗口过程必须解释消息,同时对消息进行恰当的处理。系统保留的消息标识符的取值范围为 0x00000x03FF(0 1023),专门用于系统定义PowerBuilder
16、 Win32 API 程序设计(高级卷)6的消息;应用定义的消息不能使用这些值,应用定义的消息取值范围为0x04000x7FFF(032767)。RegisterWindowMessage 函数提供了分配消息编号的功能,该函数用一个消息名称作为参数,并为这个名称分配一个惟一的、尚未使用过的编号。1.1.5 用于发送消息的 API 函数Windows 应用程序允许应用程序向自己或其他应用程序发送消息,甚至可以向 Windows操作系统本身发送消息(比如要求关闭操作系统或重新启动操作系统)。Windows 提供了 2个专门用于发送消息的 API 函数 SendMessage 和 PostMessa
17、ge。1SendMessage 函数SendMessage 函数发送指定的消息到窗口或 Windows 系统,然后函数调用窗口的处理消息的过程,并等待窗口过程处理完消息后返回。C 原型LRESULT SendMessage(HWND hWnd, UINT wMsg, WPARAM wParam, LPARAM lParam ); PB 声明FUNCTION Long SendMessage(Long hwnd, Long wMsg, Long wParam, Long lParam) LIBRARY “user32.dll“ ALIAS FOR “SendMessageA“参 数hWnd 为接
18、收消息窗口的句柄;wMsg 指定要发送的消息;wParam 依赖于消息 wMsg 的其他信息;lParam 依赖于消息 wMsg 的其他信息。 返回值函数返回消息的处理结果,该值取决于消息的类型。 wParam 和 lParam 两个参数的含义随消息 wMsg 参数不同而改变,因此每当向窗口传递某种消息时,除了要了解该消息的含义外,还要注意 wParam 和 lParam 的含义和设置。SendMessage 函数会返回一个 Long 值,由于这个函数是直接调用窗口程序,因此窗口程序可以返回一个值,把它作为 SendMessage 函数的返回值,这个返回值的具体含义由消息决定。不过,除非在 M
19、SDN 明确列出了该消息的返回值,否则,返回值就没有具体意义,应该忽略。此外,在使用返回值时,通常调用 SendMessageTimeOut 函数检查是否超时,因为只有在消息完全处理完毕后,才能得到一个有效返回值。前面曾提到默认的窗口过程函数 DefWindowProc 用来处理应用程序无法处理的消息,该函数确保所有消息都要处理,无论这些消息是否对窗口有用。调用 DefWindowProc 函数时,需要传入与窗口消息处理过程相同的参数。C 原型LRESULT DefWindowProc( HWND hWnd, UINT Msg, WPARAM wParam, LPARAM lParam );P
20、B 声明第 1 章 Windows 系统的消息机制 7FUNCTION Long DefWindowProc(Long hwnd,Long wMsg,Long wParam,Long lParam) LIBRARY “user32.dll“ ALIAS FOR “DefWindowProcA“参 数hWnd 窗口句柄;wMsg 指定要发送的消息;wParam 依赖于消息 wMsg 的其他信息;lParam 依赖于消息 wMsg 的其他信息。 返回值函数返回消息的处理结果,该取决于消息的类型。 2. PostMessage 函数PostMessage 函数同 SendMessage 类似,它把消
21、息放在指定窗口创建的线程的消息队列中,然后不等消息处理完就返回,而不像 SendMessage 那样必须等到消息处理完毕才返回。目标窗口通过 GetMessage 或 PeekMessage 从消息队列中取出并处理。C 原型LRESULT PostMessage( HWND hWnd, UINT Msg, WPARAM wParam, LPARAM lParam );PB 声明FUNCTION Long PostMessage (Long hwnd,Long wMsg,Long wParam,Long lParam) LIBRARY “user32.dll“ ALIAS FOR “ PostM
22、essageA“参 数hWnd 为接收消息窗口的句柄;Msg 指定要发送的消息;wParam 依赖于消息 Msg 的其他信息;lParam 依赖于消息 Msg 的其他信息。返回值如果函数调用成功,函数返回值为非 0;如果调用失败,函数返回 0。 示 例下面代码演示了如何通过发送消息,在 PB 应用中关闭另外运行的第三方程序。(1)运行 Windows 的系统的记事本程序 NotePad,并创建一个未命名的文档。(2)在 PB 中新建一个窗口,为窗口声明如下对象级外部函数和实例变量:FUNCTION Long FindWindow(String lpClassName, String lpWin
23、dowName) LIBRARY “user32.dll“ ALIAS FOR “FindWindowA“ FUNCTION Long PostMessage(Long hwnd, Long wMsg, Long wParam, Long lParam) LIBRARY “user32.dll“ ALIAS FOR “PostMessageA“ Constant long WM_QUIT = 18(3)在窗口上放置一个按钮控件,为按钮的 Clicked 事件加入如下脚本:String ls_sTitle, pbNullStringLong ll_iHwnd, ll_ihTaskLong ll_
24、iReturnPowerBuilder Win32 API 程序设计(高级卷)8SetNull(pbNullString)ls_sTitle = “未定标题 记事本“ll_iHwnd = FindWindow(SetNull, ls_sTitle)ll_iReturn = PostMessage(ll_iHwnd, WM_QUIT, 0, 0)MessageBox(“提示信息“,“记事本已经关闭!“)上述代码运行后,使用 FindWindow 函数获取 Windows 记事本程序窗口的句柄,然后向记事本窗口发送 WM_QUIT 消息,记事本程序将被关闭。1.2 事件与消息1.2.1 从消息到事
25、件虽然在前面提到 Windows 系统会产生事件来驱动对象,但更严格的讲 Windows 先产生消息,然后由 PB 将其转化为驱动对象的事件。那么 PB 是如何将消息转换为事件呢?1.1 节介绍了消息的概念。也可以通俗地将消息理解为由 Windows 操作系统送往程序的事件。它是系统中各个控件(窗口)沟通的方式。举例来说,当移动鼠标、按下鼠标键、改变窗口视窗大小时,Windows 都会送出消息以通知程序。当然,为了要辨别事件的内容,Windows 系统中预定义了许多的消息,如 WM_PAINT,WM_CHAR 等。 当事件发生时,Windows 系统根据窗口的身份码 句柄 hWnd,判断该事件
26、必须由哪个窗口接收,然后将事件以消息的方式送往程序的窗口中。虽然在 Windows 系统中包含了数以百计的事件,但是操作系统并没有为各个事件设计不同的消息结构,而是以一个一般性的结构来描述消息,Windows 使用了一个特殊的函数来实现这一过程,这个函数的名称叫做“窗口处理函数”或者叫做“窗口消息处理函数”,该函数就是 WindowProc。LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam );从函数的定义可以看出,任何要发送的消息都有 4 个参数,其中:HWND hwnd发送窗口的句柄
27、UINT uMsg消息代码Windows 中每一个消息都有惟一的一个代码。在 Visual Basic 的 API 文本浏览器中以常量的格式列出了所有消息名和代码,在 PB 中也可以直接利用 Visual Basic 的 API 文本浏览器列出的这些消息,惟一需要做的就是将 Visual Basic 十六进制消息代码转换为 PB 的十进制,如在 Visual Basic 声明定义的有关鼠标移动的消息:Public Const WM_MOUSEMOVE = &H200在 PB 中应声明为:Constant Long WM_MOUSEMOVE = 512第 1 章 Windows 系统的消息机制
28、9WPARAM wParam 和 LPARAM lParam 为两个 32 位的长整型值,用来指定当前发送消息时所带信息,如在鼠标移动时返回鼠标的位置等。当 Windows 有消息需要通知程序的时候,它就会调用该函数,然后自己的程序就从中检测发送的消息。Windows 中消息的种类是很多的,不可能也没有必要检测所有的消息,只需要检测感兴趣的消息即可。检测消息的程序其实就是一个条件判断组合,如图 1.1 所示。那么未处理的消息到那里去了?Windows 系统为窗口提供了默认的窗口过程DefWindowProc,这个窗口过程将负责处理那些不需要的消息。正因为有了这个默认窗口过程,才可以利用 Win
29、dows 的窗口进行开发,而不必过多关注窗口各种消息的处理。例如,窗口在被拖动时会有很多消息发送,可以不予理睬让系统自己去处理。 接 收 消 息 处 理 消 息 停 止 否 是 是 希 望 的 消 息 ? 图 1.1 消息处理流程从上面分析可以看出,事件驱动机制是针对诸如 PB、Visual Basic 这类面向对象的开发环境而言,在其背后隐含的是 Windows 系统的消息驱动机制,但 Windows 系统的消息驱动应用范围要比高级开发语言定义的事件驱动范围广泛的多。1.2.2 PB 事件对消息的封装在 PB 中,除了为窗口和控件预置的事件外,PB 还将 Windows 系统的许多消息封装为
30、用户自选事件,根据与 Windows 系统的消息的对应关系,为每个事件定义了 EventID,如图1.2 所示。当窗口或控件的预置事件无法满足程序设计要求时,可以使用这些自选事件。如在设备场景中绘制的位图,当窗口大小改变时,位图并不会自动重绘。这时就需要使用窗口的事件ID 号位 pbm_paint 事件,该事件与窗口的 WM_PAINT 消息相对应,当窗口发生变化时强迫窗口重绘。在 PB 中,事件 ID 的作用是把 PB 的事件与系统消息联系起来,被用户的动作或其他系统活动触发的事件必须具有 ID 号。对于 PB 的系统对象,如窗口、按钮等控件,定义好的系统事件通常都使用 ID 号。当用户使用
31、自选事件时,可以使用如图 1.2 所示列在 Event Declaration 对话框中的事件ID 号,用来响应某个系统消息。如果定义被系统消息触发的用户自选事件,可以从 ID 号列表中选择事件 ID 号。其中,列在 Event 对话框中的所有以 pbm_前缀开始的 ID 号,为映射到PB 中的系统消息。在定义用户自选事件时,不能修改与事件 ID 号相关的参数及返回值,因PowerBuilder Win32 API 程序设计(高级卷)10为这些是整个事件 ID 号的具体组成部分。如果与事件 ID 号相应的系统消息发生时,PB 触发该事件,并为事件的参数赋值。如果用户自定义事件,并且与系统消息无
32、关,则不为事件选择 ID 号。这样事件将不会被用户的动作或系统的活动触发,只能在应用中用脚本来触发。图 1.2 PB 的用户自选事件由 于 PB 的 技 术 开 发 文 档 中 并 未 列 出 每 个 事 件 ID 的 具 体 含 义 及 与 Windows 系 统 消 息 的 对应 关 系 , 用 户 在 使 用 这 些 自 选 事 件 时 常 常 感 到 困 惑 。 为 此 , 笔 者 将 这 些 事 件 与 Windows 系 统的 消 息 的 对 应 关 系 及 具 体 含 义 逐 一 进 行 了 分 析 , 这 些 PB 的 自 选 事 件 ID 涵 盖 了 窗 口 消 息 , 以及
33、 按 钮 、 组 合 框 、 列 表 框 、 编 辑 掩 码 等 控 件 的 消 息 , 下 面 逐 一 列 在 表 1-2 1-8 中 , 供 读 者 参 考 。(1)PB 的按钮自选事件及对应的系统消息,如表 1-2 所示。(2)PB 的组合框控件(ComBox)自选事件及对应的系统消息,如表 1-3 所示。表 1-2 按钮事件及对应的系统消息PB 的事件 ID 对应的系统消息 消息作用pbm_bmgetstate BM_GETSTATE 按钮是否加亮pbm_bmsetcheck BM_SETCHECK 设置按钮的选中或未选中状态pbm_bmsetstate BM_SETSTATE 加亮或
34、不加亮按钮pbm_bnclicked BN_CLICKED 按钮控件被单击pbm_bndisable BN_DISABLE 使按钮控件无效pbm_bndoubleclicked BN_DOUBLECLICKED 按钮控件被双击pbm_bndragdrop BN_DRAGDROP 一个对象被放到按钮控件pbm_bndragenter BN_DRAGENTER 一个对象被拖到按钮控件pbm_bndragleave BN_DRAGLEAVE 一个对象被拖离按钮控件pbm_bndragover BN_DRAGOVER 一个对象被拖经按钮控件第 1 章 Windows 系统的消息机制 11pbm_bnhilite BN_HILITE 按钮控件被加亮pbm_bnpaint BN_PAINT 按钮控件被绘制pbm_bnsetfocus BN_SETFOCUS 按钮控件获得焦点pbm_bnunhilite BN_UNHILITE 按钮控件不被加亮