Technical Support
🟢 Online now
Hello 👋

How can we help you today?
Contact on WhatsApp
B4X Store
jdashboardUI / Entradas y controles / jCheckbox
Entradas y controles

jCheckbox

Casilla seleccionable con símbolo, imagen, colores y estado personalizables.

Buscar en toda jdashboardUI
Fuente
jdashboardUI.b4xlib · Solo API pública
Idioma de la tienda: es

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 visual ilustrativa de jCheckbox

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 B4XView
  • Tag As Object

Propiedades del Designer

  • CheckedBackgroundColor
  • IconColor
  • DisabledBackgroundColor
  • DisabledIconColor
  • BorderWidth
  • BorderCornerRadius
  • CheckedAnimated
  • HapticFeedback
  • Checked
  • Enabled
  • Text
  • TextColor
  • TextFontSize
  • TextBold

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.
  • 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.