Get menu bar reference
Get menu bar reference {( processo )} : Text
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| processo | Integer | → | Número de referência do processo |
| Resultado | Text | ← | Referência de menu |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
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.