CBaseControlWindow::PossiblyEatMessage (Compact 2013)

3/26/2014

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 was not.

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_RBUTTONDBLCLK

WM_RBUTTONDOWN

WM_RBUTTONUP

WM_SYSCHAR

WM_SYSDEADCHAR

WM_SYSKEYDOWN

WM_SYSKEYUP

 

Requirements

Header

dshow.h,
Streams.h

Library

ole32.lib,
Ole32auth.lib,
Strmbase.lib,
Strmiids.lib,
uuid.lib

See Also

Reference

CBaseControlWindow Class