II3IDMenuItem::AddMenuItem Method

Synopsis

Adds a child menu to this menu item in Interaction Designer's Utility Menu.

IDL Function Prototype

HRESULT AddMenuItem(

   [in] BSTR MenuItemText,

   [in, optional, defaultvalue(0)] VARIANT_BOOL Checked,

   [in, optional, defaultvalue(0)] VARIANT_BOOL Enabled,

   [in, optional] VARIANT MenuEventNotifier,

   [out, retval] II3IDMenuItem ** NewMenu

);

C/C++ Syntax

HRESULT AddMenuItem(BSTR MenuItemText, VARIANT_BOOL Checked, VARIANT_BOOL Enabled, VARIANT MenuEventNotifier, II3IDMenuItem ** NewMenu);

Parameters

MenuItemText

The text that will appear in the new menu item.

Checked

Set this Boolean value True to check the menu item. Specify False to uncheck the item.

Enabled

Set this Boolean value True to enable the menu item. Specify False to disable.

MenuEventNotifier

Specifies what object Interaction Designer should call to process a menu event. This can be a variant that contains an IDispatch pointer, an IUnknown pointer, or a BSTR. If you specify a BSTR in the VARIANT, Interaction Designer will treat that string as a ProgId, create the object using that ProgId and QueryInterface the created object for an II3IDMenuEvents interface pointer. For an IDispatch or IUnknown pointer, Interaction Designer will call QueryInterface on that pointer for the II3IDMenuEvents interface.

NewMenu

The return value is a new II3IDMenuItem object.