Technical Support
🟢 Online now
Hello 👋

How can we help you today?
Contact on WhatsApp
B4X Store
jdashboardUI / Indicators, Progress & Gauges / JCircularProgressBar
Indicators, Progress & Gauges

JCircularProgressBar

Circular progress indicator with min/max, animated value, value/percentage center text, title and PNG export.

Source
jdashboardUI.b4xlib · Public API only
Store language: en
Reference visual
Documentation reference created from the real component type. It is not an exact screenshot.
REFERENCE
JCircularProgressBar REFERENCE 72%

Indicators, Progress & Gauges · jdashboardUI 23.5 · B4J / JavaFX

Circular progress indicator with min/max, animated value, value/percentage center text, title and PNG export.

The image shown on this page is a documentation reference visual. It is not intended to be a pixel-perfect screenshot; the real result depends on size, theme, colors and data.

Highlights

  • PNG export
  • Configurable animation
  • Configurable title
  • Click interaction
  • Animated value

When to use it

Circular progress indicator with min/max, animated value, value/percentage center text, title and PNG export.

Designer Properties

Property Type Default Description
MinValue Float 0 Minimum value of the progress.
MaxValue Float 100 Maximum value of the progress.
CurrentValue Float 50 Current value of the progress.
StrokeWidth Int 10 Thickness of the arc in dip.
ProgressColor Color 0xFFFF5555 Color of the progress arc.
CenterText String `` Custom text for the center (leave blank to use value).
DisplayAs String Progress Display mode for center text (Progress or Percentage)
AnimationDuration Int 1000 Duration of the progress animation in milliseconds.
TitleText String `` Title text to display above the progress circle.

Creation and lifecycle

Private JCircularProgressBar1 As JCircularProgressBar

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

Working example

JCircularProgressBar1.ValueMin = 0
JCircularProgressBar1.ValueMax = 100
JCircularProgressBar1.CenterType = JCircularProgressBar1.TypePercentage
JCircularProgressBar1.Title = "CPU"
JCircularProgressBar1.Value = 72

Normalized B4X properties

Compatible public getX/setX accessors are presented as normal B4X properties. Parameterized accessors remain documented as methods.

Property Access Type
Value read / write Float
Color read / write Int
CenterType write String
WidthStroke write Int
Title write String
TitleTextColor write Int
TitleFont write B4XFont
ValueMin write Float
ValueMax write Float

Events

  • ValueChanged (NewValue As Float)
  • MouseClicked

Export and rendering

When the module exposes SaveAsPNG / SavePNG, the rendered control can be saved directly to PNG. Check the returned Boolean when provided.

Source-backed notes for the analyzed version

  • Center display can be Progress or Percentage. ValueChanged and MouseClicked events are declared.

Complete public API

  • 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)
  • setCenterType(CenterType As String)
  • DrawProgress()
  • setValue(Value As Float)
  • getValue() As Float
  • setColor(Color As Int)
  • getColor() As Int
  • SaveAsPNG(Dir As String, FileName As String, BackgroundColor As Int) As Boolean
  • setWidthStroke(Width As Int)
  • setTitle(Text As String)
  • setTitleTextColor(Color As Int)
  • setTitleFont(Font As B4XFont)
  • setValueMin(Value As Float)
  • setValueMax(Value As Float)
  • jdashboard_CircularProgressBar
  • JGaugeProgress
  • jGauge