Componente ProgressBar — sgcHTML | eSeGeCe

ProgressBar

TsgcHTMLComponent_ProgressBar — uma barra de progresso Bootstrap, listrada e animada, com um rótulo opcional, ou uma barra empilhada com múltiplos segmentos, em Delphi, C++ Builder e .NET.

TsgcHTMLComponent_ProgressBar

Defina Value e Max para uma barra única, ou adicione entradas a Bars para uma barra empilhada com múltiplos segmentos, e então leia a propriedade HTML.

Classe do componente

TsgcHTMLComponent_ProgressBar

Renderiza

Barra .progress do Bootstrap 5 (única ou empilhada)

Linguagens

Delphi, C++ Builder, .NET

Defina o valor, estilize, renderize

Defina Value, Max e ColorStyle, ative Striped / Animated / ShowLabel conforme necessário e então leia 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";

Principais propriedades & métodos

Os membros que você usa com mais frequência.

Barra única

Value e Max (padrão 100) definem a largura de preenchimento como uma porcentagem; ColorStyle escolhe a cor do Bootstrap, ou defina uma cor CSS bruta com Color.

Rótulo

ShowLabel renderiza o texto da porcentagem dentro da barra; LabelFormat (padrão %d%%) controla como ele é formatado.

Listrada e animada

Striped adiciona listras diagonais; Animated implica listrado e as anima ao longo da barra.

Segmentos empilhados

Bars.Add adiciona um TsgcHTMLProgressBarItem (Value, ColorStyle / Color, Label_); quando Bars tem entradas, elas substituem a barra única de Value.

Dimensionamento e identidade

Height define uma altura de barra CSS personalizada; ProgressBarID (ou ElementID) nomeia o <div class="progress"> externo para envios de fragmentos.

Saída

HTML retorna o wrapper de progresso mais seu(s) segmento(s) de barra, pronto para incorporar ou enviar via WebSockets conforme o valor muda.

Continue explorando

Ajuda onlineReferência completa da API e guia de uso para este componente.
Todos os Componentes sgcHTMLExplore a matriz completa de recursos com mais de 80 componentes.
Baixar Versão de Avaliação GratuitaA avaliação de 30 dias inclui os projetos de demonstração 60.HTML.
PreçosLicenças Single, Team e Site com código-fonte completo.

Pronto para Começar?

Baixe a versão de avaliação gratuita e adicione barras de progresso à sua aplicação web Delphi, C++ Builder ou .NET.