_NewItem( ) (Rutina de biblioteca API)

Agrega un elemento con el identificador especificado itemid en el menú especificado por menuid.

int _NewItem(MENUID menuid, ITEMID itemid, ITEMID beforeid, char FAR *prompt)
MENUID menuid;            /* Menu identifier. */
ITEMID itemid;            /* New item identifier. */
ITEMID beforeid;            /* Identifier of item the new item
 precedes. */
char FAR *prompt;         /* Text for new menu item. */

Observaciones

El tipo del nuevo elemento de menú es automáticamente un título de menú o una barra, según el tipo de menú en que se inserte el elemento.

El parámetro beforeid especifica el identificador del elemento delante del cual va a situarse el nuevo elemento. Especifique beforeid como – 1 para indicar que el nuevo elemento será el primero de la lista o como - 2 para indicar que el elemento será el último de la lista. El prompt especifica el texto para el nuevo elemento de menú. _NewItem( ) devuelve 0 si se agrega un elemento; de lo contrario, devuelve – 1.

Para obtener más información acerca de cómo crear una biblioteca API e integrarla con Visual FoxPro, vea Acceso a la API de Visual FoxPro.

Ejemplo

El siguiente ejemplo construye un menú con tres elementos. Utiliza _NewItem( ) para agregar cada elemento al menú.

Código Visual FoxPro

SET LIBRARY TO NEWITEM 

Código C

#include <pro_ext.h>

void putLong(long n)
{
   Value val;

   val.ev_type = 'I';
   val.ev_long = n;
   val.ev_width = 10;

   _PutValue(&val);
}

FAR GetNewItemId(ParamBlk FAR *parm)
{
   MENUID menuId;
   ITEMID itemId;
   Point loc;

   menuId = _GetNewMenuId();
   _NewMenu(MPOPUP, menuId);

   itemId = _GetNewItemId(menuId);
   _NewItem(menuId, itemId, -2, "\\<2nd item");

   itemId = _GetNewItemId(menuId);
   _NewItem(menuId, itemId, -1, "\\<1st item");

   itemId = _GetNewItemId(menuId);
   _NewItem(menuId, itemId, -2, "\\<3rd item");

   loc.v = 10; loc.h = 20;
   _SetMenuPoint(menuId, loc);

   _MenuInteract(&menuId, &itemId);

   _PutStr("\nmenuId ="); putLong(menuId);
   _PutStr("\nitemId ="); putLong(itemId);

   _DisposeMenu(menuId);
}

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

Vea también

_SetItemCmdKey( ) (Rutina de biblioteca API) | _SetItemSubMenu( ) (Rutina de biblioteca API) | Acceso a la API de Visual FoxPro