TreeMap Component — sgcHTML | eSeGeCe

TreeMap

TsgcHTMLComponent_TreeMap — rendert eine squarified Treemap als eigenständiges, serverseitig erzeugtes Inline-SVG, ohne Chart-Bibliothek, in Delphi, C++ Builder und .NET.

TsgcHTMLComponent_TreeMap

Fügen Sie Elemente mit einem Label und einem Wert hinzu (oder binden Sie ein Dataset), wählen Sie ein Farbschema, und lesen Sie dann die HTML-Eigenschaft.

Komponentenklasse

TsgcHTMLComponent_TreeMap

Rendert

Eigenständiges Inline-SVG, squarified Layout

Sprachen

Delphi, C++ Builder, .NET

Elemente hinzufügen, rendern

Rufen Sie AddItem für jedes Rechteck auf, wählen Sie ein ColorScheme, und lesen Sie dann HTML. Das Layout wird serverseitig berechnet und benötigt keine clientseitige Bibliothek.

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 });

Wichtige Eigenschaften & Methoden

Die Member, die Sie am häufigsten verwenden.

Items / AddItem

AddItem(aLabel, aValue, aColor) fügt ein Blattrechteck hinzu; ein explizites aColor überschreibt das aktive ColorScheme.

Hierarchie

Items unterstützen eine zweistufige Treemap: Setzen Sie ID/ParentID bei Eltern- und Kindelementen, um Kindrechtecke innerhalb ihres ausgeblichenen Elternelements zu verschachteln.

Dataset-Bindung

LoadFromDataSet(aDataSet, aLabelField, aValueField) lädt ein flaches Element pro Zeile.

Einmalhelfer

Die Klassenfunktion Build(aLabels, aValues) rendert eine flache Treemap direkt in eine Zeichenkette, ohne eine Komponenteninstanz verwalten zu müssen.

Größe & Palette

Width, Height, Padding und ColorScheme (default/blue/green/warm/cool/gray) steuern die Zeichenfläche und die automatisch zugewiesenen Rechteckfarben.

Beschriftungen

ShowLabels, ShowValues, MinLabelSize und FontSize entscheiden, wann und wie die Beschriftung eines Rechtecks gezeichnet wird; HTML gibt das fertige Inline-<svg> zurück.

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 beginnen Sie, Treemaps in Delphi, C++ Builder und .NET zu erstellen.