Home   Index   About
Ultimate Pack


Custom Search
IMessageFilter

This IMessageFilter interface allows applications to handle incoming or outgoing messages selectively while waiting for responses from synchronous calls. The ability to filter messages is often useful when a dialog box is being displayed or a lengthy operation is in progress. Performance can be improved when applications handle some messages and defer others.

When to Implement

Implement IMessageFilter in place of OLE's default message handling when there is a need to selectively handle incoming or outgoing messages, while at the same time waiting for responses from synchronous calls.

Although not as significant an issue as with 16-bit applications, you may still need to implement IMessageFilter as a way of solving deadlocks. IMessageFilter is still needed to find out if an application is blocking, so that you can task-switch to that application and give the user an opportunity to deal with the blocking application. For example, if you have Word talking to Excel, with Excel running in the background in formula mode, Excel won't check all calls, thereby blocking further action. IMessageFilter would put up a dialog indicating which task is blocking and provide the user with an opportunity to deal with the deadlock.

For applications that do not implement IMessageFilter, incoming and outgoing calls to OLE are handled automatically by OLE's default message handling procedures. OLE provides default message handling for each of the conditions that would be handled by an IMessageFilter method. For incoming calls, OLE dispatches all calls, regardless of their logical thread ID. For incoming Windows messages or Macintosh events, the default behavior is as though IMessageFilter::MessagePending had returned PENDINGMSG_WAITDEFPROCESS. This means that task-switching and window-activation messages are dispatched, as well as WM_TIMER messages. Other input messages are discarded and OLE continues to wait for the reply.

When to Use

You don't call this interface directly. It's provided by the application and called by the system.

Methods in Vtable Order

IUnknown Methods
Description
QueryInterface
Returns a pointer to a specified interface.
AddRef
Increments the reference count.
Release
Decrements the reference count.

IMessageFilter Methods
Description
HandleIncomingCall
Provides a single entry point for incoming calls.
RetryRejectedCall
Provides application with opportunity to display dialog offering retry or cancel options or to switch tasks.
MessagePending
Indicates a Windows message has arrived while OLE is waiting to respond to a remote call.

See Also

In the WIN32 Programmer's Reference: "Messages and Message Queues"


Last news from Greatis Software

Nostalgia .Net     Nostalgia .Net     .Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes.  More »

Recommended software for developers

Ultimate Pack for Delphi and C++ Builder     Ultimate Pack     Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price.  More »

Form Designer .Net     Form Designer .Net     Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro!  More »

Print Suite .Net     Print Suite .Net     Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available  More »

Gradient Controls .Net     Gradient Controls .Net     Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available  More »

iGrid     Greatis iGrid     iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors.  More »


All the contacts and projects

Dmitry Vasiliev (just.dmitry)

Related Links

Software for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET

More Online Helps

Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages

Free Tech Secrets ;) Copyright © 2008-2012 Free Tech Secrets ;) greatis just4fun network just4fun