INSERT MENU ITEM
INSERT MENU ITEM ( menu ; depoisItem ; textoElem {; subMenu {; processo}}{; *} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| menu | Integer | → | Número de menu ou menu de referência |
| depoisItem | Integer | → | Número de item de menu |
| textoElem | Text | → | Texto para o item de menu a ser inserido |
| subMenu | Text | → | Referência do submenu associado com o item |
| processo | Integer | → | Número de referência de processo |
| * | Operador | → | Se 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")