Windows系统消息机制（转）

第1章 Windows系统的消息机制

对诸如PowerBuilder（后文简写为PB）、Visual Basic和Delphi等大多数可视化程序设计语言来讲，程序设计的核心是对象的事件、属性和方法，但对Windows系统本身而言，却是以消息处理为其控制机制。Windows把系统中的对象都作为窗口来对待，每个窗口都有一个用来标识其身份的句柄。Windows通过向窗口发送消息，在开发语言中转化为对象的事件，然后驱动对象，响应用户的动作。在许多面向对象的可视化程序设计语言中，Windows的众多消息已经演变成了对象的属性或方法。本章内容包括Windows系统的消息机制、消息的发送、消息的应用实例等。

1.1 Windows的工作机制

1.1.1 Windows 的工作方式——窗口、事件和消息

全面地讨论Windows的内部工作机制需要很大的篇幅，对于一般的PB用户当然没有必要深入了解所有的技术细节。Windows系统的工作机制，简单地说就是3个关键的概念：窗口、事件和消息。

不妨简单地将窗口看做带有边界的矩形区域。读者也许已经了解多种不同类型的窗口，如Windows系统的“资源管理器”窗口、文字处理程序中的文档窗口或者弹出提示有约会信息的消息对话框窗口等。除了这些最普通的窗口外，实际上还有许多其他类型的窗口。命令按钮是一个窗口，图标、文本框、选项按钮和菜单条也都是窗口。

Windows 操作系统通过给每一个窗口指定一个惟一的标识号（窗口句柄，常用hWnd表示）来管理所有的窗口。操作系统连续地监视每一个窗口的活动或事件的信号。事件可以通过诸如单击鼠标或按下按键的操作而产生，也可以通过程序的控制而产生，甚至可以由另一个窗口的操作而产生。

每发生一次事件，将引发一条消息发送至操作系统。操作系统处理该消息并广播给其他窗口。然后，每一个窗口才能根据自身处理该条消息的指令而采取适当的操作（例如，当窗口解除了其他窗口的覆盖时，重新绘制自身窗口）。

可以想象，处理各种窗口、事件和消息的所有可能的组合将有惊人的工作量。幸运的是，PB使用户摆脱了所有的低层消息处理。许多消息由PB自动处理了，其他的作为事件过程由编程者自行处理，这样可以快速创建强大的应用程序，而毋需涉及不必要的细节。

1.1.2 句柄的概念

在解释消息之前，首先了解系统如何准确地将消息发送到指定的窗口。当一个应用或多个应用运行后，会同时创建许多个窗口，Windows作为系统的“大总管”，那么它又是如何识别每一个窗口呢？在程序设计时，通过窗口的名称属性，为每个窗口命名，然后在程序其他部分把窗口名作为识别窗口的标识。这种通过为窗口命名来识别不同窗口的方法，对Windows系统来讲显然是不现实的。Windows系统是通过称之为句柄的标识符来识别每一个窗口。

句柄是系统动态分配给窗口的32位整型数标识值，常用hWnd表示，即英文handle to a window的缩写。大量API函数都需要窗口句柄作参数，或返回一个窗口或设备场境的句柄。句柄可以通俗地理解为Windows为系统中所有存在的窗口动态分配的身份识别号码。

在PB中，可以通过handle函数来取得窗口和控件的句柄，当声明API函数时，常把保存句柄的变量声明为Long或Ulong长整型数据类型。Windows为窗口和控件分配句柄标识是动态，同样的程序每次运行时和在不同计算机上运行时所分配的窗口句柄标识可能是完全不一样的。

窗口的句柄属性仅能在运行时访问，该属性对窗口的外观并没有任何影响，它仅作为API函数调用的参数或返回值，或其他需识别窗口或对象的地方。在后面章节中，读者将会看到几乎所有涉及窗口的API函数都需要传递hWnd参数，以便函数准确获得用户要处理的窗口或对象。

句柄作为由操作系统定义的惟一的长整型值，可以用它来引用窗体和控件等对象。在Windows系统中，API函数的调用常用的句柄包括窗口句柄，菜单句柄、设备对象句柄、设备场景句柄，等等。如果函数需要用句柄作为参数，则应该把参数声明为传值，对于返回句柄的API函数，应将返回的句柄值声明为Long或Ulong类型数据类型。句柄是一种标识符（ID）编号，而不是指针或者数值，不要试图对它们进行任何数学运算。

1.1.3 消息的概念

Windows系统是以消息处理为其控制机制，系统通过消息为窗口过程（windows procedure）传递输入。系统和应用两者都可以产生消息。对于每个输入事件，例如用户按下了键盘上的某个键、移动了鼠标、单击了一个控件上的滚动条，等等，系统都将产生一系列消息。此外，对于应用带给系统的变化，如字体资源的改变、应用本身窗口的改变，系统都将通过消息以响应这种变化。应用通过产生消息指示应用的窗口完成特定的任务，或与其他应用的窗口进行通信。

每个窗口都有一个处理Windows系统发送消息的处理程序，称为窗口程序。它是隐含在窗口背后的一段程序脚本，其中包含对事件进行处理的代码。

Windows系统为每条消息指定了一个消息编号，例如当一个窗口变为活动窗口时，它事实上是收到一条来自Windows系统的WM_ACTIVATE消息，该消息的编号为6，它对应于PB窗口的Activate事件。对于窗口来说，诸如Open、Activate、MouseDown、Resize等事件，实际上对应的是窗口内部的消息处理程序，这些程序对于用户来讲是不可见的。类似地，命令按钮也有消息处理程序，它的处理程序响应诸如WM_LBUTTONDOWN和WM_RBUTTONDOWN之类的消息，即激活命令按钮的MouseDown事件。

系统向窗口发送的消息通常包含3个参数，分别是：

（1）窗口句柄（a window handle）：窗口句柄用来标识消息将要发送到的窗口对象，系统使用窗口句柄来确定哪一个窗口句柄应该接收该消息。

（2）消息标识符（a message identifier）：消息标识符是用来区分不同消息的命名常量，当窗口过程接收到一个消息时，它使用消息标识符来确定如何处理该消息。例如，消息标识符WM_PAINT告诉窗口过程“窗口的客户区已经发生变化，窗口必须进行重新绘制”。

（3）消息参数（message parameters）：消息参数用来表述窗口过程处理消息时所使用的数据或数据的位置，通常用一对参数表示。消息参数的意义和取值取决于消息。消息参数取值可以是整型数、Bit位标识、指向结构的指针，等等，当不需要使用消息参数时，通常将其设置为NULL。窗口过程必须通过检查消息标识符来确定如何对消息参数进行解释。

有关消息标识符、消息参数的具体使用，将在后面介绍Sendmessage函数时给予进一步解释。

1.1.4 消息的类型

1．系统定义的消息

当系统与应用进行通信时，系统将发送或邮寄消息。系统通过这些消息控制应用的运行，并为应用的进程提供输入或其他信息。应用内部也可发送或邮寄系统定义的消息，应用通常使用这些消息控制由预先注册的窗口类创建的窗口的操作。

每一个系统定义的消息都有一个惟一的消息标识符（值），并用一个表明消息用途标识符常量表示（这些在SDK的头文件中定义）。如WM_PAINT消息标识符表示要求窗口进行重绘的消息。

消息标识符常量前缀表示消息所属的消息类别，如WM_表示窗口类消息，BM_表示按钮类消息，表1-1给出了不同类别消息的前缀。

在PB中，消息标识符常量通常声明为窗口或对象的实例常量，例如：

CONSTANT long WM_MOUSEMOVE = 512

CONSTANT long WM_LBUTTONDOWN = 513

CONSTANT long WM_LBUTTONUP = 514

CONSTANT long WM_LBUTTONDBLCLK = 515

CONSTANT long WM_RBUTTONDOWN = 516

CONSTANT long WM_RBUTTONUP = 517

CONSTANT long WM_RBUTTONDBLCLK = 518

表1-1 Windows系统定义的消息类别

消息标识符前缀	消息分类
ABM	应用桌面工具栏消息
BM	按钮控件消息
CB	组合框控件消息
CBEM	扩展组合框控件消息
CDM	通用对话框消息
DBT	设备消息
DL	拖曳列表框控件消息
DM	默认按钮控件消息
DTM	日期时间选取控件消息

续表

消息标识符前缀	消息分类
EM	编辑控件消息
HDM	头控件消息
HKM	热键控件消息
IPM	IP地址控件消息
LB	列表框控件消息
LVM	列表视图控件消息
MCM	月历控件消息
PBM	进度条控件消息
PGM	Pager控件消息
PSM	属性页面消息
RB	Rebar 控件消息
SB	状态栏窗口消息
SBM	滚动条控件消息
STM	静态控件消息
TB	工具栏消息
TBM	跟踪条控件消息
TCM	Tab 控件消息
TTM	Tooltip控件消息
TVM	树形控件消息
UDM	Up-down 控件消息
WM	普通窗口消息

Windows系统使用了成千上万条消息。从窗口到控件都有一组可接收和响应的消息。在Visual Basic的API浏览器中，以常量的方式列出了Windows的大部分消息。

据粗略统计，微软在MSDN中列出的消息约有数千种，全部弄清楚这么多种消息是不现实的，也是没有必要的。这是因为PB已经将很多消息封装为了对象的“属性”（例如窗口的Title和WindowState属性）和“方法（函数）”（例如关闭窗口函数Close）。可以发现，消息可能演变成PB对象的属性、方法（函数）和事件。既然PB已经对消息进行了封装，那么又何必使用消息来进行程序设计呢？这时因为，PB提供的事件、属性和方法并未完全涵盖所有消息，为了弥补PB在某些功能的不足，常使用系统消息或应用自定义的消息来强化PB的程序设计。

2．应用定义的消息

应用也可以创建自己的消息，并将消息应用于它的窗口或与其他窗口的进程进行通信。如果应用创建了自己的消息，接收消息的窗口过程必须解释消息，同时对消息进行恰当的处理。

系统保留的消息标识符的取值范围为0x0000～0x03FF（0～1023），专门用于系统定义的消息；应用定义的消息不能使用这些值，应用定义的消息取值范围为0x0400～0x7FFF（0～32767）。

RegisterWindowMessage函数提供了分配消息编号的功能，该函数用一个消息名称作为参数，并为这个名称分配一个惟一的、尚未使用过的编号。

1.1.5 用于发送消息的API函数

Windows应用程序允许应用程序向自己或其他应用程序发送消息，甚至可以向Windows操作系统本身发送消息（比如要求关闭操作系统或重新启动操作系统）。Windows提供了2个专门用于发送消息的API函数SendMessage和PostMessage。

1．SendMessage函数

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为接收消息窗口的句柄；

wMsg指定要发送的消息；

wParam 依赖于消息wMsg的其他信息；

lParam 依赖于消息wMsg的其他信息。

返回值

函数返回消息的处理结果，该值取决于消息的类型。

wParam和lParam两个参数的含义随消息wMsg参数不同而改变，因此每当向窗口传递某种消息时，除了要了解该消息的含义外，还要注意wParam和lParam的含义和设置。

SendMessage函数会返回一个Long值，由于这个函数是直接调用窗口程序，因此窗口程序可以返回一个值，把它作为SendMessage函数的返回值，这个返回值的具体含义由消息决定。不过，除非在MSDN明确列出了该消息的返回值，否则，返回值就没有具体意义，应该忽略。此外，在使用返回值时，通常调用SendMessageTimeOut函数检查是否超时，因为只有在消息完全处理完毕后，才能得到一个有效返回值。

前面曾提到默认的窗口过程函数DefWindowProc用来处理应用程序无法处理的消息，该函数确保所有消息都要处理，无论这些消息是否对窗口有用。调用DefWindowProc函数时，需要传入与窗口消息处理过程相同的参数。

C原型

LRESULT DefWindowProc( HWND hWnd, UINT Msg, WPARAM wParam, LPARAM lParam );

PB声明

FUNCTION 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类似，它把消息放在指定窗口创建的线程的消息队列中，然后不等消息处理完就返回，而不像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 "PostMessageA"

参数

hWnd为接收消息窗口的句柄；

Msg指定要发送的消息；

wParam 依赖于消息Msg的其他信息；

lParam 依赖于消息Msg的其他信息。

返回值

如果函数调用成功，函数返回值为非0；如果调用失败，函数返回0。

示例

下面代码演示了如何通过发送消息，在PB应用中关闭另外运行的第三方程序。

（1）运行Windows的系统的记事本程序NotePad，并创建一个未命名的文档。

（2）在PB中新建一个窗口，为窗口声明如下对象级外部函数和实例变量：

FUNCTION Long FindWindow(String lpClassName, String lpWindowName) 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, pbNullString

Long ll_iHwnd, ll_ihTask

Long ll_iReturn

SetNull(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 从消息到事件

虽然在前面提到Windows系统会产生事件来驱动对象，但更严格的讲Windows先产生消息，然后由PB将其转化为驱动对象的事件。那么PB是如何将消息转换为事件呢？

1.1节介绍了消息的概念。也可以通俗地将消息理解为由Windows操作系统送往程序的事件。它是系统中各个控件（窗口）沟通的方式。举例来说，当移动鼠标、按下鼠标键、改变窗口视窗大小时，Windows都会送出消息以通知程序。当然，为了要辨别事件的内容，Windows系统中预定义了许多的消息，如WM_PAINT，WM_CHAR等。

当事件发生时，Windows系统根据窗口的身份码——句柄hWnd，判断该事件必须由哪个窗口接收，然后将事件以消息的方式送往程序的窗口中。虽然在Windows系统中包含了数以百计的事件，但是操作系统并没有为各个事件设计不同的消息结构，而是以一个一般性的结构来描述消息，

Windows使用了一个特殊的函数来实现这一过程，这个函数的名称叫做“窗口处理函数”或者叫做“窗口消息处理函数”，该函数就是WindowProc。

LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam );

从函数的定义可以看出，任何要发送的消息都有4个参数，其中：

HWND hwnd——发送窗口的句柄

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

WPARAM wParam和LPARAM lParam为两个32位的长整型值，用来指定当前发送消息时所带信息，如在鼠标移动时返回鼠标的位置等。

当Windows有消息需要通知程序的时候，它就会调用该函数，然后自己的程序就从中检测发送的消息。Windows中消息的种类是很多的，不可能也没有必要检测所有的消息，只需要检测感兴趣的消息即可。检测消息的程序其实就是一个条件判断组合，如图1.1所示。

那么未处理的消息到那里去了？Windows系统为窗口提供了默认的窗口过程DefWindowProc，这个窗口过程将负责处理那些不需要的消息。正因为有了这个默认窗口过程，才可以利用Windows的窗口进行开发，而不必过多关注窗口各种消息的处理。例如，窗口在被拖动时会有很多消息发送，可以不予理睬让系统自己去处理。

 

图1.1 消息处理流程

从上面分析可以看出，事件驱动机制是针对诸如PB、Visual Basic这类面向对象的开发环境而言，在其背后隐含的是Windows系统的消息驱动机制，但Windows系统的消息驱动应用范围要比高级开发语言定义的事件驱动范围广泛的多。

1.2.2 PB事件对消息的封装

在PB中，除了为窗口和控件预置的事件外，PB还将Windows系统的许多消息封装为用户自选事件，根据与Windows系统的消息的对应关系，为每个事件定义了EventID，如图1.2所示。

当窗口或控件的预置事件无法满足程序设计要求时，可以使用这些自选事件。如在设备场景中绘制的位图，当窗口大小改变时，位图并不会自动重绘。这时就需要使用窗口的事件ID号位pbm_paint事件，该事件与窗口的WM_PAINT消息相对应，当窗口发生变化时强迫窗口重绘。在PB中，事件ID的作用是把PB的事件与系统消息联系起来，被用户的动作或其他系统活动触发的事件必须具有ID号。对于PB的系统对象，如窗口、按钮等控件，定义好的系统事件通常都使用ID号。

当用户使用自选事件时，可以使用如图1.2所示列在Event Declaration对话框中的事件ID号，用来响应某个系统消息。如果定义被系统消息触发的用户自选事件，可以从ID号列表中选择事件ID号。其中，列在Event对话框中的所有以pbm_前缀开始的ID号，为映射到PB中的系统消息。在定义用户自选事件时，不能修改与事件ID号相关的参数及返回值，因为这些是整个事件ID号的具体组成部分。如果与事件ID号相应的系统消息发生时，PB触发该事件，并为事件的参数赋值。如果用户自定义事件，并且与系统消息无关，则不为事件选择ID号。这样事件将不会被用户的动作或系统的活动触发，只能在应用中用脚本来触发。

图1.2 PB的用户自选事件

由于PB的技术开发文档中并未列出每个事件ID的具体含义及与Windows系统消息的对应关系，用户在使用这些自选事件时常常感到困惑。为此，笔者将这些事件与Windows系统的消息的对应关系及具体含义逐一进行了分析，这些PB的自选事件ID涵盖了窗口消息，以及按钮、组合框、列表框、编辑掩码等控件的消息，下面逐一列在表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	加亮或不加亮按钮
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	一个对象被拖经按钮控件
pbm_bnhilite	BN_HILITE	按钮控件被加亮
pbm_bnpaint	BN_PAINT	按钮控件被绘制
pbm_bnsetfocus	BN_SETFOCUS	按钮控件获得焦点
pbm_bnunhilite	BN_UNHILITE	按钮控件不被加亮

表1-3 组合框事件及对应的系统消息

PB的事件ID	对应的系统消息	消息作用
pbm_cbaddstring	CB_ADDSTRING	将字符串加到组合框
pbm_cbdeletestring	CB_DELETESTRING	从组合框删除一个字符串
pbm_cbdir	CB_DIR	加一个目录列表到组合框
pbm_cbfindstring	CB_FINDSTRING	搜索以一组字符开头的字符串
pbm_cbfindstringexact	CB_FINDSTRINGEXACT	搜索与所提供的字符完全匹配的字符串
pbm_cbgetcount	CB_GETCOUNT	列表框中的项数
pbm_cbgetcursel	CB_GETCURSEL	当前被选项的数目
pbm_cbgetdroppedcontrolset	CB_GETDROPPEDCONTROLSET	列表框在屏幕上的坐标位置
pbm_cbgeteditsel	CB_GETEDITSEL	编辑器控件中被选字符的范围
pbm_cbgetextendedui	CB_GETEXTENDEDUI	默认或扩展的用户界面
pbm_cbgetitemdata	CB_GETITEMDATA	重画的列表框中的4字节（32位）项
pbm_cbgetitemheight	CB_GETITEMHEIGHT	列表框中某一项的高度
pbm_cbgetlbtext	CB_GETLBTEXT	列表框中的文本
pbm_cbgetlbtextlen	CB_GETLBTEXTLEN	列表框中文本的长度
pbm_cbinsertstring	CB_INSERTSTRING	向列表框中插入新的字符串项
pbm_cblimittext	CB_LIMITTEXT	限制能被输入到列表框中的字符数
pbm_cbresetcontent	CB_RESETCONTENT	删除列表框中所有内容
pbm_cbselectstring	CB_SELECTSTRING	搜索匹配的字符串并显示
pbm_cbsetcursel	CB_SETCURSEL	在列表框中选择并显示一项
pbm_cbseteditsel	CB_SETEDITSEL	在列表框的编辑区域中选择一块文本
pbm_cbsetextendedui	CB_SETEXTENDEDUI	设置默认或扩展的用户界面
pbm_cbsetitemdata	CB_SETITEMDATA	在列表框中设定4字节（32位）项
pbm_cbsetitemheight	CB_SETITEMHEIGHT	设置列表框中项的高度
pbm_cbshowdropdown	CB_SHOWDROPDOWN	显示或隐藏列表框中下拉列表区域
pbm_cbndblclk	CBN_DBLCLK	用户在列表中某一项上双击鼠标
pbm_cbndragdrop	CBN_DRAGDROP	一个对象被放到组合框控件上
pbm_cbndragenter	CBN_DRAGENTER	一个对象被拖到组合框控件上
pbm_cbndragleave	CBN_DRAGLEAVE	一个对象被拖离组合框控件
pbm_cbndragover	CBN_DRAGOVER	一个对象被拖经组合框控件
pbm_cbndropdown	CBN_DROPDOWN	列表框的下拉区域即将被显示
pbm_cbneditchange	CBN_EDITCHANGE	编辑器控件中的文本发生变化
pbm_cbneditupdate	CBN_EDITUPDATE	列表框编辑器控件中的文本即将被改变
pbm_cbnerrspace	CBN_ERRSPACE	列表框满，不能再向其中加入项
pbm_cbnkillfocus	CBN_KILLFOCUS	通用列表框失去焦点
pbm_cbnselchange	CBN_SELCHANGE	列表框中被选文本被改变
pbm_cbnselendcancel	CBN_SELENDCANCEL	用户按下了“取消”按钮
pbm_cbnselendok	CBN_SELENDOK	用户按下了“确认”按钮
pbm_cbnsetfocus	CBN_SETFOCUS	通用对话控件拥有焦点

（3）PB的编辑控件（EditMask）自选事件及对应的系统消息，如表1-4所示。

（4）PB的列表框控件（ListBox）自选事件及对应的系统消息，如表1-5所示。

表1-4 编辑控件事件及对应的系统消息

PB的自选事件ID	对应的系统消息	消息作用
pbm_emcanundo	EM_CANUNDO	编辑器控件是否能撤消上一次修改
pbm_ememptyundobuffer	EM_EM_PTYUNDOBUFFER	清空由Windows管理的取消操作的缓冲区
pbm_emfmtlines	EM_FMTLINES	在多行编辑器控件的行尾增加或删除回车换行
pbm_emgetfirstvisibleline	EM_GETFIRSTVISIBLELINE	返回编辑器控件中可见的第一行的行号
pbm_emgethandle	EM_GETHANDLE	获得编辑器控件使用的内存句柄
pbm_emgetline	EM_GETLINE	从编辑器控件中复制一行到内存缓冲区
pbm_emgetlinecount	EM_GETLINECOUNT	返回多行编辑器控件的行数
pbm_emgetmodify	EM_GETMODIFY	文本是否被用户修改
pbm_emgetrect	EM_GETRECT	返回控件的长方形域
pbm_emgetsel	EM_GETSEL	返回被选文本的起始位置
pbm_emlimittext	EM_LIMITTEXT	限制用户键入的文本长度
pbm_emlinefromchar	EM_LINEFROMCHAR	返回被选文本的行号
pbm_emlineindex	EM_LINEINDEX	返回控件中被选行第一个字符在编辑串中的位置
pbm_emlinelength	EM_LINELENGTH	返回编辑器控件中被选行中的字符数
pbm_emlinescroll	EM_LINESCROLL	水平或垂直卷滚编辑器控件
pbm_emreplacesel	EM_REPLACESEL	从剪贴板或从键盘上用新文本替换被选文本
pbm_emsethandle	EM_SETHANDLE	设置编辑器控件的句柄
pbm_emsetmodify	EM_SETMODIFY	设置编辑器控件的modified标志
pbm_emsetpasswordchar	EM_SETPASSWORDCHAR	设置用户输入任何文本时显示的字符，在输入密码时的显示
pbm_emsetrect	EM_SETRECT	设置/重置编辑器控件所在的长方形区域,编辑器控件中的文本被重画
pbm_emsetrectnp	EM_SETRECTNP	除了不重画文本，大致与setrect相同
pbm_emsetsel	EM_SETSEL	选择字符
pbm_emsettabstops	EM_SETTABSTOPS	在多行编辑器控件中设置tabstops
pbm_emsetwordbreak	EM_SETWORDBREAK	设置新的词拆分函数
pbm_emsetwordbreakproc	EM_SETWORDBREAKPROC	设置新的词拆分过程
pbm_emundo	EM_UNDO	撤消最近的编辑操作
pbm_enchange	EN_CHANGE	编辑器控件中的文本发生改变
pbm_enerrspace	EN_ERRSPACE	编辑器控件内存缓冲区溢出
pbm_enhscroll	EN_HSCROLL	用户点中上水平滚动条
pbm_enmaxtext	EN_MAXTEXT	用户试图输入比允许更多的文本
pbm_enupdate	EN_UPDATE	编辑器控件即将显示用户的修改
pbm_envscroll	EN_VSCROLL	用户点中垂直滚动条

表1-5 列表框控件事件及对应的系统消息

PB的事件ID	对应的系统消息	消息作用
pbm_lbaddstring	LB_ADDSTRING	向列表框控件中增加一项或一个字符串
pbm_lbdeletestring	LB_DELETESTRING	从列表框中删除一项或一个字符串
pbm_lbdir	LB_DIR	用目录列表填充列表框
pbm_lbfindstring	LB_FINDSTRING	在列表框中搜索与所给字符串匹配的项
pbm_lbfindstringexact	LB_FINDSTRINGEXACT	在列表框中搜索与所给字符串精确匹配的项
pbm_lbgetcaretindex	LB_GETCARETINDEX	在列表框中搜索拥有焦点的项
pbm_lbgetcount	LB_GETCOUNT	确定列表框中的项数
pbm_lbgetcursel	LB_GETCURSEL	确定所选项是第几项
pbm_lbgethorizontalextent	LB_GETHORIZONTALEXTENT	获得列表框的宽度、计算水平卷滚
pbm_lbgetitemheight	LB_GETITEMHEIGHT	确定列表框控件中项的高度
pbm_lbgetitemrect	LB_GETITEMRECT	确定列表框的尺寸
pbm_lbgetsel	LB_GETSEL	获得列表框中当前所选的项
pbm_lbgetselcount	LB_GETSELCOUNT	在多选列表框中获得所选项的数目
pbm_lbgetselitems	LB_GETSELITEMS	用列表框中各自的项号填充给定的整数数组
pbm_lbgettext	LB_GETTEXT	获得列表框中当前所选项的文本
pbm_lbgettextlen	LB_GETTEXTLEN	获得列表框中当前所选项的文本中的字符数
pbm_lbgettopindex	LB_GETTOPINDEX	确定列表框中可见的最上面一项的项号
pbm_lbinsertstring	LB_INSERTSTRING	向列表框中加入一个新字符串
pbm_lbresetcontent	LB_RESETCONTENT	重置（消除）列表框中的内容
pbm_lbselectstring	LB_SELECTSTRING	搜索并加亮与所给字符匹配的字符串
pbm_lbselitemrange	LB_SELITEMRANGE	选择/取消列表框中某一范围中的项
pbm_lbsetcaretindex	LB_SETCARETINDEX	设置列表框中的某一项拥有焦点
pbm_lbsetcolumnwidth	LB_SETCOLUMNWIDTH	设置列表框中列的宽度
pbm_lbsetcursel	LB_SETCURSEL	在列表框中选择并加亮一项
pbm_lbsethorizontaltext	LB_SETHORIZONTALTEXT	设置列表框中被水平卷滚的单元数
pbm_lbsetitemdata	LB_SETITEMDATA	设置与列表框相关的32位/4字节值
pbm_lbsetitemheight	LB_SETITEMHEIGHT	设置列表框中项的高度
pbm_lbsetsel	LB_SETSEL	在列表框中选择一个字符串
pbm_lbsettabstops	LB_SETTABSTOPS	设置列表框控件中tabstops的位置
pbm_lbsettopindex	LB_SETTOPINDEX	滚动列表框使特定的项成为可见的最上面项
pbm_endblclk	LBN_DBLCLK	用户在列表框控件中的某一项上双击
pbm_enerrspace	LBN_ERRSPACE	用户试图超越可在列表框中输入字符的最大限制
pbm_enselcancel	LBN_SELCANCEL	当前选取文本被取消
pbm_enselchange	LBN_SELCHANGE	用户在列表框中选择或取消了一项

（5）PB的窗口自选事件及对应的系统消息，如表1-6所示。

表1-6 窗口事件及对应的系统消息

PB的事件ID	对应的系统消息	消息作用
pbm_activateapp	WM_ACTIVATEAPP	被激活的窗口属于另外一个应用
pbm_askcbformatname	WM_ASKCBFORMATNAME	要求剪贴板中的内容被复制到一个使用自定义格式的文本缓冲区中
pbm_char	WM_CHAR	传送键盘上按下的键
pbm_chartoitem	WM_CHARTOITEM	通过转换键盘来的字符，帮助列表框定位其中的项
pbm_childactivate	WM_CHILDACTIVATE	一个子窗口被移动或激活
pbm_clear	WM_CLEAR	用户要删除当前编辑器控件中的内容
pbm_command	WM_COMMAND	用户选择了一个菜单项、控件或使用了加速键
pbm_compacting	WM_COMPACTING	系统内存资源不足；当Windows占用了多于1/8的CPU时间紧缩内存时，产生这条消息
pbm_compareitem	WM_COMPAREITEM	当新项被加入列表框或组合框时产生此消息，系统用这条消息进行项之间的比较
pbm_ctlcolor	WM_CTLCOLOR	一个控件即将被绘制，可在此时改变控件的颜色
pbm_deadchar	WM_DEADCHAR	用户选择了一种非英语字符集或其他特殊字符集，这将改变下面将要输入的字符
pbm_deleteitem	WM_DELETEITEM	从列表框或组合框中移去一项
pbm_destroyclipboard	WM_DESTROYCLIPBOARD	剪贴板内容被清除
pbm_devmodechanged	WM_DEVMODECHANGED	WIN.INI中的一个设备名被修改
pbm_drawclipboard	WM_DRAWCLIPBOARD	剪贴板内容发生改变
pbm_drawitem	WM_DRAWITEM	列表框或组合框的一项内容被改变
pbm_dropfiles	WM_DROPFILES	当鼠标左键在一个注册为拖放文件接受器的应用上释放时，发出该消息
pbm_erasebkgnd	WM_ERASEBKGND	窗口的客户区需要重画
pbm_fontchange	WM_FONTCHANGE	应用可用的字体数改变
pbm_getdlgcode	WM_GETDLGCODE	通知消息，说明当前使用哪种类型的键盘
pbm_getfont	WM_GETFONT	获取当前激活的字体
pbm_getminmaxinto	WM_GETMINMAXINTO	检索窗口可设置的最小或最大尺寸
pbm_gettext	WM_GETTEXT	从一个控件(如按钮或编辑器控件)中复制文本到一个内存缓冲区
pbm_gettextlength	WM_GETTEXTLENGTH	用来确定一个控件中的字符数
pbm_hscrollclipboard	WM_HSCROLLCLIPBOARD	剪贴板的水平滚动条被使用
pbm_iconerasebkgnd	WM_ICONERASEBKGND	一个最小化窗口需要重画背景
pbm_initdialog	WM_INITDIALOG	一个对话框即将被显示
pbm_initmenu	WM_INITMENU	一个菜单即将被显示
pbm_initmenupopup	WM_INITMENUPOPUP	一个弹出式窗口即将被显示
pbm_keydown	WM_KEYDOWN	键盘上的一个键被按下

续表

PB的事件ID	对应的系统消息	消息作用
pbm_keyup	WM_KEYUP	键盘上的一个键被释放
pbm_mdiactive	WM_MDIACTIVE	一个MDI子窗口（窗口）被激活
pbm_mdicascade	WM_MDICASCADE	以重叠的形式重排所有的窗口
pbm_mdicreate	WM_MDICREATE	创建一个窗口
pbm_mdidestroy	WM_MDIDESTROY	从MDI框架中移去一个窗口
pbm_mdigetactive	WM_MDIGETACTIVE	获得当前活动的MDI窗口的句柄
pbm_mdiiconrange	WM_MDIICONRANGE	在一个MDI框架中重排最小化窗口的图标
pbm_mdimaximize	WM_MDIMAXIMIZE	最大化一个MDI子窗口
pbm_mdinext	WM_MDINEXT	激活下一个MDI子窗口（紧接着活动窗口的窗口）
pbm_mdirestore	WM_MDIRESTORE	把MDI窗口恢复到它原来的大小
pbm_mdisetmenu	WM_MDISETMENU	将一个菜单与一个MDI窗口联系起来
pbm_mdifitle	WM_MDIFITLE	平铺所有的MDI窗口
pbm_measureitem	WM_MEASUREITEM	这个消息被送给即将创建的、内有按钮或其他控件的窗口
pbm_menuchar	WM_MENUCHAR	用户使用了一个快捷键,但系统不支持该快捷键
pbm_menuselect	WM_MENUSELECT	用户选择了一个菜单项
pbm_mouseactivate	WM_MOUSEACTIVATE	用户在一个非活动窗口中单击了鼠标
pbm_mousemove	WM_MOUSEMOVE	用户移动了鼠标
pbm_ncactivate	WM_NCACTIVATE	窗口的非客户区即将被激活
pbm_nccalcsize	WM_NCCALCSIZE	窗口的尺寸需要重新计算
pbm_nccreate	WM_NCCREATE	窗口即将创建它的非客户区
pbm_ncdestroy	WM_NCDESTROY	窗口的非共享区被析构
pbm_nchittest	WM_NCHITTEST	每次非客户区被移动时都发送该消息
pbm_nclbuttondblclk	WM_NCLBUTTONDBLCLK	用户在非客户区双击了鼠标
pbm_ncpaint	WM_NCPAINT	非客户需要画出
pbm_nextdlgctl	WM_NEXTDLGCTL	在对话框中将焦点转给另一个控件
pbm_paintclipboard	WM_PAINTCLIPBOARD	剪贴板应用有剪贴操作，剪贴板查看器需重画
pbm_paint	WM_PAINT	窗口的客户区需要被画出
PB的事件ID	对应的系统消息	消息作用
pbm_palettechanged	WM_PALETTECHANGED	系统调色板被改变
pbm_paletteischanging	WM_PALETTEISCHANGING	系统调色板即将被改变
pbm_parentnotify	WM_PARENTNOTIFY	通知父窗口一个子窗口即将被创建
pbm_querydragicon	WM_QUERYDRAGICON	用户要拖动一个最小化窗口
pbm_queryendsession	WM_QUERYENDSESSION	通知消息，说明窗口即将被关闭
pbm_querynewpalette	WM_QUERYNEWPALETTE	应用即将收到输入焦点，应该执行必要的颜色调整
pbm_queryopen	WM_QUERYOPEN	一个最小化窗口即将被恢复
pbm_quit	WM_QUIT	应用处理的最后一个消息

续表

PB的事件ID	对应的系统消息	消息作用
pbm_renderallformats	WM_RENDERALLFORMATS	通知一个剪贴板格式的拥有者，应用将失去所有的格式
pbm_renderformats	WM_RENDERFORMATS	通知消息，说明放在剪贴板中的数据应该用一种特殊格式传送
pbm_setcursor	WM_SETCURSOR	通知消息，说明鼠标指针在一个窗口中移动
pbm_setfont	WM_SETFONT	用来设置对话框中的字体
pbm_setredraw	WM_SETREDRAW	设置窗口是否重绘
pbm_settext	WM_SETTEXT	用来设置窗口的标题栏文本
pbm_sizeclipboard	WM_SIZECLIPBOARD	剪贴板查看器应用改变尺寸
pbm_spoolerstatus	WM_SPOOLERSTATUS	一个打印管理器任务被添加或删除
pbm_syschar	WM_SYSCHAR	ALT键和其他某键同时被按下
pbm_syscolorchange	WM_SYSCOLORCHANGE	一种或多种系统颜色被改变
pbm_syscommand	WM_SYSCOMMAND	窗口系统菜单控制消息
pbm_sysdeadchar	WM_SYSDEADCHAR	通知消息，说明一种非英语字符集被选定
pbm_syskeydown	WM_SYSKEYDOWN	用户按下某键的同时按下了ALT键
pbm_syskeyup	WM_SYSKEYUP	用户释放了ALT组合键
pbm_timechange	WM_TIMECHANGE	系统时钟被修改
pbm_undo	WM_UNDO	从undo缓冲区复制文本到编辑器控件
pbm_vkeytoitem	WM_VKEYTOITEM	当一个列表框拥有焦点时，用户按下了一个键
pbm_vscroll	WM_VSCROLL	用户单击了垂直滚动条
pbm_vscrollclipboard	WM_VSCROLLCLIPBOARD	剪贴板查看器的垂直滚动条被单击
pbm_windowposchanged	WM_WINDOWPOSCHANGED	窗口位置发生改变
pbm_windowposchanging	WM_WINDOWPOSCHANGING	窗口位置即将发生改变
pbm_wininichange	WM_WININICHANGE	WIN.INI文件被修改

（6）数据窗口（datawindow）控件自选事件：数据窗口控件是PB特有的一种控件对象。该控件的自选事件对窗口或其他控件许多消息进行了封装，包括列表框消息、窗口鼠标消息、滚动条消息，等等。由于Sybase公司并未公布数据窗口的内部机制，因此与系统消息的对应关系不得而知，但从事件ID的名称可以略知一二，如pbm_dwnlbuttondown事件与鼠标的WM_LBUTTONDOWN消息相对应。数据窗口具体自选事件及其作用如表1-7所示。

表1-7 数据窗口事件

PB的事件ID	消息作用
pbm_dwclosedropdown	关闭下拉式数据窗口
pbm_dwscrollend	在数据窗口中卷滚到最后一行
pbm_dwscrollhome	在数据窗口中卷滚到第一行

续表

PB的事件ID	消息作用
pbm_dwscrolllineend	卷滚到当前行的行尾（水平方向）
pbm_dwscrolllinehome	卷滚到当前行的行首（水平方向）
pbm_dwnbacktabout	即将通过Shift+Tab组合键离开该控件
pbm_dwnchanging	控件即将被改变
pbm_dwndropdown	下拉式列表框的下拉部分即将可见
pbm_dwngraphcreate	即将创建图形
pbm_dwnitemchangefocus	数据窗口控件中当前项的焦点改变
pbm_dwnitemvalidationerror	对当前项的修改引起了一个合法性检查错误
pbm_dwnkey	有键被按下。使用KeyDown()处理键盘值
pbm_dwnlbuttondown	鼠标左键被按下
pbm_dwnlbuttonup	鼠标左键被松开
pbm_dwnmbuttonclk	鼠标中键单击
pbm_dwnmbuttondbclk	鼠标中键双击
pbm_dwnmousemove	鼠标移动
pbm_dwnprintmarginchange	打印边界被改变
pbm_dwnprocessenter	回车键被按下
pbm_dwnrowchange	数据窗口中焦点从一行转向另一行
pbm_dwntabdownout	用户在数据窗口最后一行按了下箭头键
pbm_dwntabout	用户在数据窗口的最后一行/列中按了Tab键
pbm_dwntabupout	用户在数据窗口第一行中按了上箭头键

（7）动态数据交换（DDE）事件及对应的系统消息，如表1-8所示。

表1-8 动态数据交换(DDE)事件及对应的系统消息

PB的事件ID	对应的系统消息	消息作用
pbm_ddeddeack	WM_DDE_ACK	收到一个DDE消息
pbm_ddeddeinitiate	WM_DDE_INITIATE	开始一个DDE会话
pbm_ddeddeterminate	WM_DDE_TERMINATE	终止一个DDE会话

http://blog.csdn.net/hikaliv/article/details/4432555