ProgressBar Component — sgcHTML | eSeGeCe

ProgressBar

TsgcHTMLComponent_ProgressBar — ein gestreifter und animierter Bootstrap-Fortschrittsbalken mit optionaler Beschriftung, oder ein gestapelter Mehrfachsegment-Balken, in Delphi, C++ Builder und .NET.

TsgcHTMLComponent_ProgressBar

Setzen Sie Value und Max für einen einzelnen Balken, oder fügen Sie Einträge zu Bars für einen gestapelten Mehrfachsegment-Balken hinzu, und lesen Sie dann die HTML-Eigenschaft.

Komponentenklasse

TsgcHTMLComponent_ProgressBar

Rendert

Bootstrap-5-.progress-Balken (einzeln oder gestapelt)

Sprachen

Delphi, C++ Builder, .NET

Wert setzen, gestalten, rendern

Setzen Sie Value, Max und ColorStyle, aktivieren Sie bei Bedarf Striped / Animated / ShowLabel, und lesen Sie dann HTML.

uses
  sgcHTML_Enums, sgcHTML_Component_ProgressBar;

var
  oBar: TsgcHTMLComponent_ProgressBar;
begin
  oBar := TsgcHTMLComponent_ProgressBar.Create(nil);
  try
    oBar.ProgressBarID := 'upload';
    oBar.Value := 72;
    oBar.Max := 100;
    oBar.ColorStyle := hcSuccess;
    oBar.Striped := True;
    oBar.Animated := True;
    oBar.ShowLabel := True;
    oBar.LabelFormat := '%d%% complete';

    WebModule.Response := oBar.HTML;   // Bootstrap progress bar
  finally
    oBar.Free;
  end;
end;

// Or a stacked, multi-segment bar:
with oBar.Bars.Add do
begin
  Value := 40;
  ColorStyle := hcPrimary;
  Label_ := 'Done';
end;
with oBar.Bars.Add do
begin
  Value := 20;
  ColorStyle := hcWarning;
  Label_ := 'In progress';
end;
// includes: sgcHTML_Enums.hpp, sgcHTML_Component_ProgressBar.hpp

TsgcHTMLComponent_ProgressBar *oBar = new TsgcHTMLComponent_ProgressBar(NULL);
try
{
  oBar->ProgressBarID = "upload";
  oBar->Value = 72;
  oBar->Max = 100;
  oBar->ColorStyle = hcSuccess;
  oBar->Striped = true;
  oBar->Animated = true;
  oBar->ShowLabel = true;
  oBar->LabelFormat = "%d%% complete";

  String html = oBar->HTML;   // Bootstrap progress bar

  // Or a stacked, multi-segment bar:
  TsgcHTMLProgressBarItem *oSeg1 = oBar->Bars->Add();
  oSeg1->Value = 40;
  oSeg1->ColorStyle = hcPrimary;
  oSeg1->Label_ = "Done";

  TsgcHTMLProgressBarItem *oSeg2 = oBar->Bars->Add();
  oSeg2->Value = 20;
  oSeg2->ColorStyle = hcWarning;
  oSeg2->Label_ = "In progress";
}
__finally
{
  delete oBar;
}
using esegece.sgcWebSockets;

var bar = new TsgcHTMLComponent_ProgressBar();
bar.ProgressBarID = "upload";
bar.Value = 72;
bar.Max = 100;
bar.ColorStyle = TsgcHTMLColor.hcSuccess;
bar.Striped = true;
bar.Animated = true;
bar.ShowLabel = true;
bar.LabelFormat = "%d%% complete";

string html = bar.HTML;   // Bootstrap progress bar

// Or a stacked, multi-segment bar:
var seg1 = bar.Bars.Add();
seg1.Value = 40;
seg1.ColorStyle = TsgcHTMLColor.hcPrimary;
seg1.Label_ = "Done";

var seg2 = bar.Bars.Add();
seg2.Value = 20;
seg2.ColorStyle = TsgcHTMLColor.hcWarning;
seg2.Label_ = "In progress";

Wichtige Eigenschaften & Methoden

Die Member, die Sie am häufigsten verwenden.

Einzelner Balken

Value und Max (Standard 100) setzen die Füllbreite als Prozentsatz; ColorStyle wählt die Bootstrap-Farbe, oder setzen Sie eine rohe CSS-Farbe mit Color.

Beschriftung

ShowLabel rendert den Prozenttext im Balken; LabelFormat (Standard %d%%) steuert die Formatierung.

Gestreift & animiert

Striped fügt diagonale Streifen hinzu; Animated impliziert gestreift und animiert sie über den Balken hinweg.

Gestapelte Segmente

Bars.Add fügt ein TsgcHTMLProgressBarItem hinzu (Value, ColorStyle / Color, Label_); sobald Bars Einträge enthält, ersetzen sie den einzelnen Value-Balken.

Größe & Identität

Height setzt eine benutzerdefinierte CSS-Balkenhöhe; ProgressBarID (oder ElementID) benennt das äußere <div class="progress"> für Fragment-Übertragungen.

Ausgabe

HTML gibt den Progress-Wrapper samt seiner Balkensegmente zurück, bereit zum Einbetten oder zum Übertragen per WebSockets, sobald sich der Wert ändert.

Weiter entdecken

Online-HilfeVollständige API-Referenz und Verwendungshandbuch für diese Komponente.
Alle sgcHTML-KomponentenDurchsuchen Sie die vollständige Funktionsmatrix von über 80 Komponenten.
Kostenlose Testversion herunterladenDie 30-Tage-Testversion enthält die 60.HTML-Demoprojekte.
PreiseSingle-, Team- und Site-Lizenzen mit vollständigem Quellcode.

Bereit loszulegen?

Laden Sie die kostenlose Testversion herunter und fügen Sie Fortschrittsbalken zu Ihrer Delphi-, C++-Builder- oder .NET-Webanwendung hinzu.