SET MENU ITEM PROPERTY
SET MENU ITEM PROPERTY ( menu ; lineaMenu ; propiedad ; valor {; proceso} )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| menu | Integer, Text | → | Referencia del menú o número de menú |
| lineaMenu | Integer | → | Número de línea del menú o -1 para la última línea añadida al menú |
| propiedad | Text | → | Tipo de propiedad |
| valor | Text, Number, Boolean | → | Valor de la propiedad |
| proceso | Integer | → | Número del proceso |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
Descripción
El comando SET MENU ITEM PROPERTY permite fijar el valor de la propiedad para la línea de menú designada por los parámetros menu y lineaMenu.
Puede pasar -1 en lineaMenu para especificar la última línea añadida 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 se 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 se aplicará al 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 el parámetro propiedad, pase la propiedad cuyo valor quiere modificar y pase el nuevo valore en valor. Para el parámetro propiedad, puede utilizar una propiedad estándar (una de las constantes del tema “Propiedades de ítem de menú”) o una propiedad personalizada:
- Propiedad estándar: La mayoría de las propiedades estándar están disponibles a través de constantes en el tema "Propiedades de ítem de menú".
| Constante | Tipo | Valor | Comentario |
| -------------------------- | ------ | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Access privileges | Cadena | 4D_access_group | Activar la opción "Iniciar un nuevo proceso"
0 = No, 1 = Sí
|
| Associated standard action | Cadena | 4D_standard_action | Asociar una acción estándar a la línea de menú
Ver las constantes del tema "Acción estándar" |
| n/a | Cadena | 4D_execute_without_validating | Activar la opción Ejecutar sin validar (para los elementos de menú asociados a acciones estándar).
True=activar, False (por defecto)=desactivar |
| Start a new process | Cadena | 4D_start_new_process | Asignar un grupo de acceso al comando
0 = Sin restricción
>0 = Número de grupo
|
En el caso de la propiedad Associated standard action, puede pasar en el parámetro valor un nombre de acción estándar. Para obtener una lista completa de las acciones disponibles, consulte la sección Acciones estándar del manual de Diseño. Las acciones más comunes también están disponibles como constantes en el tema Acción estándar.
Nota de compatibilidad: en versiones anteriores, las constantes del tema Valores para acción estándar asociada se utilizaron en el parámetro valor (Entero largo). A partir de 4D v16 R3, son obsoletas, pero aún son soportadas por compatibilidad.
Nota: si la línea de menú corresponde al título de un submenú jerárquico, la acción estándar no se llamará cuando se seleccione la línea de menú.
- Propiedad personalizada: en propiedad, puede pasar todo texto personalizado y asociar un valor de tipo texto, numérico o booleano. Este valor será almacenado con el elemento y puede ser recuperado utilizando el comando GET MENU ITEM PROPERTY. En el parámetro propiedad puede utilizar toda cadena personalizada, simplemente asegúrese de utilizar un título utilizado por 4D (por convención, las propiedades definidas por 4D comienzan por “4D_”).