BiblioJAM‎ > ‎

JAMComboBox

Simula un combobox. Es un Grupo de Sprites. Utiliza JAMButton.

VERSION 2 (29/06/2011)

Para poder utilizar este control, debes:
  • Copiar la carpeta BiblioJAM dentro del directorio de tu juego o actividad.
  • Luego importar el paquete mediante:       import BiblioJAM
  • Luego, para crear un JAMComboBox, debes importar su clase mediante:         from BiblioJAM.JAMComboBox import JAMComboBox

Para construir un JAMComboBox debes hacer:
         JAMComboBox ()

Puedes cambiar la posición en pantalla mediante:
         JAMComboBox.set_posicion(punto=(x,y))

Para agregar un item a
JAMComboBox debes hacer:
        
JAMComboBox.add_item(item, callback)
        item debe ser una cadena de texto para el caption del item.
        callback debe ser una función que se ejecutará la hacer click sobre el item, esta función debe tener un parámetro para recibir el botón que la llama
.

Para cambiar el callback de un item debes hacer:
        JAMComboBox.connect_item(item, callback, sound)
        item debe ser la cadena de texto en el caption del item.
        callback la función que conectarás, que debe tener un parámetro para recibir el item que la llama. (Ver: JAMButton)
        sound debe ser un sonido para select sobre el item.
(Ver: JAMButton)

Para eliminar un item de JAMComboBox debes hacer:
        
JAMComboBox.remove_item(item)
        item debe ser una cadena de texto que representa el caption en el item.

Puedes eliminar todos los items de JAMComboBox mediante:
         JAMComboBox.clear_items()

Puedes cambiar cualquier atributo de color mediante:
        JAMComboBox .set_colores(colorbas="Color de relleno en: (r,g,v,a)", colorbor="Color de borde en: (r,g,v,a)", colorcara="Color de la cara en: (r,g,v,a)")
         colorbas= color del cuerpo del botón.
         colorbor= color del borde la base del botón.
         colorcara= color de la cara del botón.

Puedes cambiar cualquier atributo de texto mediante:
         JAMComboBox.set_text(tipo="tipo de letra", tamanio="tamaño de letra", color=(r,g,v,a))
         Nota:
Tanto el tipo de letra como el tamaño determinarán siempre el tamaño mínimo del item.

Puedes cargar un tipo de letra desde un archivo mediante:
         JAMComboBox.set_font_from_file(fuente, tamanio= None)
         fuente debe ser la dirección al archivo de fuentes
. (Ver: JAMLabel)

Puedes cambiar cualquier atributo de tamaño mediante:
         JAMComboBox.set_tamanios(tamanio=(ancho,alto))
         tamanio= tamaño del botón. (pero nunca será menor que el tamaño de la etiqueta que contiene, se ajustará automáticamente).

Puedes establecer la alineación del texto en JAMComboBox mediante:
         JAMComboBox.set_alineacion_text(alineacion) # puede ser: "centro", "izquierda", "derecha"

Puedes obtener el texto "caption" actual en JAMComboBox en tiempo de ejecución mediante:
         JAMComboBox.get_caption()

Para obtener el tamaño actual de JAMComboBox debes hacer:
         JAMComboBox.get_tamanio()

Para obtener la posición actual de JAMComboBox debes hacer:
         JAMComboBox.get_posicion()

Para poner en el caption, el primer item en la lista debes hacer:
         JAMComboBox.set_item_inicial()
         Esto no ejecutará su callback.

Para poner en el caption, un item específico debes hacer:
         JAMComboBox.set_item_in_caption(num)
         num es un entero que representa al indice del item en la lista de items del combo.


Notas:
       
JAMComboBox crea todos los items del mismo tamaño. El tamaño de los items se ve limitado por la cantidad de caracteres de los captions.
        Puedes establecer ese límite seteando directamente el atributo
JAMComboBox.limitecaracteres (con un entero).
        Actualmente, no se puede agregar imágenes en los items de JAMComboBox.

Puedes ejecutar: python JAMComboBox.py para ver un ejemplo en pantalla.

Comments