4D v14.3

INSERT MENU ITEM

Página Inicial

 
4D v14.3
INSERT MENU ITEM

INSERT MENU ITEM 


 

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

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

 
PROPRIEDADES 

Produto: 4D
Tema: Menus
Número 412

Este comando não pode ser utilizado com 4D Server

 
HISTÓRIA 

Modificado: 4D v11 SQL Release 4

 
VER TAMBÉM 

APPEND MENU ITEM
SET MENU ITEM PARAMETER

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v12.4)
Manual de linguagem 4D ( 4D v11 SQL Release 6)
Manual de linguagem 4D ( 4D v14 R3)
Manual de linguagem 4D ( 4D v14 R2)
Manual de linguagem 4D ( 4D v13.5)
Manual de linguagem 4D ( 4D v14.3)
Manual de linguagem 4D ( 4D v14 R4)