Message Form Host Command Bar Capability Flags

4/8/2010

These constants represent menu items that can appear on a messaging add-in menu bar. There are two sets:

  • The Standard set is used with Messaging add-ins based on IMessageFormEx. For more information, see The Standard Set of Command Bar Capability Flags below.
  • The Extended set is used with Messaging add-ins based on IMessageFormEx2. For more information, see The Extended Set of Command Bar Capability Flags below.

The Standard Set of Command Bar Capability Flags

When used with Messaging add-ins based on IMessageFormEx, these constants are used as flags, and can be combined with bitwise OR to form a bitmask that can be used to create the IMessageFormEx::GetMenuCapabilities members dwFlags and pdwEnable.

When used with Messaging add-ins based on IMessageFormEx2, these constants are used as enumeration values for the IMessageFormEx2::GetMenuCapability dwCapability parameter.

Constant Value Description

MESSAGEFORMHOST2_CMDBARCAP_COPY

0x1

The Copy menu item.

MESSAGEFORMHOST2_CMDBARCAP_CUT

0x2

The Cut menu item.

MESSAGEFORMHOST2_CMDBARCAP_PASTE

0x4

The Paste menu item.

MESSAGEFORMHOST2_CMDBARCAP_SELECTALL

0x8

The Select All menu item.

MESSAGEFORMHOST2_CMDBARCAP_CLEAR

0x10

The Clear menu item.

MESSAGEFORMHOST2_CMDBARCAP_SAVETOCONTACTS

0x20

The Save To Contacts menu item.

MESSAGEFORMHOST2_CMDBARCAP_FORWARD

0x40

The Forward menu item.

MESSAGEFORMHOST2_CMDBARCAP_REPLY

0x80

The Reply menu item.

MESSAGEFORMHOST2_CMDBARCAP_REPLYALL

0x100

The Reply All menu item.

MESSAGEFORMHOST2_CMDBARCAP_MARKASUNREAD

0x200

The Mark As Unread menu item.

MESSAGEFORMHOST2_CMDBARCAP_GETFULLMESSAGE

0x400

The Get Full Message menu item.

MESSAGEFORMHOST2_CMDBARCAP_MOVETO

0x800

The Move To menu item.

MESSAGEFORMHOST2_CMDBARCAP_LANGUAGE

0x1000

The Language menu item.

MESSAGEFORMHOST2_CMDBARCAP_ADDATTACHMENT

0x2000

The Add Attachment menu item.

MESSAGEFORMHOST2_CMDBARCAP_SPELLCHECK

0x4000

The Spell Check menu item.

MESSAGEFORMHOST2_CMDBARCAP_CHECKNAMES

0x8000

The Check Names menu item.

MESSAGEFORMHOST2_CMDBARCAP_OPTIONS

0x20000

The Options menu item.

MESSAGEFORMHOST2_CMDBARCAP_MYTEXTMESSAGE

0x40000

The My Text Messages menu item.

MESSAGEFORMHOST2_CMDBARCAP_MYTEXTMESSAGESEDIT

0x80000

The My Text Messages Edit menu item.

MESSAGEFORMHOST2_CMDBARCAP_MTGACCEPT

0x100000

The Accept Meeting menu item.

MESSAGEFORMHOST2_CMDBARCAP_MTGDECLINE

0x200000

The Decline Meeting menu item.

MESSAGEFORMHOST2_CMDBARCAP_MTGTENTATIVE

0x400000

The Tentative Meeting menu item.

MESSAGEFORMHOST2_CMDBARCAP_MTGREMOVEFROMCAL

0x800000

The Remove Meeting From Calendar menu item.

MESSAGEFORMHOST2_CMDBARCAP_CONTACTSPICKER

0x1000000

The Add Recipient menu item.

MESSAGEFORMHOST2_CMDBARCAP_VOICERECORDER

0x2000000

The Voice Recorder menu item.

MESSAGEFORMHOST2_CMDBARCAP_INSERTPICTURE

0x4000000

The Insert Picture menu item.

MESSAGEFORMHOST2_CMDBARCAP_CALLVOICEMAIL

0x8000000

The Call Voice Mail menu item.

The Extended Set of Command Bar Capability Constants

These constants are used with Messaging add-ins based on IMessageFormEx2. They are used as enumeration values, and are passed to IMessageFormEx2::GetMenuCapability in the dwCapability parameter.

Constant Value Description

MESSAGEFORMHOST2_CMDBARCAP_EX_BASE

0x90000000

The base value.

MESSAGEFORMHOST2_CMDBARCAP_EX_SAVE

MESSAGEFORMHOST2_CMDBARCAP_EX_BASE

The Save menu item. Saves a copy of the message to the Drafts folder.

MESSAGEFORMHOST2_CMDBARCAP_EX_VIEW_ZOOM

(MESSAGEFORMHOST2_CMDBARCAP_EX_BASE + 1)

The Zoom menu item. For more information, see IMessageFormEx::FORMACTIONS.

MESSAGEFORMHOST2_CMDBARCAP_EX_GET_HTML

(MESSAGEFORMHOST2_CMDBARCAP_EX_BASE + 2)

The Get HTML menu item.

MESSAGEFORMHOST2_CMDBARCAP_EX_FOLLOWUPFLAG

(MESSAGEFORMHOST2_CMDBARCAP_EX_BASE + 3)

The Follow-up Flag menu item.

MESSAGEFORMHOST2_CMDBARCAP_EX_DELETE

(MESSAGEFORMHOST2_CMDBARCAP_EX_BASE + 4)

The Delete menu item.

MESSAGEFORMHOST2_CMDBARCAP_EX_FOLLOWUPFLAG_COMPLETE

(MESSAGEFORMHOST2_CMDBARCAP_EX_BASE + 5)

The Flag Complete menu item.

Note: This action is disabled for Meeting Requests.

MESSAGEFORMHOST2_CMDBARCAP_EX_MAX

MESSAGEFORMHOST2_CMDBARCAP_EX_FOLLOWUPFLAG_COMPLETE

The value that marks the end of the MESSAGEFORMHOST2_CMDBARCAP_EX enumeration.

Remarks

The user can access the Zoom item on the View menu (MESSAGEFORMHOST2_CMDBARCAP_EX_VIEW_ZOOM) while viewing HTML e-mail from within the Read Form. This menu item has five sub-items, each corresponding to one of the five zoom levels. Note that it is your responsibility to implement these commands (or to disable them).

See Also

Reference

IMessageFormEx::GetMenuCapabilities
IMessageFormEx::FORMACTIONS
IMessageFormEx
IMessageFormEx2
IMessageFormEx2::GetMenuCapability

Other Resources

MAPI Flags