Technical Support
🟢 Online now
Hello 👋

How can we help you today?
Contact on WhatsApp
B4X Store
jdashboardUI / Gráficos y visualización / JStackedBarChart
Gráficos y visualización

JStackedBarChart

Barras apiladas multi-serie con leyenda, gradientes, grosor y spacing configurables.

Buscar en toda jdashboardUI
Fuente
jdashboardUI.b4xlib · Solo API pública
Idioma de la tienda: es
Imagen de referencia
Referencia visual creada para la documentación a partir del tipo real del componente. No es una captura exacta.
REFERENCE
JStackedBarChart REFERENCE

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

Barras apiladas multi-serie con leyenda, gradientes, grosor y spacing configurables.

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 apiladas multi-serie con leyenda, gradientes, grosor y spacing configurables.

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)
MarkerText String Net Income Title text for the chart
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.)
BarThicknessFactor Float 0.5 Bar width multiplier (0.1 to 1.0). The default 0.5 uses BarWidth unchanged, independently of spacing.
ShowGrid Boolean False Shows or hides the horizontal grid lines
GridColor Color #FF64748B Color of the horizontal grid lines
GridInterval Float 0 Step interval value for grid lines (0 for automatic division)

Creación y ciclo de vida

Private JStackedBarChart1 As JStackedBarChart

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

Ejemplo funcional

Dim X As List
X.Initialize2(Array As String("Q1", "Q2", "Q3", "Q4"))
Dim Product As List
Product.Initialize2(Array As Double(40, 55, 60, 68))
Dim Service As List
Service.Initialize2(Array As Double(20, 25, 30, 36))
Dim Series As List
Series.Initialize
Series.Add(Product)
Series.Add(Service)

JStackedBarChart1.setData(X, Series)
JStackedBarChart1.Legend = Array As String("Product", "Service")

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
ShowAxes read / write Boolean
ShowYAxisValues read / write Boolean
ShowGrid read / write Boolean
GridColor read / write Int
GridInterval read / write Float
TitleFont write B4XFont
TitleColor write Int
XAxisTextColor write Int
TextTitle write String
ColorsList write List
Gradient write Boolean
Legend write List
ValueSuffix write String
BarThicknessFactor write Float
RoundedBars 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:

JStackedBarChart1.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)

  • setGradient(Use As Boolean)

  • setLegend(Names As List)

  • setValueSuffix(Suffix As String)

  • setBarThicknessFactor(Factor As Float)

  • setBarWidth(Width As Float)

  • getBarWidth() As Float

  • setBarSpacing(Spacing As Float)

  • getBarSpacing() As Float

  • setRoundedBars(Enabled 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

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

Componentes relacionados

  • JMultiBarChart
  • JBarChart