SET MENU ITEM ICON

4D v20 R7

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.

Referência de arquivo de Imagem: dois padrões são compatíveis:
- path:<filesystem> (recomendado), por exemplo "path:/RESOURCES/icon.png". Para saber mais, veja o parágrafo Nomes de rotas de Filesystem.
- file:<relativePathname> (obsoleto), Pòr exemplo "file:icon.png". A imagem deve estar localizada na pasta Recursos do banco de dados.
Biblioteca de imagem (apenas banco de dados binário): Pode passar ou o nome ou o número da imagem. É geralmente preferível usar o número já que números são identidades únicas, o que não é o caso com os nomes.

Nota: Uso de uma rota de arquivo de imagem é recomendado já que a Biblioteca de Imagem está obsoleta e não é compatível com projetos de banco de dados 4D. Além disso, o padrão file:<relativePathname> está obsoleto, usar o padrão path:<filesystem> é recomendado.

Exemplo

Uso de uma imagem localizada na pasta Recursos do banco de dados:

SET MENU ITEM ICON($MenuRef;2;"Path:/RESOURCES/english.lproj/spot.png")

Ver também

GET MENU ITEM ICON