TreeMap Component — sgcHTML | eSeGeCe

TreeMap

TsgcHTMLComponent_TreeMap — renderizza una treemap squarificata come SVG inline autonomo, generato lato server, senza bisogno di alcuna libreria di grafici, in Delphi, C++ Builder e .NET.

In sintesi

TsgcHTMLComponent_TreeMap

Aggiungi elementi con un’etichetta e un valore (oppure collega un dataset), scegli uno schema colori, quindi leggi la proprietà HTML.

Classe del componente

TsgcHTMLComponent_TreeMap

Renderizza

Self-contained inline SVG, squarified layout

Famiglia

Grafici e Visualizzazione

Linguaggi

Delphi, C++ Builder, .NET

QuickStart

Aggiungi gli elementi, renderizzalo

Chiama AddItem per ogni rettangolo, scegli un ColorScheme, quindi leggi HTML. Il layout viene calcolato lato server e non richiede alcuna libreria client-side.

uses
  sgcHTML_Component_TreeMap;

var
  oTreeMap: TsgcHTMLComponent_TreeMap;
begin
  oTreeMap := TsgcHTMLComponent_TreeMap.Create(nil);
  try
    oTreeMap.Width := 640;
    oTreeMap.Height := 360;
    oTreeMap.ColorScheme := tmCool;
    oTreeMap.ShowValues := True;

    oTreeMap.AddItem('Engineering', 420000);
    oTreeMap.AddItem('Sales', 260000);
    oTreeMap.AddItem('Marketing', 140000);
    oTreeMap.AddItem('Support', 90000, '#20c997');   // explicit colour overrides the scheme

    WebModule.Response := oTreeMap.HTML;   // <svg> squarified rectangles, no client-side library
  finally
    oTreeMap.Free;
  end;
end;

// Or bind it straight to a dataset:
oTreeMap.LoadFromDataSet(qryBudget, 'Department', 'Amount');

// One-shot helper, no instance to manage:
Response := TsgcHTMLComponent_TreeMap.Build(['Engineering', 'Sales'], [420000, 260000]);

// includes: sgcHTML_Component_TreeMap.hpp

TsgcHTMLComponent_TreeMap *oTreeMap = new TsgcHTMLComponent_TreeMap(NULL);
try
{
  oTreeMap->Width = 640;
  oTreeMap->Height = 360;
  oTreeMap->ColorScheme = tmCool;
  oTreeMap->ShowValues = true;

  oTreeMap->AddItem("Engineering", 420000);
  oTreeMap->AddItem("Sales", 260000);
  oTreeMap->AddItem("Marketing", 140000);
  oTreeMap->AddItem("Support", 90000, "#20c997");   // explicit colour overrides the scheme

  String html = oTreeMap->HTML;   // <svg> squarified rectangles, no client-side library
}
__finally
{
  delete oTreeMap;
}

using esegece.sgcWebSockets;

var treeMap = new TsgcHTMLComponent_TreeMap();
treeMap.Width = 640;
treeMap.Height = 360;
treeMap.ColorScheme = TsgcHTMLTreeMapScheme.tmCool;
treeMap.ShowValues = true;

treeMap.AddItem("Engineering", 420000);
treeMap.AddItem("Sales", 260000);
treeMap.AddItem("Marketing", 140000);
treeMap.AddItem("Support", 90000, "#20c997");   // explicit colour overrides the scheme

string html = treeMap.HTML;   // <svg> squarified rectangles, no client-side library

// One-shot helper, no instance to manage:
string quick = TsgcHTMLComponent_TreeMap.Build(new[] { "Engineering", "Sales" }, new[] { 420000d, 260000d });

Riferimento

Proprietà e metodi principali

I membri che utilizzerai più spesso.

Items / AddItem

AddItem(aLabel, aValue, aColor) aggiunge un rettangolo foglia; un aColor esplicito sovrascrive il ColorScheme attivo.

Gerarchia

Items supporta una treemap a due livelli: imposta ID / ParentID sugli elementi genitore e figlio per annidare i rettangoli figli all’interno del genitore sfumato.

Binding ai dataset

LoadFromDataSet(aDataSet, aLabelField, aValueField) carica un elemento piatto per ogni riga.

Helper one-shot

La funzione di classe Build(aLabels, aValues) renderizza una treemap piatta direttamente in una stringa, senza dover gestire alcuna istanza del componente.

Dimensioni e tavolozza

Width, Height, Padding e ColorScheme (default/blue/green/warm/cool/gray) controllano la tela e i colori dei rettangoli assegnati automaticamente.

Etichette

ShowLabels, ShowValues, MinLabelSize e FontSize decidono quando e come viene disegnata la didascalia di un rettangolo; HTML restituisce l’elemento inline <svg> finito.

Risorse

Continua a esplorare

	Guida in lineaRiferimento API completo e guida all’uso per questo componente.	Apri
	Tutti i componenti sgcHTMLEsplora la matrice completa delle funzionalità di oltre 80 componenti.	Apri
	Scarica la Prova GratuitaLa prova di 30 giorni include i progetti demo 60.HTML.	Apri
	PrezziLicenze Single, Team e Site con codice sorgente completo.	Apri