SET MENU ITEM ICON
SET MENU ITEM ICON ( menu ; menuItem ; iconeRef {; processo} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| menu | Integer, Text | → | Número de referência ou Número de Menu |
| menuItem | Integer | → | Número do item de menu ou -1 para o último item adicionado ao menu |
| iconeRef | Text, Integer | → | Nome ou número de imagem a ser associado com o item de menu |
| processo | Integer | → | Nú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.
- path:
- 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:
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")