Componente Transfer — sgcHTML | eSeGeCe

Transfer

TsgcHTMLComponent_Transfer — renderize um widget de transferência com duas listas que move itens entre um painel disponível e um atribuído, com filtro e vinculação a dataset, em Delphi, C++ Builder e .NET.

Visão geral

TsgcHTMLComponent_Transfer

Adicione itens (ou vincule um dataset), permita que o visitante os mova entre os dois painéis com os botões, um duplo clique ou a caixa de filtro, e então leia a propriedade HTML.

Classe do componente

TsgcHTMLComponent_Transfer

Renderiza

Widget de dois painéis Bootstrap 5 + CSS com escopo

Família

Formulários & Entradas

Linguagens

Delphi, C++ Builder, .NET

QuickStart

Adicione itens, defina um nome de campo, renderize

Chame AddItem para cada linha (ou LoadFromDataSet para um dataset inteiro), defina FieldName para que os itens atribuídos sejam enviados de volta como inputs ocultos, e então leia 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

Referência

Principais propriedades & métodos

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

Items

Items contém as linhas, cada uma um TsgcHTMLTransferItem com Value, Text, Assigned e Disabled.

AddItem

AddItem(aValue, aText, aAssigned) adiciona uma linha e a coloca no painel de origem ou destino.

LoadFromDataSet

LoadFromDataSet(aDataSet, aValueField, aTextField, aAssignedField) limpa Items e o repopula a partir de um TDataSet.

Legendas dos painéis

TitleSource/TitleTarget rotulam os dois painéis; AddCaption/RemoveCaption/AddAllCaption/RemoveAllCaption rotulam os quatro botões de mover.

Filtro

ShowFilter adiciona uma caixa de busca em tempo real a cada painel; FilterPlaceholder substitui seu texto de espaço reservado.

Envio no submit

FieldName emite um input oculto por item atribuído no envio; Height limita a área de rolagem de cada painel; TransferID define o id do elemento.

Recursos

Continue explorando

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