OleUIAddVerbMenu

Adds the Verb menu for the specified object to the given menu.

BOOL OleUIAddVerbMenu(
  LPOLEOBJECT *lpOleObj,  //Pointer to the object
  LPCTSTR lpszShortType,  //Pointer to the short name corresponding 
                          // to the object
  HMENU hMenu,            //Handle to the menu to modify
  UINT uPos,              //Position of the menu item.
  UINT uIDVerbMin,        //Value at which to start the verbs
  UINT uIDVerbMax,        //Maximum identifier value for object verbs
  BOOL bAddConvert,       //Whether to add convert item
  UINT idConvert,         //Value to use for the convert item
  HMENU FAR * lphMenu     //Pointer to the cascading verb menu, if 
                          // created
);
 

Parameters

lpOleObj

[in] Pointer to the IOleObject interface on the selected object. If this is NULL, then a default disabled menu item is created.

lpszShortType

[in] Pointer to the short name defined in the registry (AuxName==2) for the object identified with lpOleObj. If the string is NOT known, then NULL may be passed. If NULL is passed, IOleObject::GetUserType is called to retrieve it. If the caller has easy access to the string, it is faster to pass it in.

hMenu

[in] Handle to the menu in which to make modifications.

uPos

[in] Position of the menu item.

iIDVerbMin

[in] The UINT identifier value at which to start the verbs.

uIDVerbMax

[in] The UINT Maximum identifier value to be used for object verbs. If uIDVerbMax is 0, then no maximum identifier value is used.

bAddConvert

[in] The BOOL specifying whether or not to add a Convert item to the bottom of the menu (preceded by a separator).

idConvert

[in] The UINT identifier value to use for the Convert menu item, if bAddConvert is TRUE.

lphMenu

[out] An HMENU pointer to the cascading verb menu if it's created. If there is only one verb, this will be filled with NULL.

Return Values

TRUE

Indicates lpOleObj was valid and at least one verb was added to the menu.

FALSE

Indicates lpOleObj was NULL and a disabled default menu item was created.

Remarks

If the object has one verb, the verb is added directly to the given menu. If

QuickInfo

  Windows NT: Use version 3.1 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in oledlg.h.
  Import Library: Included as a resource in oledlg.dll.