MENUMODAL()
 Activa una barra superior de menús
------------------------------------------------------------------------------
 Sintaxis

     MENUMODAL(<oBarraSup>, <nSelección>, <nFilaMsj>,
        <nIzqMsj>, <nDerMsj>, <cColorMsj>) --> MenúID

 Argumentos

     <oBarraSup> es un objeto de la clase TopBarMenu creado a partir de
     la clase TopBarMenu.

     <nSelección> es el elemento de TopBarMenu seleccionado por
     defecto.

     <nFilaMsj> es el número de fila donde aparecen los mensajes
     asociados a los elementos de menú.

     <nIzqMsj> especifica el borde izquierdo para los mensajes asociados
     a los elementos de menú.

     <nDerMsj> especifica el borde derecho para los mensajes asociados a
     los elementos de menú.

     <cColorMsj> es la cadena de caracteres que define el color de los
     mensajes asociados a los elementos de menú. Contiene dos colores: el de
     primer plano y el color de fondo.

 Devuelve

     MENUMODAL() devuelve el ID del elemento de menú seleccionado. Los IDs
     de menú se asignan utilizando la clase MenuItem.

 Descripción

     MENUMODAL() es una función de interfaz de usuario que implementa el
     sistema de menús emergente de CA-Clipper. Es parte de la arquitectura
     abierta del sistema Get de CA-Clipper. MENUMODAL() es similar al
     mandato READ en cuanto que queda a la espera de que se produzca una
     acción por parte del usuario. No obstante, la función MENUMODAL() sólo
     responde a acciones de menú.

     Para implementar un objeto menú a la vez que se crean otros objetos,
     utilice la función READMODAL() que tiene como argumento un objeto
     TopBarMenu.

     Cuando el usuario selecciona un elemento de menú, el control pasa a su
     bloque de código asociado. Los bloques de código se definen utilizando
     la clase MenuItem.

     Los elementos de menú pueden seleccionarse con el teclado y con el
     ratón. Para seleccionarlos mediante el ratón, simplemente haga clic en
     el elemento adecuado de la barra del menús y, a continuación, elija el
     elemento de menú deseado.

     Nota: La función MENUMODAL() tomará un evento de menú del usuario y
     terminará a continuación. Para que esto no ocurra, puede utilizarse el
     siguiente programa que procesa continuamente eventos de menú:

     DO WHILE (MENUMODAL(menu,...) <> ExitMenu)
     ENDDO

     La tabla siguiente contiene una lista con las teclas activas durante la
     ejecución de MENUMODAL():

     Teclas de desplazamiento de MENUMODAL()
     ------------------------------------------------------------------------
     Tecla                       Acción
     ------------------------------------------------------------------------
     Flecha izquierda, Ctrl+S    Se desplaza al siguiente elemento de
                                 TopBarMenu de la izquierda. Si no hay más
                                 elementos a la izquierda, se selecciona
                                 el elemento situado más a la derecha.
     Flecha derecha, Ctrl+D      Se desplaza al siguiente elemento de
                                 TopBarMenu de la derecha. Si ya no hay más
                                 elementos a la derecha, se selecciona
                                 el elemento situado más a la izquierda.
     Flecha arriba, Ctrl+E       Se desplaza al elemento de menú emergente
                                 anterior al actual. Si no hay ningún
                                 elemento anterior al actual, se desplaza
                                 al elemento de menú situado más abajo.
     Flecha abajo, Ctrl+X        Se desplaza al elemento de menú
                                 emergente que sigue al actual. Si no hay
                                 ningún elemento a continuación del actual,
                                 se desplaza al elemento de menú situado
                                 más arriba.
     ------------------------------------------------------------------------

 Ejemplos

     Consulte el fichero de ejemplo Menu.prg en el directorio
     \CLIP53\SOURCE\SAMPLE. En este ejemplo se muestra cómo combinar objetos
     TopBarMenu, PopUpMenu y MenuItem para crear un menú con diferentes
     opciones. Si desea más información acerca de cómo utilizar esta
     función, consulte el capítulo "Introducción al Sistema de Menús" en la
     Guía de Programación y Utilidades.

 Ficheros   La biblioteca asociada es CLIPPER.LIB,
            el fichero fuente es SOURCE\SYS\MENUSYS.PRG

 To download this example - click here.

See Also: MenuItem PopUpMenu TopBarMenu