Auf einen Blick

TsgcHTMLComponent_Select

Ein Dropdown, das ein beschriftetes Bootstrap-form-select ausgibt. Fügen Sie Optionen hinzu (oder binden Sie ein Dataset), gruppieren Sie sie optional und erlauben Sie Mehrfachauswahl, und lesen Sie dann die HTML-Eigenschaft.

Komponentenklasse

TsgcHTMLComponent_Select

Rendert

Bootstrap-5-form-select

Familie

Formulare & Eingaben

Sprachen

Delphi, C++ Builder, .NET

QuickStart

Erstellen, Optionen hinzufügen, rendern

Setzen Sie Name, Label_ und ein Placeholder, fügen Sie Optionen mit AddOption (oder AddOptionGroup) hinzu und lesen Sie dann HTML (oder fügen Sie es in eine TsgcHTMLTemplate_Bootstrap-Seite ein).

uses
  sgcHTML_Enums, sgcHTML_Component_Select;

var
  oSelect: TsgcHTMLComponent_Select;
begin
  oSelect := TsgcHTMLComponent_Select.Create(nil);
  try
    oSelect.Name := 'country';
    oSelect.Label_ := 'Country';
    oSelect.Placeholder := 'Select a country';
    oSelect.Size := ssLarge;

    oSelect.AddOption('es', 'Spain', True);
    oSelect.AddOption('fr', 'France');
    oSelect.AddOptionGroup('Americas', 'us', 'United States');

    WebModule.Response := oSelect.HTML;   // Bootstrap form-select
  finally
    oSelect.Free;
  end;
end;

// Or fill it straight from a dataset:
oSelect.LoadFromDataSet(qryCountries, 'Code', 'Name', 'Region');

// includes: sgcHTML_Enums.hpp, sgcHTML_Component_Select.hpp

TsgcHTMLComponent_Select *oSelect = new TsgcHTMLComponent_Select(NULL);
try
{
  oSelect->Name = "country";
  oSelect->Label_ = "Country";
  oSelect->Placeholder = "Select a country";
  oSelect->Size = ssLarge;

  oSelect->AddOption("es", "Spain", true);
  oSelect->AddOption("fr", "France");
  oSelect->AddOptionGroup("Americas", "us", "United States");

  String html = oSelect->HTML;   // Bootstrap form-select
}
__finally
{
  delete oSelect;
}

using esegece.sgcWebSockets;

var select = new TsgcHTMLComponent_Select();
select.Name = "country";
select.Label_ = "Country";
select.Placeholder = "Select a country";
select.Size = TsgcHTMLSelectSize.ssLarge;

select.AddOption("es", "Spain", true);
select.AddOption("fr", "France");
select.AddOptionGroup("Americas", "us", "United States");

string html = select.HTML;   // Bootstrap form-select

Referenz

Wichtige Eigenschaften & Methoden

Die Member, die Sie am häufigsten verwenden.

Optionen

Options ist eine Sammlung von TsgcHTMLSelectOption (jeweils mit Value, Text, Selected, Disabled und Group); die Komfortmethoden AddOption(value, text, selected) und AddOptionGroup(group, value, text) befüllen sie.

Identität

Name setzt den Feldnamen, Label_ die Beschriftung, Placeholder eine deaktivierte führende Option und SelectID die Element-id (Standard sel_<Name>).

Auswahlmodus

Multiple macht daraus eine Mehrfachauswahlliste und VisibleItems legt fest, wie viele Zeilen gleichzeitig angezeigt werden (das size-Attribut).

Größenanpassung

Size ist ein TsgcHTMLSelectSize — ssDefault, ssSmall oder ssLarge.

Dataset-Bindung

LoadFromDataSet(aDataSet, aValueField, aTextField, aGroupField) füllt die Optionen aus einer Abfrage und baut <optgroup>s, wenn ein Gruppenfeld angegeben ist; weisen Sie DataSource für Live-Aktualisierung zu.

Zustand & Ausgabe

Required und Disabled markieren das Steuerelement; HTML gibt das beschriftete <select> mit allen Optionen und optgroups zurück.

Ressourcen

Weiter entdecken

	Alle sgcHTML-KomponentenDurchsuchen Sie die vollständige Funktionsmatrix von über 60 Komponenten.	Öffnen
	Kostenlose Testversion herunterladenDie 30-Tage-Testversion enthält die 60.HTML-Demoprojekte.	Öffnen
	PreiseSingle-, Team- und Site-Lizenzen mit vollständigem Quellcode.	Öffnen

Select