Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄Function Group►  ◄Overview►                          ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINHOOKS
 
BOOL WinCallMsgFilter(hab, pqmsg, msgf)
HAB hab;        /* handle of the anchor block        */
PQMSG pqmsg;    /* address of structure with message */
USHORT msgf;    /* message-filter code               */
 
The WinCallMsgFilter function calls a message-filter hook. This function
allows an application to pass a message to the message-filter hook
procedure(s).
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hab        Identifies the anchor block.
 
pqmsg      Points to the QMSG structure that contains the message to be
           passed to the message-filter hook procedure.
 
msgf       Specifies the message-filter code passed to the message-filter
           hook. This can be one of the following values:
 
           Message          Meaning
           ─────────────────────────────────────────────────────────────────
           MSGF_DIALOGBOX   Message originated while processing a modal
                            dialog.
 
           MSGF_MESSAGEBOX  Message originated while processing a message
                            box.
 
           MSGF_TRACK       Message originated while tracking a control,
                            such as a scroll bar.
 
Return Value
 
The return value is TRUE if a message-filter hook returned TRUE. Otherwise,
it is FALSE, indicating that all message-filter hooks returned FALSE or that
no message-filter hooks are defined.
 
See Also
 
WinDispatchMsg, WinGetMsg, QMSG
 
                                      ♦