OnNotify

注册一个函数或方法, 当通过 WM_NOTIFY 消息接收到控制通知时调用.

GuiControl.OnNotify(NotifyCode, Callback , AddRemove)

参数

GuiControl

类型: 对象

要监控的控件的 GuiControl 对象.

NotifyCode

类型: 整数

要监控的控件定义的通知代码.

Callback

类型: 字符串函数对象

事件发生时要调用的函数, 方法或对象.

如果 GUI 有事件接收器(即, 如果指定了 Gui()EventObj 参数), 那么这个参数可能是属于事件接收器的方法的名称.

否则, 这个参数必须是一个函数对象.

AddRemove

类型: 整数

如果为空或省略, 则默认为 1(在任何先前注册的回调之后调用回调). 否则, 指定下列数字之一:

WM_NOTIFY

每当发生要监控事件或控件需要从程序中获取信息时, 某些类型的控件就会发送一条 WM_NOTIFY 消息. 该消息的 lParam 参数包含一个指向包含通知信息的结构的指针. 结构的类型取决于通知代码和触发通知的控件类型, 但总是基于 NMHDR.

要确定哪些通知是可用的(如果有的话), 它们提供的结构类型以及它们如何解释返回值, 请参考控件的文档. Control Library (MSDN) 包含了每个 Windows 常用控件的链接. 通知代码(编号) 可以在 Windows SDK 中找到, 或者在互联网上搜索.

AutoHotkey 使用 idFromhwndFrom 字段来识别是哪个控件发送的通知, 以便将其派遣到相应的对象. code 字段包含通知代码. 由于这些字段必须与用于注册回调的 GuiControlNotifyCode 相匹配, 所以它们对脚本很少有用.

Callback 参数

OnEvent 中关于 this 和绑定函数的说明, 也适用于 OnNotify.

回调接收两个参数:

Callback(GuiControl, lParam)

如上所述, lParamNMHDR 导出的通知结构的地址. 它的确切类型取决于控件和通知代码的类型. 如果该结构包含了关于通知的附加信息, 回调可以用 NumGet 和/或 StrGet 检索它.

Callback 返回值

如果一个事件已经注册了多个回调, 回调可以返回一个非空值, 以防止任何剩余的回调被调用.

根据通知的不同, 返回值可能有额外的意义. 例如, 如果回调返回 TRUE(1), ListView 通知 LVN_BEGINLABELEDIT(-175 或 -105) 会阻止用户编辑标签.

OnEvent 的说明也适用于 OnNotify: 线程, 销毁 GUI.

OnCommand 可以用于作为 WM_COMMAND 消息发送的通知.

unixetc