SET MENU BAR
SET MENU BAR ( barra {; proceso}{; *} )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| barra | Integer, Text, Text | → | Número o nombre de la barra de menús o Referencia de menú |
| proceso | Integer | → | Número de referencia del proceso |
| * | Operador | → | Guardar el estado de la barra de menús |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
Descripción
MENU BAR reemplaza la barra de menús actual con la especificada por barra en el proceso actual únicamente. En el parámetro barra, puede pasar el número o nombre de la nueva barra. Igualmente puede pasar una referencia única de menú (tipo MenuRef, cadena de 16 caracteres). Cuando trabaja con referencias, los menús pueden ser utilizados como barras de menú y viceversa (ver la sección Gestión de menús).
Nota: el nombre de una barra de menús puede contener hasta 31 caracteres y debe ser único.
Si pasa el parámetro opcional proceso cambia la barra de menús del proceso especificado por barra.
Nota: si pasa un parámetro MenuRef en barra, el parámetro proceso es inútil y se ignorará.
El parámetro opcional * le permite conservar el estado de la barra de menús. Si este parámetro se omite, MENU BAR reinicializa la barra de menús cuando el comando se ejecuta.
Por ejemplo, imagine que SET MENU BAR(1) se ejecuta. Luego, varios comandos de menú se desactivan utilizando el comando DISABLE MENU ITEM.
Si SET MENU BAR(1) se ejecuta una segunda vez, desde el mismo proceso o desde un proceso diferente, todos los comandos de menú regresarán a su estado de activación inicial.
Si SET MENU BAR(1;*) se ejecuta, la barra de menús conservará su estado anterior, y los comandos de menú que estaban inactivos permanecerán inactivos.
Nota: si pasa un parámetro MenuRef en barra, el parámetro * es inútil y se ignorará.
Cuando un usuario entra al entorno Aplicación, se muestra la primera barra de menús (Barra #1). Puede cambiar esta barra de menús por defecto abriendo la base y especificando la barra de menús deseada en el Método de base On Startup o en el método de inicio asociado a un usuario individual.
Ejemplo 1
El siguiente ejemplo cambia la barra de menús actual por la barra de menús #3 y restablece el estado de los comandos de menú a sus estados originales:
SET MENU BAR(3)
Ejemplo 2
El siguiente ejemplo cambia la barra de menús actual por la barra de menús llamada “BarraForm1” y guarda el estado de los comandos de menús. Comandos de menús que fueron desactivados previamente aparecerán inactivos.
SET MENU BAR("BarraForm1";*)
Ejemplo 3
El siguiente ejemplo reemplaza la barra de menús actual por la barra de menús #3 mientras los registros son modificados. Una vez los registros sean modificados, la barra de menús #2 se restaura. El estado de los comandos de menú se conserva:
SET MENU BAR(3)
ALL RECORDS([Clientes])
MODIFY SELECTION([Clientes])
SET MENU BAR(2;*)
Ejemplo 4
En este ejemplo, crearemos por programación, una barra de menús incluyendo los siguientes menús Archivo y Edición:
//Metodo de creación menú Archivo
var 16;MenuArchivo : Text // MenuArchivo contendrá la referencia de menu Archivo
MenuArchivo:=Create menu
INSERT MENU ITEM(MenuArchivo;-1;"Mi base de datos "+Get indexed string(131;29))
SET MENU ITEM MARK(MenuArchivo;1;Char(18))
INSERT MENU ITEM(MenuArchivo;-1;"(-")
INSERT MENU ITEM(MenuArchivo;-1;"Salir del modo Test Application mode/Y")
SET MENU ITEM PROPERTY(MenuArchivo;3;Associated standard action;ak return to design mode)
INSERT MENU ITEM(MenuArchivo;-1;"(-")
INSERT MENU ITEM(MenuArchivo;-1;"Preferencias")
SET MENU ITEM PROPERTY(MenuArchivo;5;Associated standard action;ak database settings) //Preferencias
INSERT MENU ITEM(MenuArchivo;-1;"(-")
INSERT MENU ITEM(MenuArchivo;-1;Get indexed string(131;30))
SET MENU ITEM PROPERTY(MenuArchivo;7;Associated standard action;ak quit) //Salir
SET MENU ITEM SHORTCUT(MenuArchivo;7;Character code("Q"))
//Método de creación del menú Buscar y reemplazar
var MenuBuscaryReemplazar : Text //MenuBuscaryReemplazar contendrá la referencia del menú Buscar y reemplazar
MenuBuscaryReemplazar:=Create menu
APPEND MENU ITEM(MenuBuscaryReemplazar;"Buscar;Buscar Siguiente;Buscar anterior;(-;Remplazar;Remplazar siguientes;Reemplazar anterior")
SET MENU ITEM SHORTCUT(MenuBuscaryReemplazar;1;Character code("F"))
SET MENU ITEM SHORTCUT(MenuBuscaryReemplazar;5;Character code("R"))
SET MENU ITEM METHOD(MenuBuscaryReemplazar;1;"MiMetodoBuscar")
//Método de creación del menú Edición
var MenuEdicion : Text //EditMenu contendrá la referencia del menú Edición
MenuEdicion:=Create menu
APPEND MENU ITEM(MenuEdicion;"Cortar;Copiar;Pegar")
SET MENU ITEM SHORTCUT(MenuEdicion;1;Character code("X"))
SET MENU ITEM PROPERTY(MenuEdicion;1;Associated standard action;ak cut)
SET MENU ITEM SHORTCUT(MenuEdicion;2;Character code("C"))
SET MENU ITEM PROPERTY(MenuEdicion;2;Associated standard action;ak copy)
SET MENU ITEM SHORTCUT(MenuEdicion;3;Character code("V"))
SET MENU ITEM PROPERTY(MenuEdicion;3;Associated standard action;ak paste)
INSERT MENU ITEM(MenuEdicion;-1;"(-")
INSERT MENU ITEM(MenuEdicion;-1;"Buscar y reemplazar";MenuBuscaryReemplazar) // línea que tendrá el submenú
main_Bar:=Create menu // Cree la barra de menús con los otros menús
INSERT MENU ITEM(main_Bar;-1;Get indexed string(79;1);MenuArchivo)
APPEND MENU ITEM(main_Bar;"Edición";MenuEdición)
SET MENU BAR(main_Bar)
Ver también
Gestión de menús