Create menu
Create menu {( menu )} : Text
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| menu | Text, Integer, Text | → | Referencia del menú o Número o nombre de barra de menús |
| Resultado | Text | ← | Referencia del menú |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
Descripción
El comando Create menu permite crear un nuevo menú en memoria. Este menú sólo existirá en memoria y no se añadirá al editor de menú en el entorno Diseño. Toda modificación efectuada a este menú durante la sesión repercutirá inmediatamente en todas las instancias de este menú y en todos los procesos de la base.
El comando devuelve un identificador único de tipo MenuRef para el nuevo menú.
- Si no pasa el parámetro opcional menu, el menú será creado vacío. Debe construirlo y administrarlo utilizando los comandos RELEASE MENU, SET MENU ITEM, etc.
- Si pasa el parámetro menu, el menú creado será una copia exacta del menú fuente designado por este parámetro. Todas las propiedades del menú fuente, incluyendo los submenús asociados, serán aplicadas al nuevo menú. Note que una nueva referencia MenuRef se crea para el menú fuente y para cada submenú asociado existente.
En el parámetro menu, puede pasar una referencia de menú válida, o el número o nombre de una barra de menús definida en el entorno Diseño. En este último caso, el nuevo menú estará constituido por los menús y submenús de la barra de menús fuente.
Nota: si pasa un valor invalido en menu, se crea un menú vacío.
Un menú creado por este comando puede ser utilizado como barra de menús utilizando el comando SET MENU BAR.
Cuando ya no necesite el menú creado por Create menu, recuerde llamar al comando RELEASE MENU para liberar la memoria que está siendo utilizada.
Ejemplo
Consulte el ejemplo del comando SET MENU BAR.