Microsoft DirectX 8.1 (C++)

CBaseControlWindow::PossiblyEatMessage

The PossiblyEatMessage method forwards keyboard and mouse messages to a specified window.

Syntax

BOOL WINAPI PossiblyEatMessage(
    HWND hwndDrain,
    UINT uMsg,
    WPARAM wParam,
    LPARAM lParam
)

Parameters

hwndDrain

Handle of the window to which messages will be forwarded.

uMsg

Message that was forwarded.

wParam

First message parameter.

lParam

Second message parameter.

Return Value

Returns TRUE if the message was posted or FALSE if it wasn't.

Remarks

When the window is owned, it will pass certain classes of messages to the owning window (such as keyboard and mouse events). In this case, the Win32 PostMessage function is used to post messages to any window specified by hwndDrain which is set in CBaseControlWindow::put_MessageDrain. If a certain message cannot be posted, this message will return FALSE.

The following is a list of messages that will get passed on untranslated and return TRUE.

WM_CHAR WM_DEADCHAR
WM_KEYDOWN WM_KEYUP
WM_LBUTTONDBLCLK WM_LBUTTONDOWN
WM_LBUTTONUP WM_MBUTTONDBLCLK
WM_MBUTTONDOWN WM_MBUTTONUP
WM_MOUSEACTIVATE WM_MOUSEMOVE
WM_NCHITTEST WM_NCLBUTTONDBLCLK
WM_NCLBUTTONDOWN WM_NCLBUTTONUP
WM_NCMBUTTONDBLCLK WM_NCMBUTTONDOWN
WM_NCMBUTTONUP WM_NCMOUSEMOVE
WM_NCRBUTTONDBLCLK WM_NCRBUTTONDOWN
WM_NCRBUTTONUP WM_RBUTTONDBLCLK
WM_RBUTTONDOWN WM_RBUTTONUP
WM_SYSCHAR WM_SYSDEADCHAR
WM_SYSKEYDOWN WM_SYSKEYUP

See Also