The ShellProc hook procedure is an application-defined or library-defined callback function used with the SetWindowsHookEx function. The function receives notifications of Shell events from the system.

The HOOKPROC type defines a pointer to this callback function. ShellProc is a placeholder for the application-defined or library-defined function name.

ShellProc钩子子程是同SetWindowsHookEx一起使用的、应用程序定义的或者库定义的回调函数。该方法接收来自系统的加壳事件通知。HOOKPROC类型定义了指向该方法的指针。ShellProc是应用程序定义的或者库定义的方法的名字。 本文来自智动软件zdwork.cn

Syntax 语法 本文来自智动软件zdwork.cn

LRESULT CALLBACK ShellProc(     

    int nCode, 内容来自zdwork.cn

    WPARAM wParam, zdwork.cn

    LPARAM lParam 智动软件

);

智动软件

Parameters参数 内容来自zdwork.cn

nCode ：[in] Specifies the hook code. If nCode is less than zero, the hook procedure must pass the message to the CallNextHookEx function without further processing and should return the value returned by CallNextHookEx. This parameter can be one of the following values. www.zdwork.cn

指定钩子代码。如果nCode小于0，钩子子程必须将消息传递给CallNextHookEx方法，自己不进行进一步的处理，并且应该返回由CallNextHookEx方法返回的返回值。该参数可以是下列值： 内容来自zdwork.cn

1．HSHELL_ACCESSIBILITYSTATE 智动软件

Windows 2000/XP: The accessibility state has changed. 可访问性已经改2．HSHELL_ACTIVATESHELLWINDOW

zdwork.cn

The shell should activate its main window. 外壳应该激活它的主窗口。3．HSHELL_APPCOMMAND

Windows 2000/XP: The user completed an input event (for example, pressed an application command button on the mouse or an application command key on the keyboard), and the application did not handle the WM_APPCOMMAND message generated by that input. zdwork.cn

用户完成一个输入事件(例如，按下应用程序鼠标上的命令按钮或者键盘上的命令键)，应用程序没有处理由该输入产生的WM_APPCOMMAND 消息。

copyright 智动软件

If the Shell procedure handles the WM_COMMAND message, it should not call CallNextHookEx. See the Return Value section for more information.

如果Shell子程获得了WM_COMMAND消息的句柄，不应该调用CallNextHookEx 。

www.zdwork.cn

4．HSHELL_GETMINRECT

A window is being minimized or maximized. The system needs the coordinates of the minimized rectangle for the window. 窗口正在被最小化或者最大化。系统需要窗体的最小矩形框的坐标。 智动软件

5．HSHELL_LANGUAGE 本文来自智动软件zdwork.cn

Keyboard language was changed or a new keyboard layout was loaded.键盘语言被改变了或者新的键盘布局被加载了。 www.zdwork.cn

6．HSHELL_REDRAW copyright 智动软件

The title of a window in the task bar has been redrawn. 任务栏中的窗口标题被重绘了。

7．HSHELL_TASKMAN 智动软件

The user has selected the task list. A shell application that provides a task list should return TRUE to prevent Microsoft Windows from starting its task list. 用户选择了任务列表。提供了任务列表的加壳应用程序应该返回TRUE,来阻止windows启动任务列表。 智动软件

8．HSHELL_WINDOWACTIVATED

本文来自智动软件zdwork.cn

The activation has changed to a different top-level, unowned window. 激活动作变成了不同的top-level，unowned 的窗口。(即，激活了不同的不明窗口，使其处于最上层。) 内容来自zdwork.cn

9．HSHELL_WINDOWCREATED 智动软件

A top-level, unowned window has been created. The window exists when the system calls this hook. 顶层的、不受控制的窗体已经被创建。当系统调用该钩子时，窗口存在。 内容来自zdwork.cn

10．HSHELL_WINDOWDESTROYED 本文来自智动软件zdwork.cn

A top-level, unowned window is about to be destroyed. The window still exists when the system calls this hook. 顶层的、不受控制的窗体即将被销毁。当系统调用该钩子的时候该窗体依然存在。

内容来自zdwork.cn

11．HSHELL_WINDOWREPLACED 本文来自智动软件zdwork.cn

Windows XP: A top-level window is being replaced. The window exists when the system calls this hook. 在Windows XP环境下，顶层的窗体正在被替换掉。当系统调用该钩子时，窗口存在。 内容来自zdwork.cn

wParam www.zdwork.cn

[in] The value depends on the value of the nCode parameter, as shown in the following table.该值取决于参数 nCode ，如下表所示。 www.zdwork.cn

nCode copyright 智动软件	wParam 本文来自智动软件zdwork.cn
HSHELL_ACCESSIBILITYSTATE copyright 智动软件	Windows 2000/XP: Indicates which accessibility feature has changed state. This value is one of the following: ACCESS_FILTERKEYS,ACCESS_MOUSEKEYS, or ACCESS_STICKYKEYS. 智动软件 在Windows XP 环境下：指示哪种访问特征已经被改变了状态。值可以是下列之一：ACCESS_FILTERKEYS,ACCESS_MOUSEKEYS, ACCESS_STICKYKEYS. copyright 智动软件
HSHELL_APPCOMMAND zdwork.cn	Windows 2000/XP: Where the WM_APPCOMMAND message was originally sent; for example, the handle to a window. 本文来自智动软件zdwork.cn 是WM_APPCOMMAND消息最初发出的位置，例如，窗口的句柄。 内容来自zdwork.cn
HSHELL_GETMINRECT 智动软件	Handle to the minimized or maximized window.最小化或者最大化的窗体的句柄。 智动软件
HSHELL_LANGUAGE 本文来自智动软件zdwork.cn	Handle to the window.窗口句柄。 智动软件
HSHELL_REDRAW 本文来自智动软件zdwork.cn	Handle to the redrawn window.重化窗口句柄。 智动软件
HSHELL_WINDOWACTIVATED zdwork.cn	Handle to the activated window.活动窗口句柄。 www.zdwork.cn
HSHELL_WINDOWCREATED 智动软件	Handle to the created window.被创建的窗口的句柄。 zdwork.cn
HSHELL_WINDOWDESTROYED 智动软件	Handle to the destroyed window.被销毁的窗口的句柄。 本文来自智动软件zdwork.cn
HSHELL_WINDOWREPLACED 内容来自zdwork.cn	Windows XP: Handle to the window being replaced.即将被替换的窗体的句柄。 本文来自智动软件zdwork.cn

lParam copyright 智动软件

[in] The value depends on the value of the nCode parameter, as shown in the following table. 该值取决于参数nCode。如下表所示。 智动软件

nCode zdwork.cn	lParam www.zdwork.cn
HSHELL_APPCOMMAND 内容来自zdwork.cn	Windows 2000/XP:GET_APPCOMMAND_LPARAM(lParam) is the application command corresponding to the input event. 智动软件 GET_APPCOMMAND_LPARAM是对输入事件做出响应的应用程序命令。 zdwork.cn GET_DEVICE_LPARAM(lParam) indicates what generated the input event; for example, the mouse or keyboard. copyright 智动软件 GET_DEVICE_LPARAM指示是什么生成了输入事件。例如，鼠标或者键盘。 www.zdwork.cn GET_FLAGS_LPARAM(lParam) depends on the value of cmd in WM_APPCOMMAND. For example, it might indicate which virtual keys were held down when the WM_APPCOMMAND message was originally sent. GET_FLAGS_LPARAM(lParam)依赖于 WM_APPCOMMAND中CMD的值。例如，可以指示当WM_APPCOMMAND消息被发出的时候，哪个虚拟键被按下。 copyright 智动软件   copyright 智动软件
HSHELL_GETMINRECT zdwork.cn	Pointer to a RECT structure.    RECT结构的指针 本文来自智动软件zdwork.cn
HSHELL_LANGUAGE www.zdwork.cn	Handle to a keyboard layout.   键盘布局的句柄。 本文来自智动软件zdwork.cn
HSHELL_REDRAW www.zdwork.cn	The value is TRUE if the window is flashing, or FALSE otherwise.  如果窗口正在闪烁（重绘过程中），该值为true，其他为false 内容来自zdwork.cn
HSHELL_WINDOWACTIVATED zdwork.cn	The value is TRUE if the window is in full-screen mode, or FALSE otherwise. 如果窗体处于全屏模式，该值是true，否则为false。 本文来自智动软件zdwork.cn
HSHELL_WINDOWREPLACED 智动软件	Windows XP: Handle to the new window.新窗体的句柄。 copyright 智动软件

Return Value返回值 本文来自智动软件zdwork.cn

The return value should be zero unless the value of nCode is HSHELL_APPCOMMAND and the shell procedure handles the WM_COMMAND message. In this case, the return should be nonzero.

如果nCode的值是HSHELL_APPCOMMAND，shell子程句柄指向WM_COMMAND 消息，在这种情况下，返回值是非0。其他情况下，返回值是0。 copyright 智动软件

Remarks备注 zdwork.cn

Install this hook procedure by specifying the WH_SHELL hook type and a pointer to the hook procedure in a call to the SetWindowsHookEx function. 通过指定WH_SHELL 钩子类型以及在SetWindowsHookEx的方法中的指向钩子子程的指针来安装该钩子子程。

本文来自智动软件zdwork.cn

Helios  2007-5-31 智动软件