JHorizontalBarChart

Gráficos y visualización · jdashboardUI 23.5 · B4J / JavaFX

Barras horizontales con colores individuales, porcentajes, valor máximo configurable, animación y estilos redondeados.

La imagen mostrada en esta página es una referencia visual creada para la documentación. No pretende ser una captura pixel-perfect del control; el resultado real depende del tamaño, tema, colores y datos.

Características destacadas

• Exportación PNG
• Animación configurable
• Grid / ejes configurables
• Título configurable

Cuándo usarlo

Barras horizontales con colores individuales, porcentajes, valor máximo configurable, animación y estilos redondeados.

Designer Properties

Este módulo no declara Designer Properties.

Creación y ciclo de vida

Private JHorizontalBarChart1 As JHorizontalBarChart

JHorizontalBarChart1.Initialize(Me, "JHorizontalBarChart1")
JHorizontalBarChart1.AddToParent(Root, 20dip, 20dip, 640dip, 360dip)

Ejemplo funcional

Dim Labels As List
Labels.Initialize2(Array As String("Java", "B4X", "Python"))
Dim Values As List
Values.Initialize2(Array As Double(74, 92, 68))
Dim Colors As List
Colors.Initialize2(Array As Int(0xFF6366F1, 0xFF22C55E, 0xFFF59E0B))
JHorizontalBarChart1.SetData(Labels, Values, Colors)
JHorizontalBarChart1.RoundedBars = True

Propiedades B4X normalizadas

Los accesores públicos getX/setX compatibles se presentan como propiedades B4X normales. Los métodos parametrizados siguen documentándose como métodos.

Eventos

No declara eventos públicos en la versión analizada.

Exportación y renderizado

Cuando el módulo expone SaveAsPNG / SavePNG, puedes guardar el estado renderizado del control directamente a PNG. Comprueba el Boolean devuelto cuando exista.

Notas y comportamiento real de la versión analizada

• SetDataAsPercent permite representar porcentajes conservando prefijo/sufijo del importe.

Historial y datos en tiempo real

Puedes agregar nuevas filas de forma incremental, con color opcional por punto:

JHorizontalBarChart1.AddPoint("Ahora", 42, 24)
JHorizontalBarChart1.AddPoint("Ahora", 55, 24, xui.Color_Green)

MaxPoints conserva únicamente las últimas categorías y elimina automáticamente la más antigua al superar el límite. El cuarto parámetro permite definir el color del nuevo punto. El método devuelve Boolean.

API pública completa

• AddPoint(Label As String, Value As Double, MaxPoints As Int, PointColor As Int = 0xFF3B82F6) As Boolean

• Initialize(Callback As Object, EventName As String)

• AddToParent(Parent As B4XView, Left As Int, Top As Int, Width As Int, Height As Int)

• DesignerCreateView(Base As Object, Lbl As Label, Props As Map)

• setTextTitle(Value As String)

• setShowGrid(Value As Boolean)

• setShowAxes(Value As Boolean)

• setShowYAxisValues(Value As Boolean)

• setShowXAxisValues(Value As Boolean)

• setShowValues(Value As Boolean)

• setAnimation(Enabled As Boolean, DurationMs As Int)

• SetTheme(TextColor As Int, GridColor As Int, BackgroundColor As Int)

• setSuffix(Value As String)

• SaveAsPNG(Dir As String, FileName As String) As Boolean

• SetData(Labels As List, Values As List, Colors As List) As Boolean

• SetDataAsPercent(Labels As List, Amounts As List, BarColors As List, PercentBase As Double, AmountPrefix As String, AmountSuffix As String) As Boolean

• setRoundedBars(Value As Boolean)

• setBarSpacing(Value As Float)

• setMaximum(Value As Float)

Componentes relacionados

• JBarChart
• JDivergingBarChart