4D Doc Center : Create menu

4D v14.3

Create menu


Create menu {( menu )} -> Resultado

Parâmetro	Tipo	Descrição
menu	MenuRef, Inteiro longo, cadeia	Referência de menu ou Número ou Nome da barra de menu
Resultado	MenuRef	Referência de menu

Descrição

O comando Create menu permite criar um novo menu em memória. Este menu só existirá em memória e não será adicionado ao editor de menu no ambiente Desenho. Toda modificação realizada a este menu durante a sessão repercutirá imediatamente em todas as instâncias deste menu e em todos os processos do banco.

O comando devolve um identificador único de tipo MenuRef para o novo menu.

Se no passa o parâmetro opcional menu, o menu será criado vazio. Deve construí-lo e administrá-lo utilizando os comandos APPEND MENU ITEM, SET MENU ITEM, etc.
Se passa o parâmetro menu, o menu criado será uma cópia exata do menu fonte designado por este parâmetro. Todas as propriedades do menu fonte, incluindo os submenus associados, serão aplicadas ao novo menu. Note que uma nova referência MenuRef é criado para o menu fonte e para cada submenu associado existente.

No parâmetro menu, pode passar uma referência de menu válida, ou o número ou nome de uma barra de menus definida no ambiente Desenho. Neste último caso, o novo menu estará constituído pelos menus e submenus da barra de menus fonte.

Um menu criado por este comando pode ser utilizado como barra de menus utilizando o comando SET MENU BAR.

Quando já não necessite o menu criado por Create menu, lembre chamar o comando RELEASE MENU para liberar a memória que está sendo utilizada.

Exemplo

Consulte o exemplo do comando SET MENU BAR.