IMessageFormHost
The IMessageFormHost interface is used in the creation of message forms for both composing and reading. Do not implement this interface. It is exposed by the e-mail application, and you call into it only as necessary.
Note The IMessageFormHost interface is available only on Windows Mobile 2002. For Windows Mobile 2003 and later, use the IMessageFormHostEx interface.
Methods in Vtable Order
| IMessageFormHost methods | Description |
|---|---|
| GetParentHWND | Provides a handle to the mail application's parent window. |
| FormClosing | Called by the IMessageForm object when the form is closing. |
| GetGlobalSetting | Gets the value of the global setting from Messaging. |
| SetGlobalSetting | Sets the value of the global setting for Messaging. |
| DoAction | Used to request that Messaging perform a specific action for the plug-in. |
| CreateNewMessage | Creates a new message in the Drafts folder. |
Nonvirtual Members
| IMessageFormHost members | Description |
|---|---|
| eMsgStatus | Enumeration used by IMessageFormHost::FormClosing to indicate how to close a message form. |
| actions | Enumeration used by IMessageFormHost::DoAction to indicate the action for Messaging to perform for a plug-in. |
Remarks
Use IMessageFormHost methods when you want your Messaging plug-in to communicate with the Messaging application.
This interface is provided by the Messaging application when it calls IFormProvider::ComposeMessageForm or IFormProvider::CreateReadForm. IMessageFormHost allows the custom form to request that Messaging perform particular actions, such as creating a new message in the drafts folder or handling messages that are not handled by the custom form.
Requirements
Smartphone: Windows Mobile 2002
OS Versions: Windows CE 3.0
Header: cemapi.h
Library: cemapi.lib
See Also
IFormProvider::CreateComposeForm
Last updated on Friday, April 22, 2005
© 2005 Microsoft Corporation. All rights reserved.
Send feedback on this topic to the authors.