Composant ProgressBar — sgcHTML | eSeGeCe

ProgressBar

TsgcHTMLComponent_ProgressBar — une barre de progression Bootstrap, rayée et animée, avec un libellé optionnel, ou une barre empilée multi-segments, en Delphi, C++ Builder et .NET.

TsgcHTMLComponent_ProgressBar

Définissez Value et Max pour une barre unique, ou ajoutez des entrées à Bars pour une barre empilée multi-segments, puis lisez la propriété HTML.

Classe du composant

TsgcHTMLComponent_ProgressBar

Produit

Une barre .progress Bootstrap 5 (simple ou empilée)

Langages

Delphi, C++ Builder, .NET

Définissez la valeur, stylez-la, affichez-la

Définissez Value, Max et ColorStyle, activez Striped / Animated / ShowLabel selon vos besoins, puis lisez 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";

Propriétés & méthodes clés

Les membres que vous utilisez le plus souvent.

Barre simple

Value et Max (100 par défaut) définissent le remplissage en pourcentage ; ColorStyle choisit la couleur Bootstrap, ou définissez une couleur CSS brute avec Color.

Libellé

ShowLabel affiche le texte du pourcentage dans la barre ; LabelFormat (%d%% par défaut) contrôle son format.

Rayures & animation

Striped ajoute des rayures diagonales ; Animated implique Striped et les anime le long de la barre.

Segments empilés

Bars.Add ajoute un TsgcHTMLProgressBarItem (Value, ColorStyle / Color, Label_) ; dès que Bars contient des entrées, elles remplacent la barre Value unique.

Dimensionnement & identité

Height définit une hauteur de barre CSS personnalisée ; ProgressBarID (ou ElementID) nomme le <div class="progress"> englobant pour les envois de fragments.

Sortie

HTML renvoie l'enveloppe de progression plus son ou ses segments de barre, prêts à être intégrés ou poussés via WebSockets à mesure que la valeur change.

Continuez l'exploration

Aide en ligneRéférence API complète et guide d’utilisation pour ce composant.
Tous les composants sgcHTMLParcourez la matrice complète des fonctionnalités de plus de 80 composants.
Télécharger la version d'essai gratuiteLa version d'essai de 30 jours fournit les projets de démonstration 60.HTML.
TarifsLicences Single, Team et Site avec code source complet.

Prêt à démarrer ?

Téléchargez la version d'essai gratuite et ajoutez des barres de progression à votre application web Delphi, C++ Builder ou .NET.