IContextMenu::QueryContextMenu  1VY.D3R

[Now Supported on Windows NT]

Adds menu items to the specified menu. The menu items should be inserted at a specified position in the menu, and their menu item identifiers must be in a given range.

HRESULT QueryContextMenu(

    HMENU hmenu,

//Handle of the menu

    UINT indexMenu,

//Location to insert first menu item

    UINT idCmdFirst,

//Minimum value for a menu item identifier

    UINT idCmdLast,

//Maximum value for a menu item identifier

    UINT uFlags

//Specifies zero or more status values

   );

 

 

Parameters

hmenu

Handle of the menu. The handler should specify this handle when calling the InsertMenu1O2J7N8 or InsertMenuItem4GM3_TZ function.

indexMenu

Zero-based position at which to insert the first menu item.

idCmdFirst

Minimum value that the handler can specify for a menu item identifier.

idCmdLast

Maximum value that the handler can specify for menu item identifiers.

uFlags

Flag specifying zero or more of the following values:

CMF_DEFAULTONLY

The user is activating the default action, typically by double-clicking. This value provides a hint for the context menu to add nothing if it does not modify the default item in the menu. A context menu extension or drag-and-drop handler should not add any menu items if this value is specified. A name space extension should add only the default item (if any).

CMF_EXPLORE

Context menu handlers should ignore this value. It is specified when the context menu is for an object in the Explorer.

CMF_NORMAL

Indicates normal operation. A context menu extension, name-space extension, or drag and drop handler can add any menu items.

CMF_VERBSONLY

Context menu handlers should ignore this value. This value is specified if the context menu is for a shortcut object. This value is specified if the context menu is for a shortcut object.

 

The remaining bits of the low-order word are reserved by the system. The high-order word may be used for context-specific communications.

 

Return Values

Returns an HRESULT structure in which, if the method is successful, the code member contains the menu identifier offset of the last menu item added plus one.

Comments

The actual identifier of each menu item should be idCmdFirst plus a menu identifier offset in the range zero through (idCmdLast - idCmdFirst).

See Also

IContextMenu, InsertMenu, InsertMenuItem