SET MENU ITEM ICON
SET MENU ITEM ICON ( menu ; lineamenu ; refIcon {; proceso} )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| menu | Integer, Text | → | Referencia de menú o número de menú |
| lineamenu | Integer | → | Número de línea de menú o -1 para el último elemento añadido |
| refIcon | Text, Integer | → | Nombre o número de la librería de imágenes a asociar a la línea de menú |
| proceso | Integer | → | Número de proceso |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
Descripción
El comando SET MENU ITEM ICON permite modificar el icono asociado a la línea de menú designada por los parámetros menu y lineaMenu.
Puede pasar -1 en lineaMenu para especificar el último elemento añadido a menu.
En menu, puede pasar una referencia de menú (MenuRef) o un número de menú. Si pasa una referencia de menú, el comando aplicará a todas las instancias del menú en todos los procesos. En este caso, si se pasa el parámetro proceso se ignora. Si pasa un número de menú, el comando tendrá en cuenta el menú correspondiente en la barra de menús principal del proceso actual. Si quiere designar otro proceso, pase su número en el parámetro opcional proceso.
En refIcon, puede pasar el nombre o el número de la imagen de la librería a utilizar como icono. Puede utilizar una imagen de la librería (bases binarias únicamente) o una referencia a un archivo de imagen.
- Referencia de archivo de imagen. Se pueden utilizar dos tipos:
- path:
(recomendado), por ejemplo "path:/RESOURCES/icon.png". Para mayor información, consulte el párrafo Rutas a los Filesystem. - file:
(obsoleto), por ejemplo "file:icon.png". La imagen debe estar ubicada en la carpeta Resources de la base.
- path:
- Imagen de librería (bases binarias únicamente): puede pasar el nombre o el número de imagen. Por lo general es preferible utilizar su número en lugar del nombre ya que los números de imagen son identificadores únicos, que no es el caso con de los nombres.
Nota: se recomienda el uso de una ruta de archivo de imagen ya que la Librería de imágenes está en desuso y no es compatible con las bases de datos de proyectos 4D. Además, el tipo file:
Ejemplo
Uso de una imagen ubicada en la carpeta Resources de la base:
SET MENU ITEM ICON($MenuRef;2;"Path:/RESOURCES/english.lproj/spot.png")