Dynamic pop up menu

4D v16.3

Dynamic pop up menu


Dynamic pop up menu ( menu {; pordefecto {; CoordX ; CoordY}} ) -> Resultado

Parámetro	Tipo	Descripción
menu	MenuRef	Referencia de menú
pordefecto	Cadena	Parámetro del elemento seleccionado por defecto
CoordX	Entero largo	Coordenada X de la esquina superior izquierda
CoordY	Entero largo	Coordenada Y de la esquina superior izquierda
Resultado	Cadena	Parámetro 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 cadena personalizada asociada a la referencia del elemento de menú. Esta cadena debe haber sido definida de antemano con la ayuda del comando SET MENU ITEM PARAMETER. 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 en función de los estándares de interfaz de la plataforma actual (el botón 3D debe tener la propiedad "Con menú pop-up/relacionado" o "Con menú pop-up/Separado").

Si un elemento de menú ha sido seleccionado, el comando devuelve su cadena de caracteres personalizada asociada (tal como se ha definido utilizando el comando SET MENU ITEM PARAMETER). De lo contrario, el comando devuelve una cadena vacía.

Nota: el comando existente Pop up menu (tema Pop up menu) puede utilizarse para crear menús desplegables basados en texto.

Ver también

Get menu item parameter
Get selected menu item parameter
Pop up menu
SET MENU ITEM PARAMETER