4D Doc Center : RELEASE MENU

4D v14.3

RELEASE MENU


RELEASE MENU ( menu )

Parâmetro	Tipo	Descrição
menu	MenuRef	Referência de menu

Descrição

O comando RELEASE MENU apaga da memória o menu cuja referência se passa em menu.. A regra é a seguinte: a cada Create menu deve corresponder um RELEASE MENU.

O comando elimina todas as instâncias de menu em todas as barras de menu e todos os processos. Se o menu pertence a uma barra de menu em uso, continuará funcionando mas não poderá ser modificada. Só será apagado realmente da memória quando a última barra de menus na que apareça não esteja mais em uso.

Este comando pode ser utilizado com menus usados como barras de menus.

Os submenus utilizados por menu não são apagados se foram criados utilizando o comando Create menu. Neste caso, devem ser eliminados individualmente (ver a regra mencionada anteriormente). Entretanto, se os submenus vêm da duplicação de um menu existente, não chame RELEASE MENU com suas instâncias porque 4D as apagará automaticamente.

Exemplo

Este exemplo mostra as diferentes formas de utilizar este comando:

 newMenu:=Create menu

 APPEND MENU ITEM(newMenu;"Test1")

 subMenu:=Create menu

 APPEND MENU ITEM(subMenu;"SubTest1")

 APPEND MENU ITEM(subMenu;"SubTest2") // Criação de elementos no submenu

 

 APPEND MENU ITEM(newMenu;"Test2";subMenu) // Associar os submenus ao menu

 

  //Neste momento, o submenu se associa ao menu e se não o necessitamos mais adiante, este é o momento adequado para apagá-lo.

  //Ao apagá-lo não se apaga imediatamente se subMenu já que ainda está sendo utilizado por newMenu. subMenu só se apaga quando é apagada newMenu.

  //Apagar o submenu neste momento lhe permite poupar memória

 RELEASE MENU(subMenu)

 

 $result1:=Dynamic pop up menu(newMenu) //Uso de menu

 copyMenu:=Create menu(newMenu) // Criação de um menu por cópia de newMenu (e duplicação de subMenu)

 RELEASE MENU(newMenu) // Já não necessitamos a newMenu.

 

 $result2:=Dynamic pop up menu(copyMenu)

 RELEASE MENU(copyMenu)

  //Não deve se preocupar por apagar os submenus de copyMenu já que não se criou diretamente utilizando Create menu

  //A regra a seguir é: cada Create menu deve ter um RELEASE MENU correspondente