JDashboardUI · Referencia completa · B4J/JavaFX · Biblioteca del 30 de octubre de 2026
Casilla de verificación personalizable con símbolos de fuentes, imágenes, texto, animaciones, estados deshabilitados y eventos.
Maqueta gráfica ilustrativa, no captura exacta del control.
Para qué sirve y cuándo utilizarlo
Casilla de verificación personalizable con símbolos de fuentes, imágenes, texto, animaciones, estados deshabilitados y eventos.
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.
' Custom checkbox from code
Private C As jCheckbox
C.Initialize(Me, "C")
C.AddToParent(Root, 20dip, 20dip, 300dip, 38dip, 10dip, False, "Notifications")
' Configure state, text and typography
C.Checked = True
C.CheckedAnimated = True
C.TextColor = xui.Color_Black
C.TextFontSize = 15
C.TextBold = True
C.Enabled = True
C.IsEvent = True
' Customize checked-state icon
Private Fonts As JIconFont
Fonts.Initialize
Fonts.FontSize = 20
C.SetIcon(Chr(0xF00C), Fonts.IconFontAwesomeSolid)
C.IconColor = xui.Color_White
C.IconSize = 18
C.CheckedBackgroundColor = xui.Color_RGB(16, 185, 129)
C.BorderCornerRadius = 10
C.BorderWidth = 2
' Alternative: use an image instead of the icon
C.SetImage(File.DirAssets, "check.png", True)
' Callback
Private Sub C_CheckedChange(Checked As Boolean)
Log("Checked: " & Checked)
End Sub
Referencia completa de los miembros públicos
Este módulo expone 40 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, CornerRadius As Int, Checked As Boolean, Text As String) |
Inserta el control en Parent con posición, tamaño y opciones iniciales. |
Base_Resize(Width As Double, Height As Double) |
Reorganiza componentes internos al cambiar el tamaño; hook de ciclo de vida. |
setText(Text As String) |
Configura Text; con un solo parámetro suele usarse como propiedad B4X. |
getText As String |
Lee la propiedad Text. |
setTextColor(Color As Int) |
Configura TextColor; con un solo parámetro suele usarse como propiedad B4X. |
getTextColor As Int |
Lee la propiedad TextColor. |
setChecked(Checked As Boolean) |
Configura Checked; con un solo parámetro suele usarse como propiedad B4X. |
getChecked As Boolean |
Lee la propiedad Checked. |
setTextFontType(Font As B4XFont) |
Configura TextFontType; con un solo parámetro suele usarse como propiedad B4X. |
getTextFontType As B4XFont |
Lee la propiedad TextFontType. |
SetIcon(Icon As String, Font As B4XFont) |
Sustituye el glifo marcado y su B4XFont. |
getIcon As String |
Lee la propiedad Icon. |
setIconFont(Font As B4XFont) |
Configura IconFont; con un solo parámetro suele usarse como propiedad B4X. |
getIconFont As B4XFont |
Lee la propiedad IconFont. |
setIconSize(Size As Float) |
Configura IconSize; con un solo parámetro suele usarse como propiedad B4X. |
getIconSize As Float |
Lee la propiedad IconSize. |
SetImage(FileDir As String, FileName As String, KeepAspectRatio As Boolean) |
Utiliza una imagen como indicador marcado; KeepAspectRatio conserva proporciones. |
setBorderCornerRadius(Radius As Int) |
Configura BorderCornerRadius; con un solo parámetro suele usarse como propiedad B4X. |
setBorderWidth(Width As Int) |
Configura BorderWidth; con un solo parámetro suele usarse como propiedad B4X. |
getIconColor As Int |
Lee la propiedad IconColor. |
setIconColor(Color As Int) |
Configura IconColor; con un solo parámetro suele usarse como propiedad B4X. |
setCheckedBackgroundColor(Color As Int) |
Configura CheckedBackgroundColor; con un solo parámetro suele usarse como propiedad B4X. |
getCheckedBackgroundColor As Int |
Lee la propiedad CheckedBackgroundColor. |
setCheckedAnimated(Animated As Boolean) |
Configura CheckedAnimated; con un solo parámetro suele usarse como propiedad B4X. |
setEnabled(Enable As Boolean) |
Configura Enabled; con un solo parámetro suele usarse como propiedad B4X. |
getEnabled As Boolean |
Lee la propiedad Enabled. |
getDisabledBackgroundColor As Int |
Lee la propiedad DisabledBackgroundColor. |
setDisabledBackgroundColor(Color As Int) |
Configura DisabledBackgroundColor; con un solo parámetro suele usarse como propiedad B4X. |
getDisabledIconColor As Int |
Lee la propiedad DisabledIconColor. |
setDisabledIconColor(Color As Int) |
Configura DisabledIconColor; con un solo parámetro suele usarse como propiedad B4X. |
getIsHaptic As Boolean |
Lee la propiedad IsHaptic. |
setIsHaptic(Enabled As Boolean) |
Configura IsHaptic; con un solo parámetro suele usarse como propiedad B4X. |
getIsEvent As Boolean |
Lee la propiedad IsEvent. |
setIsEvent(Enabled As Boolean) |
Configura IsEvent; con un solo parámetro suele usarse como propiedad B4X. |
setTextFontSize(FontSize As Float) |
Configura TextFontSize; con un solo parámetro suele usarse como propiedad B4X. |
setTextBold(Bold As Boolean) |
Configura TextBold; con un solo parámetro suele usarse como propiedad B4X. |
getTextFontSize As Float |
Lee la propiedad TextFontSize. |
getTextBold As Boolean |
Lee la propiedad TextBold. |
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 |
|---|---|
Text |
lectura / escritura |
TextColor |
lectura / escritura |
Checked |
lectura / escritura |
TextFontType |
lectura / escritura |
Icon |
lectura |
IconFont |
lectura / escritura |
IconSize |
lectura / escritura |
BorderCornerRadius |
escritura |
BorderWidth |
escritura |
IconColor |
lectura / escritura |
CheckedBackgroundColor |
lectura / escritura |
CheckedAnimated |
escritura |
Enabled |
lectura / escritura |
DisabledBackgroundColor |
lectura / escritura |
DisabledIconColor |
lectura / escritura |
IsHaptic |
lectura / escritura |
IsEvent |
lectura / escritura |
TextFontSize |
lectura / escritura |
TextBold |
lectura / escritura |
Campos públicos
mBase As B4XViewTag As Object
Propiedades del Designer
CheckedBackgroundColorIconColorDisabledBackgroundColorDisabledIconColorBorderWidthBorderCornerRadiusCheckedAnimatedHapticFeedbackCheckedEnabledTextTextColorTextFontSizeTextBold
Eventos
CheckedChange(Checked As Boolean)
Ciclo de vida, compatibilidad y límites
SetIcon y SetImage son alternativas para personalizar el estado marcado. Algunas funciones, como haptic feedback, dependen de las capacidades de la plataforma.
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.
B4XViewes una vista XUI;B4XFontes una fuente XUI yObjectes 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.