Click here for NewsObjects Overview
RemoveContextMenuItem Method (Alert Control)
Windows - Visual C++


Description
The RemoveContextMenuItem method removes an item from the context menu.

Syntax
long result = RemoveContextMenuItem(long winID, short menuID, short position);

The RemoveContextMenuItem syntax has these parts:

Part

Description

winID

A long integer specifying a valid Alert Banner. 

menuID

A short integer containing the menu ID of the menu from which the item should be removed.

position

The position in the menu of the menu item to be removed. The position is one-based.

result

A long integer containing 0 if successful and an error code if not.

Remarks
The context menu is the menu that appears when you right click in the background of an Alert Banner. It can be turned on or off by setting the ContextMenuEnabled property. The context menu is initially empty; you add your preferred menu items to it using the ContextMenuItem methods.

The menuID parameter is used to indicate whether to address the main context menu or a submenu. The menuID of the main context menu is always 0. The menuID of a submenu is returned when the submenu is created with AppendContextMenuSubmenu or InsertContextMenuSubmenu. Note that this menuID has no relation to any ID used by the Windows API.

See Also: AppendContextMenuItem AppendContextMenuSeparator AppendContextMenuSubmenu GetContextMenuItemCount InsertContextMenuItem InsertContextMenuSeparator InsertContextMenuSubmenu ContextMenu ContextMenuEnabled UpdateContextMenu

Back to: Alert Methods