Saltar para o conteúdo principal
Versão: Próximo

INSERT MENU ITEM

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

ParâmetroTipoDescrição
menuIntegerNúmero de menu ou menu de referência
depoisItemIntegerNúmero de item de menu
textoElemTextTexto para o item de menu a ser inserido
subMenuTextReferência do submenu associado com o item
processoIntegerNúmero de referência de processo
*OperadorSe passado: considerar metacaracteres como caracteres comuns

Esse comando não é seguro para thread e não pode ser usado em código adequado.

Descrição

O comandoINSERT 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.

Nota: a constante ak standard action title é compatível com o parâmetro itemText (4D v16 R3 e superior).

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

Ver também

APPEND MENU ITEM
SET MENU ITEM PARAMETER