Transfer-component — sgcHTML | eSeGeCe

Transfer

TsgcHTMLComponent_Transfer — render een dual-listbox transfer-widget die items verplaatst tussen een beschikbaar en een toegewezen paneel, met filtering en datasetbinding, in Delphi, C++ Builder en .NET.

TsgcHTMLComponent_Transfer

Voeg items toe (of koppel een dataset), laat de bezoeker ze tussen de twee panelen verplaatsen met de knoppen, een dubbelklik, of het filtervak, en lees dan de HTML-eigenschap.

Componentklasse

TsgcHTMLComponent_Transfer

Rendert

Bootstrap 5 dual-panel widget + scoped CSS

Talen

Delphi, C++ Builder, .NET

Voeg items toe, stel een veldnaam in, render het

Roep AddItem aan voor elke rij (of LoadFromDataSet voor een volledige dataset), stel FieldName in zodat de toegewezen items als verborgen invoervelden worden gepost, en lees dan HTML.

uses
  sgcHTML_Component_Transfer;

var
  oTransfer: TsgcHTMLComponent_Transfer;
begin
  oTransfer := TsgcHTMLComponent_Transfer.Create(nil);
  try
    oTransfer.TransferID := 'roles';
    oTransfer.FieldName := 'roles';
    oTransfer.TitleSource := 'Available roles';
    oTransfer.TitleTarget := 'Assigned roles';
    oTransfer.ShowFilter := True;
    oTransfer.Height := '260px';

    oTransfer.AddItem('admin', 'Administrator');
    oTransfer.AddItem('editor', 'Editor', True);
    oTransfer.AddItem('viewer', 'Viewer');

    WebModule.Response := oTransfer.HTML;   // dual panels + buttons + script
  finally
    oTransfer.Free;
  end;
end;

// Or bind it straight to a dataset:
oTransfer.LoadFromDataSet(qryRoles, 'RoleId', 'RoleName', 'IsAssigned');
// includes: sgcHTML_Component_Transfer.hpp

TsgcHTMLComponent_Transfer *oTransfer = new TsgcHTMLComponent_Transfer(NULL);
try
{
  oTransfer->TransferID = "roles";
  oTransfer->FieldName = "roles";
  oTransfer->TitleSource = "Available roles";
  oTransfer->TitleTarget = "Assigned roles";
  oTransfer->ShowFilter = true;
  oTransfer->Height = "260px";

  oTransfer->AddItem("admin", "Administrator", false);
  oTransfer->AddItem("editor", "Editor", true);
  oTransfer->AddItem("viewer", "Viewer", false);

  String html = oTransfer->HTML;   // dual panels + buttons + script
}
__finally
{
  delete oTransfer;
}
using esegece.sgcWebSockets;

var transfer = new TsgcHTMLComponent_Transfer();
transfer.TransferID = "roles";
transfer.FieldName = "roles";
transfer.TitleSource = "Available roles";
transfer.TitleTarget = "Assigned roles";
transfer.ShowFilter = true;
transfer.Height = "260px";

transfer.AddItem("admin", "Administrator", false);
transfer.AddItem("editor", "Editor", true);
transfer.AddItem("viewer", "Viewer", false);

string html = transfer.HTML;   // dual panels + buttons + script

Belangrijkste eigenschappen en methoden

De members die je het vaakst gebruikt.

Items

Items bevat de rijen, elk een TsgcHTMLTransferItem met Value, Text, Assigned en Disabled.

AddItem

AddItem(aValue, aText, aAssigned) voegt een rij toe en plaatst deze in het bron- of doelpaneel.

LoadFromDataSet

LoadFromDataSet(aDataSet, aValueField, aTextField, aAssignedField) wist Items en vult het opnieuw vanuit een TDataSet.

Paneelbijschriften

TitleSource/TitleTarget labelen de twee panelen; AddCaption/RemoveCaption/AddAllCaption/RemoveAllCaption labelen de vier verplaatsknoppen.

Filtering

ShowFilter voegt een live zoekvak toe aan elk paneel; FilterPlaceholder overschrijft de placeholdertekst.

Terugposten

FieldName stuurt bij het versturen één verborgen invoerveld per toegewezen item; Height begrenst het scrollgebied van elk paneel; TransferID stelt het element-id in.

Blijf ontdekken

Online helpVolledige API-referentie en gebruikshandleiding voor dit onderdeel.
Alle sgcHTML-componentenBlader door de volledige functiematrix van 80+ componenten.
Download gratis proefversieDe proefversie van 30 dagen bevat de 60.HTML-demoprojecten.
PrijzenSingle-, Team- en Site-licenties met volledige broncode.

Klaar om te beginnen?

Download de gratis proefversie en begin met het bouwen van dual-listbox transfer-widgets in Delphi, C++ Builder en .NET.