Get menu bar reference

4D v20 R7


Get menu bar reference {( processo )} -> Resultado

Parâmetro	Tipo	Descrição
processo	Inteiro longo	Número de referência do processo
Resultado	MenuRef	Referência de menu

Descrição

O comando Get menu bar reference devolve a identificação única da barra de menus atual ou da barra de menus de um processo específico.

Se a barra de menus foi criada pelo comando Create menu, esta identificação corresponde a referência única do menu criado. Do contrário, o comando devolve uma identificação interna específica. Em todos os casos, esta identificação, MenuRef pode ser utilizada para referenciar a barra de menus para todos os outros comandos do tema.

(*) Este ID específico é temporário e deixa de ser válido logo que se chame a outra barra de menu com SET MENU BAR. Se quiser conservar a referência de um menu criado no editor de menu, deve copiá-lo na memória utilizando Create menu. Por exemplo:

 $vEditorRef:=Get menu bar reference(Frontmost process) //menu criado no editor de barras de menu

 $vMenuRef:=Create menu($vEditorRef) //copia o menu

 SET MENU BAR(2) //instala outra barra de menú

 ... // executar código

 SET MENU BAR($vMenuRef) //regressa à barra de menu inicial

O parâmetro processo pode ser utilizado para designar o processo do que quer obter a identificação da barra de menus atual. Se omite este parâmetro, o comando devolve a identificação da barra de menus do processo atual..i

Exemplo

Consulte o exemplo do comando GET MENU ITEMS.

Ver também

SET MENU BAR