Gráficos y visualización · jdashboardUI 23.5 · B4J / JavaFX
Barras agrupadas con múltiples series, leyenda, colores, gradiente, spacing configurable y valores por serie.
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
- Gradientes
- Título configurable
- Interacción por clic
- Múltiples series
Cuándo usarlo
Barras agrupadas con múltiples series, leyenda, colores, gradiente, spacing configurable y valores por serie.
Designer Properties
| Property | Type | Default | Description |
|---|---|---|---|
| BarColors | String | #FF6C5CE7;#FF00CEC9;#FF55EFC4;#FFFDCB6E;#FFD63031;#FF0984E3;#FFFAB1A0;#FF74B9FF;#FFA29BFE;#FF81ECEC |
Modern fresh colors for the bars (separated by semicolons, format #AARRGGBB) |
| ShowMarker | Boolean | True |
Shows the values above each bar |
| MarkerText | String | API Calls |
|
| Animate | Boolean | True |
|
| Duration | Int | 1000 |
Duration in milliseconds |
| SeriesNames | String | Serie1;Serie2;Serie3;Serie4;Serie5;Serie6;Serie7;Serie8;Serie9;Serie10 |
Names of the series |
| UseGradient | Boolean | False |
Use a gradient fill for the bars |
| ValueSuffix | String | `` | Suffix for bar values (e.g., %, $, etc.) |
| ShowGrid | Boolean | False |
Shows or hides the horizontal grid lines |
| GridColor | Color | 0xFF64748B |
Color of the horizontal grid lines |
| GridInterval | Float | 0 |
Interval between grid lines (0 for auto 4 steps) |
| GridTextColor | Color | 0xFF64748B |
Color of the grid Y-axis labels |
| GridTextBold | Boolean | False |
Set to True to make the Y-axis text bold |
Creación y ciclo de vida
Private JMultiBarChart1 As JMultiBarChart
JMultiBarChart1.Initialize(Me, "JMultiBarChart1")
JMultiBarChart1.AddToParent(Root, 20dip, 20dip, 640dip, 360dip)
Ejemplo funcional
Dim X As List
X.Initialize2(Array As String("Q1", "Q2", "Q3", "Q4"))
Dim A As List
A.Initialize2(Array As Double(20, 35, 45, 60))
Dim B As List
B.Initialize2(Array As Double(28, 42, 40, 72))
Dim Series As List
Series.Initialize
Series.Add(A)
Series.Add(B)
JMultiBarChart1.setData(X, Series)
JMultiBarChart1.Legend = Array As String("2025", "2026")
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.
| Propiedad | Acceso | Tipo |
|---|---|---|
| BarWidth | read / write | Float |
| BarSpacing | read / write | Float |
| SeriesSpacing | read / write | Float |
| ShowAxes | read / write | Boolean |
| ShowYAxisValues | read / write | Boolean |
| ShowGrid | read / write | Boolean |
| GridColor | read / write | Int |
| GridInterval | read / write | Float |
| GridTextColor | read / write | Int |
| GridTextBold | read / write | Boolean |
| TitleFont | write | B4XFont |
| TitleColor | write | Int |
| XAxisTextColor | write | Int |
| TextTitle | write | String |
| ColorsList | write | List |
| ShowValues | write | Boolean |
| Gradient | write | Boolean |
| RoundedBars | write | Boolean |
| Legend | write | List |
| ValueSuffix | write | String |
| ValuesStyle | write | B4XFont |
Eventos
MouseClicked
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
- La API descrita se obtuvo del código fuente real del módulo.
Historial y datos en tiempo real
Para históricos con varias series, Values contiene un valor por serie en el mismo orden utilizado por el gráfico:
JMultiBarChart1.AddPoint( _
DateTime.Time(DateTime.Now), _
Array As Double(42, 55), _
24)
MaxPoints debe ser al menos 1. Al superar el límite, la categoría más antigua se elimina de todas las series al mismo tiempo, manteniendo etiquetas y valores sincronizados. Si el gráfico está vacío, la primera lista de Values establece el número de series. El método devuelve Boolean.
API pública completa
-
AddPoint(Label As String, Values As List, MaxPoints As Int) As Boolean -
Initialize(Callback As Object, EventName As String) -
DesignerCreateView(Base As Object, Lbl As Label, Props As Map) -
AddToParent(Parent As B4XView, Left As Int, Top As Int, Width As Int, Height As Int) -
setData(PointsX As List, ValuesMulti As List) -
setTitleFont(Font As B4XFont) -
setTitleColor(Color As Int) -
setXAxisTextColor(Color As Int) -
setTextTitle(Title As String) -
setColorsList(Colors As List) -
setShowValues(Show As Boolean) -
setGradient(Use As Boolean) -
setBarWidth(Width As Float) -
getBarWidth() As Float -
setBarSpacing(Spacing As Float) -
getBarSpacing() As Float -
setSeriesSpacing(Spacing As Float) -
getSeriesSpacing() As Float -
setRoundedBars(Enabled As Boolean) -
setLegend(Names As List) -
setValueSuffix(Suffix As String) -
SaveAsPNG(Dir As String, FileName As String, BackgroundColor As Int) As Boolean -
setLegendStyle(Font As B4XFont, Color As Int) -
setValuesStyle(Font As B4XFont) -
setElementRotation(v As B4XView, Angle As Float) -
setShowAxes(Show As Boolean) -
getShowAxes() As Boolean -
setShowYAxisValues(Show As Boolean) -
getShowYAxisValues() As Boolean -
setShowGrid(Show As Boolean) -
getShowGrid() As Boolean -
setGridColor(Color As Int) -
getGridColor() As Int -
setGridInterval(Interval As Float) -
getGridInterval() As Float -
setGridTextColor(Color As Int) -
getGridTextColor() As Int -
setGridTextBold(Bold As Boolean) -
getGridTextBold() As Boolean
Componentes relacionados
- JBarChart
- JStackedBarChart