4D Doc Center : INSERT MENU ITEM

4D v14.3

INSERT MENU ITEM


INSERT MENU ITEM ( menu ; depoisItem ; textoElem {; subMenu {; processo}}{; *} )

Parâmetro	Tipo	Descrição
menu	Inteiro longo, MenuRef	Número de menu ou menu de referência
depoisItem	Inteiro longo	Número de item de menu
textoElem	cadeia	Texto para o item de menu a ser inserido
subMenu	MenuRef	Referência do submenu associado com o item
processo	Inteiro longo	Número de referência de processo
*	Operador	Se passado: considerar metacaracteres como caracteres comuns

Descrição

O comando INSERT MENU ITEM insere novas linhas no menu cujo número ou referência é passada em menu e as localiza depois da linha de menu cujo número se passa em depoisItem.

Se omite o parâmetro processo, INSERT MENU ITEM se aplica a barra de menus do processo atual. Do contrario, INSERT MENU ITEM é aplicada a barra de menus do processo atual cujo número de referência se passa em processo.

Nota: se passa um MenuRef em menu, o parâmetro processo é inútil e é ignorada.

Se não passa o parâmetro *, INSERT MENU ITEM lhe permite inserir um ou vários comandos de menu em uma só chamada.

INSERT MENU ITEM funciona como APPEND MENU ITEM, exceto que lhe permite inserir os comandos em qualquer parte do menu, enquanto que APPEND MENU ITEM sempre os adiciona ao final do menu.

Consulte a descrição do comando APPEND MENU ITEM para mais informação sobre a definição dos comandos de menus passados em textoElem.

O parâmetro opcional submenu permite designar um menu como linha inserida e definir um submenu hierárquico. Deve passar este parâmetro uma referência de menu (cadeia de tipo MenuRef) especificando um menu criado, por exemplo, utilizando o comando de menu Create menu. Se o comando adiciona mais de uma linha de menu, o submenu é associado com a primeira linha.

Importante: as novas linhas não tem métodos ou ações associados. Devem ser associados utilizando os comandos SET MENU ITEM PROPERTY ou SET MENU ITEM METHOD, ou os elementos também podem ser administrados desde um método de formulário utilizando o comando Menu selected.

Exemplo

O exemplo a seguir cria um menu que consiste em dois comandos os quais atribuem um método:

 MenuRef:=Criar menu

 APPEND MENU ITEM(MenuRef;"Caracteres")

 SET MENU ITEM METHOD(MenuRef;1;"CarMgmtDial")

 INSERT MENU ITEM(MenuRef;1;"Paragrafos")

 SET MENU ITEM METHOD(MenuRef;2;"ParaMgmtDial")