INSERT MENU ITEM
INSERT MENU ITEM ( menu ; depuesDe ; textoElem {; subMenu {; proceso}}{; *} )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| menu | Integer | → | Número de menú o referencia de menú |
| depuesDe | Integer | → | Número de la línea de menú |
| textoElem | Text | → | Texto para la línea de menú a insertar |
| subMenu | Text | → | Referencia del submenú asociado con la línea |
| proceso | Integer | → | Número de referencia del proceso |
| * | Operador | → | Si se pasa: considerar metacaracteres como caracteres estándar |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
Descripción
El comando INSERT MENU ITEM inserta nuevas líneas en el menú cuyo número o referencia se pasa en menu y las ubica después de la línea de menú cuyo número se pasa en despuesItem.
Si omite el parámetro proceso, INSERT MENU ITEM se aplica a la barra de menús del proceso actual. De lo contrario, INSERT MENU ITEM se aplica a la barra de menús del proceso actual cuyo número de referencia se pasa en proceso.
Nota: si pasa un MenuRef en menu, el parámetro proceso es inútil y se ignorará.
Si no pasa el parámetro * , INSERT MENU ITEM le permite insertar uno o varios comandos de menú en una sola llamada.
INSERT MENU ITEM funciona como APPEND MENU ITEM, excepto que le permite insertar los comandos en cualquier parte del menú, mientras que APPEND MENU ITEM siempre los añade al final del menú.
Consulte la descripción del comando APPEND MENU ITEM para más información sobre la definición de los comandos de menús pasados en itemtext.
Nota: la constante ak standard action title es soportada en el parámetro itemText (4D v16 R3 y superior).
El parámetro opcional submenu permite designar un menú como línea insertada y definir un submenú jerárquico. De pasar en este parámetro una referencia de menú (cadena de tipo MenuRef) especificando un menú creado, por ejemplo, utilizando el comando de menú Create menu. Si el comando añade más de una línea de menú, el submenú se asocia con la primera línea.
Importante: las nuevas líneas no tienen métodos o acciones asociados. Deben asociarse utilizando los comandos SET MENU ITEM PROPERTY o SET MENU ITEM METHOD, o los elementos también pueden ser administrados desde un método de formulario utilizando el comando Menu selected.
Ejemplo
El siguiente ejemplo crea un menú que consiste en dos comandos los cuales asignan un método:
MenuRef:=Crear menu
APPEND MENU ITEM(MenuRef;"Caracteres")
SET MENU ITEM METHOD(MenuRef;1;"CarMgmtDial")
INSERT MENU ITEM(MenuRef;1;"Parrafos")
SET MENU ITEM METHOD(MenuRef;2;"ParaMgmtDial")