Message or event hook functions

Data Structures
struct	_HOOKINFO

Macros
#define	HOOK_GOON   0
#define	HOOK_STOP   1

Typedefs
typedef int(*	MSGHOOK) (void *context, HWND dst_wnd, UINT msg, WPARAM wparam, LPARAM lparam)
	Type of message hook function. More...
typedef struct _HOOKINFO	HOOKINFO
typedef int(*	SRVEVTHOOK) (PMSG pMsg)
	The type of the event hook. More...

Functions
MG_EXPORT MSGHOOK GUIAPI	RegisterKeyMsgHook (void *context, MSGHOOK hook)
	Registers a key message hook. More...
MG_EXPORT MSGHOOK GUIAPI	RegisterMouseMsgHook (void *context, MSGHOOK hook)
	Registers a mouse message hook. More...
MG_EXPORT SRVEVTHOOK GUIAPI	SetServerEventHook (SRVEVTHOOK SrvEvtHook)
	Sets an event hook in the server of MiniGUI-Processes. More...

Detailed Description

Macro Definition Documentation

HOOK_GOON

#define HOOK_GOON   0

See also

SRVEVTHOOK RegisterKeyHookWindow RegisterMouseHookWindow

Definition at line 3675 of file window.h.

HOOK_STOP

#define HOOK_STOP   1

See also

SRVEVTHOOK RegisterKeyHookWindow RegisterMouseHookWindow

Definition at line 3681 of file window.h.

Typedef Documentation

HOOKINFO

typedef struct _HOOKINFO HOOKINFO

Structure defines a message hook.

MSGHOOK

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

Type of message hook function.

Definition at line 3691 of file window.h.

SRVEVTHOOK

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 3758 of file window.h.

Function Documentation

RegisterKeyMsgHook()

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

RegisterMouseMsgHook()

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

SetServerEventHook()

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