_ActivateMenu( ) (Rutina de biblioteca API)

Muestra el menú especificado en la pantalla e inmediatamente devuelve el control a la rutina que realiza la llamada.

void _ActivateMenu(MENUID menuid)
MENUID menuid            /* Menu identifier.

Observaciones

Si detecta la pulsación de un botón del mouse (ratón) o de una tecla en el menú, puede llamar a _MenuInteract( ) para determinar la opción de menú que el usuario escoge.

Para obtener más información a cerca 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 opciones. _ActivateMenu( ) muestra el menú. Este menú es no modal en el sentido de que su interacción no se fuerza como con _MenuInteract( ). Más bien, cuando el usuario realiza una selección, la rutina _OnSelection( ) se llama, la opción se imprime en la pantalla y el menú se repliega.

Código Visual FoxPro

SET LIBRARY TO ACTIMENU
WAIT WINDOW "Make selection from menu." NOWAIT
SUSPEND

Código C

#include <pro_ext.h>

static MENUID menuId;

void putLong(long n)
{
   Value val;

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

   _PutValue(&val);
}

FAR onSelection(long menuId, long itemId)
{
   _PutStr("\nitemId = "); putLong(itemId);
}

FAR deactivateMenu(ParamBlk FAR *parm)
{
   _DeActivateMenu(menuId);
   _DisposeMenu(menuId);
}

FAR activateMenu(ParamBlk FAR *parm)
{
   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);
   _OnSelection(menuId, -1, onSelection);
}

FoxInfo myFoxInfo[] = {
   {"ONLOAD", (FPFI) activateMenu, CALLONLOAD, ""},
   {"ONUNLOAD", (FPFI) deactivateMenu, CALLONUNLOAD, ""},
};

FoxTable _FoxTable = {
   (FoxTable FAR *) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo
};

Vea también

_DeActivateMenu( ) (Rutina de biblioteca API) | _MenuId( ) (Rutina de biblioteca API) | _NewItem( ) (Rutina de biblioteca API) | _NewMenu( ) (Rutina de biblioteca API) | _OnSelection( ) (Rutina de biblioteca API) | _MenuInteract( ) (Rutina de biblioteca API) | _OnSelection( ) (Rutina de biblioteca API)