_DisposeItem( ) API Library Routine

Visual FoxPro 9.0 SP2

_DisposeItem( ) API Library Routine


void _DisposeItem(MENUID menuid, ITEMID itemid) MENUID menuid; /* Menu identifier. / ITEMID itemid; / Menu item identifier. */

Remarks

_DisposeItem( ) doesn't release any submenus that are associated with the item.

For more information on how to create an API library and integrate it with Visual FoxPro, see Accessing the Visual FoxPro API.

Example

The following example creates a menu with three items and then uses _DisposeItem( ) to remove two of the items.

Visual FoxPro Code

	Copy Code
SET LIBRARY TO DISPITEM

C Code

	Copy Code
#include <pro_ext.h> FAR DisposeItemEx(ParamBlk FAR parm) { MENUID menuId; ITEMID itemId; Point loc; menuId = _GetNewMenuId(); _NewMenu(MPOPUP, menuId); itemId = _GetNewItemId(menuId); _NewItem(menuId, itemId, -2, "\\<1st item"); itemId = _GetNewItemId(menuId); _NewItem(menuId, itemId, -2, "\\<2nd item"); itemId = _GetNewItemId(menuId); _NewItem(menuId, itemId, -2, "\\<3rd item"); loc.v = 10; loc.h = 20; _SetMenuPoint(menuId, loc); _ActivateMenu(menuId); _Execute("WAIT WINDOW 'Menu has three items'"); _DisposeItem(menuId, _GetItemId(menuId, 1)); _Execute("WAIT WINDOW 'Menu has two items'"); _DisposeItem(menuId, _GetItemId(menuId, 0)); _Execute("WAIT WINDOW 'Menu has one item'"); _DisposeMenu(menuId); } FoxInfo myFoxInfo[] = { {"ONLOAD", (FPFI) DisposeItemEx, CALLONLOAD, ""}, }; FoxTable _FoxTable = { (FoxTable FAR ) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo };

Copy Code

#include <pro_ext.h>
FAR DisposeItemEx(ParamBlk FAR *parm)
{
   MENUID menuId;
   ITEMID itemId;
   Point loc;
   menuId = _GetNewMenuId();
   _NewMenu(MPOPUP, menuId);
   itemId = _GetNewItemId(menuId);
   _NewItem(menuId, itemId, -2, "\\<1st item");
   itemId = _GetNewItemId(menuId);
   _NewItem(menuId, itemId, -2, "\\<2nd item");
   itemId = _GetNewItemId(menuId);
   _NewItem(menuId, itemId, -2, "\\<3rd item");
   loc.v = 10; loc.h = 20;
   _SetMenuPoint(menuId, loc);
   _ActivateMenu(menuId);
   _Execute("WAIT WINDOW 'Menu has three items'");
   _DisposeItem(menuId, _GetItemId(menuId, 1));
   _Execute("WAIT WINDOW 'Menu has two items'");
   _DisposeItem(menuId, _GetItemId(menuId, 0));
   _Execute("WAIT WINDOW 'Menu has one item'");
   _DisposeMenu(menuId);
}
FoxInfo myFoxInfo[] = {
   {"ONLOAD", (FPFI) DisposeItemEx, CALLONLOAD, ""},
};
FoxTable _FoxTable = {
   (FoxTable FAR *) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo
};

_DisposeItem( ) API Library Routine

Remarks

Example

Visual FoxPro Code

C Code

See Also

Tasks

Reference

Other Resources