4D Doc Center : SET MENU ITEM ICON

4D v14.3

SET MENU ITEM ICON


SET MENU ITEM ICON ( menu ; menuItem ; iconeRef {; processo} )

Parâmetro	Tipo	Descrição
menu	Inteiro longo, MenuRef	Número de referência ou Número de Menu
menuItem	Inteiro longo	Número do item de menu ou -1 para o último item adicionado ao menu
iconeRef	Texto, Inteiro longo	Nome ou número de imagem a ser associado com o item de menu
processo	Inteiro longo	Número de processo

Descrição

O comando SET MENU ITEM ICON permite modificar o ícone associado à linha de menu designada pelos parâmetros menu e menuItem.
Pode passar -1 em menuItem para especificar o último elemento adicionado a menu.

Em menu, pode passar uma referência de menu (MenuRef) ou um número de menu. Se passas uma referência de menu, o comando aplicará a todas as instâncias do menu em todos os processos. Neste caso, se passar o parâmetro processo é ignorado. Se passa um número de menu, o comando considerará o menu correspondente na barra de menus principal do processo atual. Se quer designar outro processo, passe seu número no parâmetro opcional processo.

Em iconeRef, pode passar o nome ou o número da imagem da biblioteca a utilizar como ícone. Pode utilizar uma imagem da biblioteca ou uma referência de imagem.
• Imagem de biblioteca: pode passar o nome ou o número de imagem. Pelo geral é preferível utilizar seu número ao invés do nome já que os números de imagem são identificadores únicos, que não é o caso com dos nomes.
• Referência de imagem: a imagem deve estar localizada na pasta Resources do banco e deve utilizar uma sintaxe "arquivo:{nomerota}NomeArquivo" em iconeRef. Para maior informação sobre a pasta Resources, consulte a seção Resources.

Exemplo

Uso de uma imagem localizada na Pasta Resources do banco de dados:

SET MENU ITEM ICON($MenuRef;2;"File:ES.lproj/spot.png")