INSERT MENU ITEM

4D v16.3

INSERT MENU ITEM


INSERT MENU ITEM ( menu ; depuesDe ; textoElem {; subMenu {; proceso}}{; *} )

Parámetro	Tipo	Descripción
menu	Entero largo, MenuRef	Número de menú o referencia de menú
depuesDe	Entero largo	Número de la línea de menú
textoElem	Cadena	Texto para la línea de menú a insertar
subMenu	MenuRef	Referencia del submenú asociado con la línea
proceso	Entero largo	Número de referencia del proceso
*	Operador	Si se pasa: considerar metacaracteres como caracteres estándar

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.

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")

Ver también

APPEND MENU ITEM
SET MENU ITEM PARAMETER