Gráficos y visualización · jdashboardUI 23.5 · B4J / JavaFX
Múltiples series de líneas con leyenda, fill opcional, curvas, colores y estilos de ejes/grid.
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
- Interacción por clic
- Múltiples series
Cuándo usarlo
Múltiples series de líneas con leyenda, fill opcional, curvas, colores y estilos de ejes/grid.
Designer Properties
| Property | Type | Default | Description |
|---|---|---|---|
| LineColors | String | #FF6C5CE7;#FF00CEC9;#FF55EFC4;#FFFDCB6E;#FFD63031;#FF0984E3;#FFFAB1A0;#FF74B9FF;#FFA29BFE;#FF81ECEC |
Colors of the lines (separated by semicolons, format #AARRGGBB) |
| ShowMarker | Boolean | True |
Shows the values above each point |
| 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 |
| ShowFill | Boolean | True |
Shows or hides the fill under the chart lines |
| ValueSuffix | String | `` | Suffix for point values (e.g., %, $, etc.) |
| SmoothCurves | Boolean | False |
Use cubic bezier curves instead of straight lines. |
| 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 JMultiLineChart1 As JMultiLineChart
JMultiLineChart1.Initialize(Me, "JMultiLineChart1")
JMultiLineChart1.AddToParent(Root, 20dip, 20dip, 640dip, 360dip)
Ejemplo funcional
Dim X As List
X.Initialize2(Array As String("Mon", "Tue", "Wed", "Thu"))
Dim A As List
A.Initialize2(Array As Double(12, 25, 18, 40))
Dim B As List
B.Initialize2(Array As Double(20, 18, 35, 44))
Dim Series As List
Series.Initialize
Series.Add(A)
Series.Add(B)
JMultiLineChart1.setData(X, Series)
JMultiLineChart1.Legend = Array As String("Web", "Mobile")
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 |
|---|---|---|
| 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 |
| TextTitle | write | String |
| TitleColor | write | Int |
| XAxisTextColor | write | Int |
| Colors | write | List |
| ShowValues | write | Boolean |
| ShowFill | write | Boolean |
| Legend | write | List |
| Suffix | write | String |
| LegendFont | write | B4XFont |
| LegendTextColor | write | Int |
| ValuesFont | write | B4XFont |
| XAxisFont | write | B4XFont |
| Curves | write | Boolean |
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:
JMultiLineChart1.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) -
setTextTitle(Title As String) -
setTitleColor(Color As Int) -
setXAxisTextColor(Color As Int) -
setColors(Colors As List) -
setShowValues(Show As Boolean) -
setShowFill(Show As Boolean) -
setLegend(Names As List) -
setSuffix(Suffix As String) -
SaveAsPNG(Dir As String, FileName As String, BackgroundColor As Int) As Boolean -
setLegendFont(Font As B4XFont) -
setLegendTextColor(Color As Int) -
setValuesFont(Font As B4XFont) -
setXAxisFont(Font As B4XFont) -
setCurves(Curves As Boolean) -
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
- JLineChart
- JRadarChart