Menú emergente

Añade un menú emergente a otras vistas. Puede anclarlo a un elemento de menú cuando se pulsa el elemento de menú o cuando la vista pierde el foco.

Propiedades de configuración

En Configuración, establezca o modifique las propiedades de aspecto y comportamiento de la vista.

Tamaño de pantalla
Una propiedad de configuración que tenga el icono Tamaños de pantalla El icono Tamaños de pantalla junto al nombre de propiedad puede tener distintos valores para cada tamaño de pantalla. Si no define un valor, el tamaño de la pantalla hereda el valor del siguiente tamaño de pantalla más grande como valor predeterminado.
Definiciones de temas
Las definiciones de temas especifican los colores y los estilos de una vista y determinan su aspecto. Puede obtener una vista previa del aspecto de las vistas en el editor de temas. Consulte Temas.
En la tabla siguiente se muestran las propiedades de configuración del aspecto para la vista Menú emergente:
Tabla 1. Propiedades de configuración de aspecto para Menú emergente
Propiedad de configuración del aspecto Descripción Tipo de datos
Mostrar etiqueta Proporciona la etiqueta de la vista emergente. Cuando se selecciona Mostrar etiqueta, el menú emergente muestra la etiqueta de la vista que contiene. De forma predeterminada, la etiqueta de la vista contenida está oculta. Boolean
Colocación de etiqueta El icono Tamaños de pantalla Especifica la posición de la etiqueta.
  • Superior
  • Izquierda
 String
Ancho de etiqueta Icono de pantalla grande El ancho de la etiqueta. Puede especificar el ancho en px (píxeles), % (porcentaje) o en unidades. Por ejemplo, 50px, 20% o 0,4em. Si no se especifica ningún tipo de unidad, se asume px. String
Alineación horizontal El icono Tamaños de pantalla Especifica la posición horizontal del menú emergente en relación a la vista contenida.
  • Izquierda
  • Derecha
 String
Alineación vertical El icono Tamaños de pantalla Especifica la posición vertical del menú emergente en relación a la vista contenida.
  • Superior
  • Final
 String
Sombra Añade una sombra al marco del menú emergente. Boolean
Ancho El icono Tamaños de pantalla Especifica la anchura del sobre que envuelve la vista. String
En la tabla siguiente se enumeran las propiedades de configuración del comportamiento de la vista Menú emergente:
Tabla 2. Propiedades de configuración del comportamiento para Menú emergente
Propiedad de configuración del comportamiento Descripción Tipo de datos
Anclar menú Impide que el menú emergente se cierre automáticamente cuando se pulsa en un elemento de menú o cuando la vista pierde el foco. Boolean
Elementos de menú Especifica los elementos del menú:
Mandato (String)
El mandato que se ejecutará al seleccionar este elemento de menú.
Tipo de elemento (String)
Especifica el tipo de elemento de menú.
  • label
  • separador
  • Cabecera de sección
Icono (String)
El icono que desea añadir al elemento de menú especificado. Déjelo en blanco si no desea añadir ningún icono.
Texto de elemento (String)
El texto a visualizar para el elemento de menú especificado (no aplicable a separadores).
Forma de identificador (String)
La forma de identificador que desea utilizar.
  • Ninguno
  • Cuadrado
  • Redondeado
Color de identificador (String)
El estilo de color del identificador. Los colores corresponden a variables en el tema especificado.
Texto de identificador (String)
El texto que se añade al identificador.
 MenuItemSpec[]

Ejemplo

En este ejemplo, se pone una vista Grupo de entrada dentro de una vista Menú emergente. Establezca las propiedades de la vista Grupo de entrada como se indica a continuación:
  1. En Aspecto, establezca Colocación de etiqueta en Top, Estilo de color en Warning, Ubicación de botón en Left, Tipo de botón en Menuy Información de botón en Click to see Menu Items.
  2. En Sucesos, en Al pulsar botón, escriba la siguiente línea de código:
    ${Popup_Menu1}.setMenuVisible(!${Popup_Menu1}.isMenuVisible{})
donde 'Popup_Menu1' es el ID de control de la vista Menú emergente.
Establezca las siguientes propiedades de configuración para la vista Menú emergente:
  1. En Aspecto, establezca Colocación de etiqueta en Top, Alineación horizontal en Left, Alineación vertical en Bottom, seleccione Sombray establezca Anchura en 25%.
  2. En Comportamiento, seleccione Menú Pin.
  3. En Elementos de menú, pulse en el signo más (+) para añadir tres filas en la tabla, cada una con los siguientes valores:
    • Fila 1: Para Mandato, especifique 1, establezca Tipo de elemento en Label, para Item text, especifique Item 1, establezca Forma de identificador en Rounded, Color de identificador en Primaryy para Texto de identificador especifique 1.
    • Fila 2: Para Mandato, especifique 2, establezca Tipo de elemento en Label, para Item text, especifique Item 2, establezca Forma de identificador en Rounded, Color de identificador en Infoy para Texto de identificador especifique 2.
    • Fila 3: Para Mandato, especifique 3, establezca Tipo de elemento en Label, para Item text, especifique Item 3, establezca Forma de identificador en Rounded, Color de identificador en Successy para Texto de identificador especifique 3.
En tiempo de ejecución, el resultado es un menú emergente que se parece a la imagen siguiente.

Sucesos

Establezca o modifique los manejadores de sucesos para la vista en las propiedades de Sucesos. Puede establecer que los sucesos se activen mediante programación o cuando un usuario interactúe con la vista. Para obtener información sobre cómo definir y codificar sucesos, consulte Sucesos definidos por el usuario. La vista de menú emergente tiene los siguientes tipos de manejadores de sucesos:
  • : Activado cuando se carga la página. Por ejemplo:
    me.setMenuVisible(true)
  • : Activado cuando se pulsa un elemento. Aplicable únicamente en etiquetas, no aplicable en cabeceras de sección. Por ejemplo:
    ${Text1}.setLabelPosition(command) //sets the label position of the Text1 control to the value of command
//the value of command is set in the menu item command property

Métodos

Para obtener información detallada sobre los métodos disponibles para el menú emergente, consulte API JavaScript de menú emergente.

Recursos adicionales

Para obtener información sobre cómo crear un coach o una página, consulte Creación de coaches.
Para obtener información sobre las propiedades estándar (General, Configuración, Posicionamiento, Visibilidady Atributos HTML), consulte Ver propiedades.