Message or event hook functions
[Message functions]

Data Structures

• struct _HOOKINFO

Defines

• #define HOOK_GOON   0
• #define HOOK_STOP   1

Typedefs

• typedef int(* MSGHOOK )(void *context, HWND dst_wnd, int msg, WPARAM wparam, LPARAM lparam)

  Type of message hook function.
  

• typedef struct _HOOKINFO HOOKINFO
• typedef int(* SRVEVTHOOK )(PMSG pMsg)

  The type of the event hook.
  

Functions

• MG_EXPORT MSGHOOK GUIAPI RegisterKeyMsgHook (void *context, MSGHOOK hook)

  Registers a key message hook.
  

• MG_EXPORT MSGHOOK GUIAPI RegisterMouseMsgHook (void *context, MSGHOOK hook)

  Registers a mouse message hook.
  

• MG_EXPORT SRVEVTHOOK GUIAPI SetServerEventHook (SRVEVTHOOK SrvEvtHook)

  Sets an event hook in the server of MiniGUI-Processes.
  

---

Define Documentation

#define HOOK_GOON   0

See also:

SRVEVTHOOK RegisterKeyHookWindow RegisterMouseHookWindow

Definition at line 2819 of file window.h.

#define HOOK_STOP   1

See also:

SRVEVTHOOK RegisterKeyHookWindow RegisterMouseHookWindow

Definition at line 2825 of file window.h.

---

Typedef Documentation

typedef struct _HOOKINFO HOOKINFO

Structure defines a message hook.

typedef int(* MSGHOOK)(void *context, HWND dst_wnd, int msg, WPARAM wparam, LPARAM lparam)

Type of message hook function.

Definition at line 2835 of file window.h.

typedef int(* SRVEVTHOOK)(PMSG pMsg)

The type of the event hook.

You can call SetServerEventHook to set an event hook in the server of the MiniGUI-Processes.

If the event hook returns HOOK_GOON, mginit will continue to handle the event, and send it to the active client. If the hook returns HOOK_STOP, mginit will cancel normal handling.

See also:

SetServerEventHook

Definition at line 2902 of file window.h.

---

Function Documentation

MSGHOOK GUIAPI RegisterKeyMsgHook	(	void *	context,
		MSGHOOK	hook
	)

Registers a key message hook.

This function registers a key message hook pointed to by hook.

When the desktop receives a key message, it will send it to the hook first, and passes the context value to the hook as the first argument.

Parameters:

	context	The context value will be passed to the hook.
	hook	The hook. This function will unregister the old hook if hook is NULL.

Returns:

The old hook.

See also:

UnregisterHook, KEYMSGHOOK

MSGHOOK GUIAPI RegisterMouseMsgHook	(	void *	context,
		MSGHOOK	hook
	)

Registers a mouse message hook.

This function registers a mouse message hook pointed to by hook.

When the desktop receives a mouse message, it will send it to the hook first, and passes the context value to the hook as the first argument.

Parameters:

	context	The context value will be passed to the hook.
	hook	The hook. This function will unregister the old hook if hook is NULL.

Returns:

The old hook.

See also:

UnregisterHook, KEYMSGHOOK

void GUIAPI SetServerEventHook

(

SRVEVTHOOK

SrvEvtHook

)

Sets an event hook in the server of MiniGUI-Processes.

This function sets the event hook as SrvEvtHook in the server, i.e. mginit, of MiniGUI-Processes.

Parameters:

SrvEvtHook

The pointer to the hook, NULL to cancel the hook.

Note:

Only defined for MiniGUI-Processes, and only can be used by the server.

See also:

SRVEVTHOOK