B4X Store

Fuente

jdashboardUI.b4xlib · Solo API pública

Idioma de la tienda: es

JDashboardUI · Referencia completa · B4J/JavaFX · Biblioteca del 30 de octubre de 2026

Selector con texto, iconos o imágenes, pares texto/valor, temas, alineación y eventos distintos para opciones simples y opciones con valor.

Maqueta visual ilustrativa de jcombobox

Maqueta gráfica ilustrativa, no captura exacta del control.

Para qué sirve y cuándo utilizarlo

Selector con texto, iconos o imágenes, pares texto/valor, temas, alineación y eventos distintos para opciones simples y opciones con valor.

Inicialización, uso y ejemplos prácticos

El código siguiente muestra las operaciones disponibles. Cuando se utiliza Root, este representa un B4XView ya creado. Los archivos de imagen ilustrativos deben existir en Files.

' Create a selector with optional values
Private Lang As jcombobox
Lang.Initialize(Me, "Lang")
Lang.AddToParent(Root, 20dip, 20dip, 230dip, 40dip, _
    xui.Color_RGB(48, 52, 80), 8dip, fx.Colors.White, "Language", 14)
Lang.Add_Option("Automatic")
Lang.Add_Option2("Español", "es")
Lang.Add_Option2("English", "en")
Lang.Add_Option_With_Icon("Home", Chr(0xF015), _
    xui.Color_White, fx.CreateFontAwesome(18))
Lang.Add_Option_With_Image("Account", File.DirAssets, "avatar.png")

' Select and inspect
Lang.SelectIndex = 1
Log(Lang.SelectOption)
Log(Lang.SelectIndex)
Log(Lang.Value)
Log(Lang.Size)

' Theme, alignment, dropdown height
Lang.Theme = "MidnightBlue"
Lang.LockCustomColors = False
Lang.paneOptionheight = 220dip
Lang.RefreshUI

' Events
Private Sub Lang_ItemClick(Index As Int, Text As String)
    Log(Text)
End Sub

Private Sub Lang_ItemClick2(ItemText As String, ItemValue As Object)
    Log(ItemText & " = " & ItemValue)
End Sub

Referencia completa de los miembros públicos

Este módulo expone 29 métodos / accesores públicos en la versión revisada. A continuación se documentan todas sus firmas, incluyendo las variantes, getters/setters y hooks del Designer.

Firma exacta del código fuente	Para qué sirve
`Initialize(Callback As Object, EventName As String)`	Inicializa la instancia y, si se solicita, vincula Callback y EventName.
`DesignerCreateView(Base As Object, Lbl As Label, Props As Map)`	Hook de B4J Designer, no se invoca manualmente.
`AddToParent(Parent As B4XView, Left As Int, Top As Int, Width As Int, Height As Int, Color_background As Int, Corner_radius As Int, textcolor As Paint, main_text As String, txtSize As Int)`	Inserta el control en Parent con posición, tamaño y opciones iniciales.
`setTextColor(Color As Paint)`	Configura TextColor; con un solo parámetro suele usarse como propiedad B4X.
`setpaneOptionheight(Height As Int)`	Método público; utiliza los parámetros de la firma declarada.
`getpaneOptionheight As Int`	Método público; utiliza los parámetros de la firma declarada.
`setArrowIconOpen(Icon As String)`	Configura ArrowIconOpen; con un solo parámetro suele usarse como propiedad B4X.
`setTextforIndex(Index_value As Int)`	Configura TextforIndex; con un solo parámetro suele usarse como propiedad B4X.
`setSelectOption(Option As String)`	Configura SelectOption; con un solo parámetro suele usarse como propiedad B4X.
`getSelectOption As String`	Lee la propiedad SelectOption.
`getSelectIndex As Int`	Lee la propiedad SelectIndex.
`Add_Option(TextValue As String)`	Añade una opción solo con texto.
`Add_Option_With_Icon(text1 As String, icon As Char, IconColor As Int, font As Font)`	Añade opción de texto e icono de fuente.
`Add_Option_With_Image(text1 As String, DirIcon As String, FileIcon As String)`	Añade opción de texto e imagen.
`Add_Option2_With_Image(TextValue As String, Value As Object, DirIcon As String, FileIcon As String)`	Añade texto, valor asociado e imagen.
`Add_Option2_With_Icon(TextValue As String, Value As Object, icon As Char, IconColor As Int, font As Font)`	Añade texto, valor asociado e icono.
`Add_Option2(TextValue As String, Value As Object)`	Añade texto visible y valor asociado de tipo Object.
`clear`	Elimina todas las opciones.
`RefreshUI`	Reaplica colores y configuración visual.
`ApplyPredefinedTheme(ThemeName As String)`	Aplica uno de los temas predefinidos.
`setTheme(ThemeName As String)`	Configura Theme; con un solo parámetro suele usarse como propiedad B4X.
`getTheme As String`	Lee la propiedad Theme.
`setLockCustomColors(Lock As Boolean)`	Configura LockCustomColors; con un solo parámetro suele usarse como propiedad B4X.
`getLockCustomColors As Boolean`	Lee la propiedad LockCustomColors.
`getSize As Int`	Lee la propiedad Size.
`setSelectIndex(Index_value As Int)`	Configura SelectIndex; con un solo parámetro suele usarse como propiedad B4X.
`getText As String`	Lee la propiedad Text.
`getValue As String`	Lee la propiedad Value.
`setValue(ValueText As String)`	Configura Value; con un solo parámetro suele usarse como propiedad B4X.

Propiedades B4X: lectura y escritura

Los métodos públicos getX y setX (cuando corresponda) se utilizan mediante la propiedad Control.X. Los métodos con varios parámetros deben utilizarse como métodos.

Propiedad	Acceso
`TextColor`	escritura
`ArrowIconOpen`	escritura
`TextforIndex`	escritura
`SelectOption`	lectura / escritura
`SelectIndex`	lectura / escritura
`Theme`	lectura / escritura
`LockCustomColors`	lectura / escritura
`Size`	lectura
`Text`	lectura
`Value`	lectura / escritura

Campos públicos

mBase As B4XView
ArrowColor As Int
ArrowFont As Font
HeaderAlignment As String
ItemAlignment As String
ColorizeIcon As Boolean

Propiedades del Designer

color
TextColor
TextSize
MainText
cornerradius
Theme
LockCustomColors
ColorizeIcon
HeaderAlignment
ItemAlignment

Eventos

ItemClick(index As Int, text As String)
ItemClick2(ItemText As String, ItemValue As Object)

Ciclo de vida, compatibilidad y límites

En la implementación examinada la lista aparece debajo del control: no hay apertura automática hacia arriba. No des por supuesta compatibilidad de esta CustomView con JToolBar.AddView; en una barra compacta utiliza el ComboBox nativo JavaFX.

DesignerCreateView y Base_Resize, cuando aparezcan en la referencia pública, son hooks administrados por el sistema de Custom Views; normalmente no se llaman manualmente. Si colocas el control desde el Designer, no vuelvas a inicializar la misma instancia.

Icon Choose: el ejemplo que viene con JDashboardUI permite navegar fuentes, buscar y previsualizar iconos, seleccionar colores y copiar los códigos Chr(0x...) y colores B4X. Los archivos TTF ya se incluyen en la librería.

Convenciones de la API

Los parámetros y tipos que aparecen en cada firma se toman del código fuente de la biblioteca.
B4XView es una vista XUI; B4XFont es una fuente XUI y Object es un valor genérico.
Los nombres de variables en los ejemplos son ilustrativos: utiliza los nombres reales de tu proyecto.
El código se ha revisado frente a la biblioteca; no se ha realizado compilación B4J en este entorno.