Saltar para o conteúdo principal
Versão: Próximo

SET MENU ITEM ICON

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

ParâmetroTipoDescrição
menuInteger, TextNúmero de referência ou Número de Menu
menuItemIntegerNúmero do item de menu ou -1 para o último item adicionado ao menu
iconeRefText, IntegerNome ou número de imagem a ser associado com o item de menu
processoIntegerNúmero de processo

Esse comando não é seguro para thread e não pode ser usado em código adequado.

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: (recomendado), por exemplo "path:/RESOURCES/icon.png". Para saber mais, veja o parágrafo Nomes de rotas de Filesystem.
    • file: (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: está obsoleto, usar o padrão path: é 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