Gauge

TsgcHTMLComponent_Gauge — renderizza un indicatore SVG semicircolare che traccia un valore rispetto al suo minimo e massimo con soglie di colore basso, medio e alto, in Delphi, C++ Builder e .NET.

TsgcHTMLComponent_Gauge

Un componente KPI che emette un semicerchio <svg> inline autonomo. Imposta il valore, l’intervallo e l’unità, quindi leggi la proprietà HTML — il colore dell’arco cambia automaticamente quando il valore supera le soglie media e alta.

Classe del componente

TsgcHTMLComponent_Gauge

Renderizza

Inline <svg> semicircular gauge

Linguaggi

Delphi, C++ Builder, .NET

Crealo, imposta il valore, renderizzalo

Imposta Value, MinValue e MaxValue, scegli le soglie, quindi leggi HTML. Per un indicatore occasionale usa l’helper statico Build.

uses
  sgcHTML_Enums, sgcHTML_Component_Gauge;

var
  oGauge: TsgcHTMLComponent_Gauge;
begin
  oGauge := TsgcHTMLComponent_Gauge.Create(nil);
  try
    oGauge.Title := 'CPU Load';
    oGauge.Value := 72;
    oGauge.MinValue := 0;
    oGauge.MaxValue := 100;
    oGauge.Unit_ := '%';

    oGauge.ThresholdMid := 50;
    oGauge.ThresholdHigh := 80;
    oGauge.ColorLowStyle := hcSuccess;
    oGauge.ColorMidStyle := hcWarning;
    oGauge.ColorHighStyle := hcDanger;

    WebModule.Response := oGauge.HTML;   // inline <svg> semicircle
  finally
    oGauge.Free;
  end;
end;

// Or one line with the static Build helper:
Result := TsgcHTMLComponent_Gauge.Build('CPU Load', 72, 0, 100, '%');
// includes: sgcHTML_Enums.hpp, sgcHTML_Component_Gauge.hpp

TsgcHTMLComponent_Gauge *oGauge = new TsgcHTMLComponent_Gauge(NULL);
try
{
  oGauge->Title = "CPU Load";
  oGauge->Value = 72;
  oGauge->MinValue = 0;
  oGauge->MaxValue = 100;
  oGauge->Unit_ = "%";

  oGauge->ThresholdMid = 50;
  oGauge->ThresholdHigh = 80;
  oGauge->ColorLowStyle = hcSuccess;
  oGauge->ColorMidStyle = hcWarning;
  oGauge->ColorHighStyle = hcDanger;

  String html = oGauge->HTML;   // inline <svg> semicircle
}
__finally
{
  delete oGauge;
}

// Or one line with the static Build helper:
String html = TsgcHTMLComponent_Gauge::Build("CPU Load", 72, 0, 100, "%");
using esegece.sgcWebSockets;

var gauge = new TsgcHTMLComponent_Gauge();
gauge.Title = "CPU Load";
gauge.Value = 72;
gauge.MinValue = 0;
gauge.MaxValue = 100;
gauge.Unit_ = "%";

gauge.ThresholdMid = 50;
gauge.ThresholdHigh = 80;
gauge.ColorLowStyle = TsgcHTMLColor.hcSuccess;
gauge.ColorMidStyle = TsgcHTMLColor.hcWarning;
gauge.ColorHighStyle = TsgcHTMLColor.hcDanger;

string html = gauge.HTML;   // inline <svg> semicircle

// Or one line with the static Build helper:
string html = TsgcHTMLComponent_Gauge.Build("CPU Load", 72, 0, 100, "%");

Proprietà e metodi principali

I membri che utilizzerai più spesso.

Valore e intervallo

Value, MinValue e MaxValue (tutti Double) definiscono fino a dove si riempie l’arco; il valore viene limitato automaticamente all’intervallo.

Etichette

Title viene stampato sotto l’indicatore e Unit_ accanto al valore; il minimo e il massimo sono disegnati alle estremità dell’arco.

Soglie

ThresholdMid e ThresholdHigh (Double) decidono quale colore usa l’arco del valore man mano che la lettura cresce.

Colori

ColorLowStyle, ColorMidStyle e ColorHighStyle (TsgcHTMLColor) impostano i colori delle soglie; le stringhe ColorLow/ColorMid/ColorHigh li sovrascrivono con un colore CSS letterale. BackgroundArcColorStyle colora la traccia.

Dimensionamento

Width (px, predefinito 200), ArcStrokeWidth, ValueFontSize, UnitFontSize, LabelFontSize e SvgViewBox regolano l’SVG renderizzato.

Output e Build

HTML restituisce l’indicatore <svg> inline. Lo statico Build(aTitle, aValue, aMin, aMax, aUnit, aGaugeID) restituisce lo stesso markup con una singola chiamata.

Continua a esplorare

Tutti i componenti sgcHTMLEsplora la matrice completa delle funzionalità di oltre 60 componenti.
Scarica la Prova GratuitaLa prova di 30 giorni include i progetti demo 60.HTML.
PrezziLicenze Single, Team e Site con codice sorgente completo.

Pronto a Iniziare?

Scarica la versione di prova gratuita e aggiungi indicatori alla tua app web in Delphi, C++ Builder o .NET.