Dynamic pop up menu

4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente

versión 11


Dynamic pop up menu (menu{; pordefecto{; CoordX{; CoordY}}}) Cadena

ParámetroTipoDescripción
menuMenuRefReferencia de menú
pordefectoCadenaParámetro del elemento seleccionado por defecto
CoordXNuméricoCoordenada X de la esquina superior izquierda
CoordYNuméricoCoordenada Y de la esquina superior izquierda
ResultadoCadenaPará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 de acuerdo a los estándares de interfaz de la plataforma actual.

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 PARAMATER). 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 parameter, Get selected menu item parameter, Pop up menu, SET MENU ITEM PARAMETER.


4D - Documentation   Français   English   German   Español   English   4D v11 SQL, Comandos por temas   4D v11 SQL, Lista alfabética de comandos   4D v11 SQL, Constantes por temas   Regresar   Anterior   Siguiente