_SetItemText( ) API Library Routine

Changes the displayed text for the specified menu item.

void _SetItemText(MENUID menuid, ITEMID itemid, char FAR *text)
MENUID menuid;            /* Menu identifier. */
ITEMID itemid;            /* Menu item identifier. */
char FAR *text;            /* Text. */

Remarks

The menu item can be either a menu title or a bar.

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 builds a menu with three items. It then changes the item text using _SetItemText( ).

Visual FoxPro Code

SET LIBRARY TO SETITEXT

C Code

#include <pro_ext.h>

FAR SetItemTextEx(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 'Original item text'");

   _SetItemText(menuId, _GetItemId(menuId, 0), 
      "This was the 1st item");
   _SetItemText(menuId, _GetItemId(menuId, 1), 
      "This was the 2nd item");
   _SetItemText(menuId, _GetItemId(menuId, 2), 
      "This was the 3rd item");

   _Execute("WAIT WINDOW 'New item text'");
   _DisposeMenu(menuId);
}

FoxInfo myFoxInfo[] = {
   {"ONLOAD", (FPFI) SetItemTextEx, CALLONLOAD, ""},
};
FoxTable _FoxTable = {
   (FoxTable FAR *) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo
};

See Also

_GetItemId( ) API Library Routine | _GetItemText( ) API Library Routine | _SetItemCmdKey( ) API Library Routine | Accessing the Visual FoxPro API