versión 11
Dynamic pop up menu (menu{; pordefecto{; CoordX{; CoordY}}}) RefLinea
Parámetro | Tipo | Descripción | |
menu | MenuRef | Referencia de menú | |
pordefecto | RefLinea | Referencia del elemento seleccionado por defecto | |
CoordX | Numérico | Coordenada X de la esquina superior izquierda | |
CoordY | Numérico | Coordenada Y de la esquina superior izquierda | |
Resultado | RefLinea | Referencia del elemento de menú seleccionado |
Descripción
El comando Dynamic pop up menu hace aparecer un menú desplegable jerárquico en la ubicación actual del ratón o en la ubicación definida por los parámetros opcionales Coordx y Coordy.
El menú jerárquico utilizado debe haber sido creado con el comando Create menu. La referencia devuelta por Create menu debe pasarse en el parámetro menu.
Conforme con las reglas estándar de la interfaz, este comando generalmente debe ser llamado en respuesta a un clic derecho, o cuando el botón se mantiene presionado por un cierto periodo de tiempo (menú contextual por ejemplo).
El parámetro opcional pordefecto puede utilizarse para definir un elemento del menú desplegable seleccionado por defecto cuando aparece el menú. En este parámetro, pase una referencia del elemento de menú. Esta referencia debe haber sido definida de antemano con la ayuda del comando SET MENU ITEM REFERENCE. Si no pasa este parámetro, el primer elemento del menú será seleccionado por defecto.
Los parámetros opcionales CoordX y CoordY pueden ser utilizados para especificar la ubicación del menú desplegable a mostrar. En los parámetros CoordX y CoordY, pase las coordenadas horizontal y vertical respectivamente, de la esquina superior izquierda del menú. Estas coordenadas deben ser expresadas en píxeles en el sistema de coordenadas local del formulario actual. Estos dos parámetros deben pasarse juntos; si se pasa sólo uno de ellos, el otro será ignorado.
Si quiere mostrar un menú desplegable asociado a un botón 3D, no pase los parámetros opcionales CoordX y CoordY. En este caso, 4D calcula automáticamente la ubicación del menú respecto al botón de acuerdo a los estándares de interfaz de la plataforma actual.
Si un elemento de menú ha sido seleccionado, el comando devuelve su referencia (tal como se ha definido utilizando el comando SET MENU ITEM REFERENCE). De lo contrario, el comando devuelve una cadena vacía.
Nota: El comando Pop up menu (tema "Interfaz del usuario") puede utilizarse para crear menús desplegables basados en texto.
Ver también
Get menu item reference, Get selected menu item reference, Pop up menu, SET MENU ITEM REFERENCE.