Alles wat sgcEditors doet, gegroepeerd per taak, met een link naar het helponderwerp van elke functie. Elk besturingselement bestaat voor VCL, FireMonkey, WinForms, WPF en Avalonia met dezelfde eigenschappen en gebeurtenissen.
17 functies
9 functies
5 functies
2 functies
6 NuGet-pakketten
Online help en pdf-handleidingen
Geregistreerd markeert functies die in de geregistreerde editie en de proefversie zitten, maar niet in de gratis Community-editie. ~ markeert een functie die Community gedeeltelijk heeft, met het verschil eronder.
Elke rij linkt naar het bijbehorende helponderwerp. De kolom Community toont wat de gratis .NET Community-editie bevat; alles zit in Registered en de proefversie.
| Functie | Details | Community | Help |
|---|---|---|---|
| Maandkalender | Enkele datum of bereik, MinDate en MaxDate, uitgeschakelde datums en weekdagen, weeknummers volgens ISO 8601, maand-, jaar- en decenniumweergaven. | Help | |
| Datumkiezer | Datuminvoer met een uitklapkalender en een soepele parser die maandnamen begrijpt. | Help | |
| Tijdkiezer | Tijdinvoer in een native invoerveld. | Help | |
| Datum- en tijdkiezer | Datum en tijd in één besturingselement. | Help | |
| Bereikschuifregelaar | Kies een waarde of een bereik op een schuifregelaar. De tweede schuifknop zit in de geregistreerde editie. | ~Er wordt één handvat getekend en bewerkt; EndValue wordt bewaard maar niet getoond. | Help |
| Kleurkiezer | Kies een kleur. Het HSV-vlak en de alfabalk zitten in de geregistreerde editie. | ~Alleen kleurstalen en hex; het HSV-vierkant en de alfabalk worden niet getekend en de alfa is altijd $FF. | Help |
| Tokenveld | Chips voor tags en ontvangers. De aanvullijst zit in de geregistreerde editie. | ~De chips, validatie en limieten werken; de lijst met automatisch aanvullen opent nooit. | Help |
| Beoordeling | Invoer van een beoordeling met sterren. | Help | |
| Draaiveld | Getalinvoer met muiswiel en automatisch herhalen. | Help | |
| Knopveld | Een native edit met knoppen voor bladeren, uitklappen, zoeken, wissen, plus, min, tekst of zelfgetekende knoppen aan beide kanten, elk met een sneltoets. Schermlezers noemen en bedienen elke knop. | Help | |
| Zoekveld | OnSearch na een pauze in het typen of meteen met Enter, zoek- en wisknoppen en een uitklapbare geschiedenis van eerdere zoekopdrachten. | Help | |
| Maskerveld | Invoermaskers in de EditMask-syntaxis van Delphi of de MaskedTextBox-syntaxis van .NET, gekozen met MaskSyntax, zodat één masker in Delphi en .NET hetzelfde werkt. Een onvolledige waarde wordt aan de validator gemeld. | Help | |
| Valutaveld | Een exacte Currency-waarde (decimal in .NET) met het valutaformaat van de landinstelling, symbool of ISO-code, limieten en groepering tijdens het typen. | Help | |
| Lookupveld | Een uitklaplijst met meerdere kolommen en een optionele koprij, die tijdens het typen filtert, met een sleutelkolom en een weergavekolom. Rijen uit Items, OnGetItems of, in .NET, ItemsSource. | Help | |
| Memo | Een meerregelige editor met thema, met een plaatsaanduiding, een tekenteller met optionele limiet en een hoogte die de regels volgt. | Help | |
| Schakelaar | TsgcVCLToggleSwitch en TsgcFMXToggleSwitch (TsgcWinFormsToggleSwitch, TsgcWpfToggleSwitch en TsgcAvaloniaToggleSwitch in .NET) zijn aan-uitschakelaars voor instellingen: een afgeronde baan met een ronde knop die in ongeveer 150 ms naar de nieuwe stand glijdt, een bijschrift rechts of links (CaptionPosition), de tekst Aan en Uit in de baan (ShowText), ReadOnly, en baan- en knopkleuren die standaard van het thema komen. OnChanging annuleert een wijziging door de gebruiker, OnChange wordt na elke wijziging afgevuurd en Toggle wijzigt de stand zoals de gebruiker dat zou doen. Klik, slepen van de knop, Spatie, Links en Rechts, van rechts naar links en een selectievakje met het Toggle-patroon voor schermlezers. Checked bindt in twee richtingen in WPF en Avalonia. | Help | |
| IP-adresveld | TsgcVCLIPAddressEdit en TsgcFMXIPAddressEdit (TsgcWinFormsIPAddressEdit, TsgcWpfIPAddressEdit en TsgcAvaloniaIPAddressEdit in .NET) nemen een IPv4- of een IPv6-adres (Mode). IPv4 toont vier octetvelden die doorschuiven terwijl de gebruiker typt, begrenst een waarde boven 255 en vult de lege velden met 0 wanneer de focus weggaat. IPv6 is één tekstveld dat gevalideerd en in de canonieke RFC 5952-vorm geschreven wordt wanneer de focus weggaat. Address, Octets, IsValid, Required met het foutkader van het thema, ReadOnly, Clear en OnChange. Plakken van een volledig adres, van rechts naar links en een invoerveld met het Value-patroon voor schermlezers. Address bindt in twee richtingen in WPF en Avalonia. | Help | |
| Tijdsduurveld | TsgcVCLTimeSpanEdit en TsgcFMXTimeSpanEdit (TsgcWinFormsTimeSpanEdit, TsgcWpfTimeSpanEdit en TsgcAvaloniaTimeSpanEdit in .NET) bewerken een tijdsduur in segmenten van dagen tot milliseconden (Segments), als klok of met eenheden (DisplayFormat). Value in milliseconden (een TimeSpan in .NET), MinValue, MaxValue, AllowNegative, Increment, ShowButtons voor de draaiknoppen en ReadOnly. Typen, Omhoog en Omlaag, PageUp en PageDown, het wiel en de draaiknoppen verhogen of verlagen het actieve segment met overloop naar het volgende. Een draaiveld met het RangeValue-patroon voor schermlezers. Value bindt in twee richtingen in WPF en Avalonia. | Help | |
| Lettertypekiezer | TsgcVCLFontPicker en TsgcFMXFontPicker (TsgcWinFormsFontPicker, TsgcWpfFontPicker en TsgcAvaloniaFontPicker in .NET) kiezen een lettertypefamilie uit een keuzelijst die elke naam in het eigen lettertype tekent (ShowPreview, PreviewText), gefilterd terwijl de gebruiker typt. FontName, Fonts gevuld vanuit het platform totdat de applicatie hem vult, RefreshFonts, de laatst gekozen families bovenaan (RecentCount, RecentFonts) en een filter voor vaste breedte (FontFilter). De Delphi-voorbeeldlettertypen worden op Windows getekend. FontName bindt in twee richtingen in WPF en Avalonia. | Help | |
| Selectievakjeslijst | TsgcVCLCheckListBox en TsgcFMXCheckListBox (TsgcWinFormsCheckListBox, TsgcWpfCheckListBox en TsgcAvaloniaCheckListBox in .NET) tonen Items met een selectievakje per rij: Checked, State met een grijze stand (AllowGrayed) en ItemEnabled per item. Een rij Alles selecteren met drie standen (ShowCheckAll), een filtervak dat nooit een stand wijzigt (ShowFilter), CheckAll, UncheckAll, CheckedCount en OnClickCheck vóór OnChange. Alleen de rijen in beeld worden getekend, zodat 10000 items snel blijven. Spatie, Ctrl+A, een letter typen om te springen, en lijstitems met het Toggle-patroon voor schermlezers. | Help | |
| Dubbele lijst | TsgcVCLDualListBox en TsgcFMXDualListBox (TsgcWinFormsDualListBox, TsgcWpfDualListBox en TsgcAvaloniaDualListBox in .NET) verplaatsen items tussen AvailableItems en SelectedItems met de knoppen tussen de lijsten, een dubbelklik of slepen, en herordenen SelectedItems met Omhoog en Omlaag (ShowReorderButtons). SortAvailable, ShowFilter, ShowCaptions, ReadOnly, de methoden MoveToSelected, MoveAllToSelected, MoveToAvailable, MoveAllToAvailable, MoveUp en MoveDown, OnMoving om een item te behouden en één OnChange per bewerking. Meervoudige selectie, verplaatsen met het toetsenbord en van rechts naar links. SelectedItems bindt in twee richtingen in WPF en Avalonia. | Help | |
| NumPad voor aanraakpanelen | TsgcVCLNumPad is een schermtoetsenblok voor cijfers, gedockt op het formulier, en TsgcVCLNumPadPopup opent hetzelfde pad in een uitklapmenu onder zijn doel (TsgcFMXNumPad en TsgcFMXNumPadPopup in FireMonkey, en een NumPad in .NET). Hij typt in het draaiveld, het valutaveld, de knop- en schuifmeters van sgcGauges en een standaard invoerveld, ingesteld met Associate of overgenomen van het besturingselement met de focus. Het pad leest het bereik en de decimalen van het doel en schrijft de waarde als een gebruikerswijziging, met toetsen die groot genoeg zijn voor een vinger of een handschoen. | Help | |
| Schermtoetsenbord | TsgcVCLKeyboard is een volledig schermtoetsenbord, gedockt op het formulier, en TsgcVCLKeyboardPopup opent het in een uitklapmenu onder het invoerveld dat de focus krijgt, met AutoPopup, AutoPopupAll, PopupPosition en CloseOnEnter (TsgcFMXKeyboard en TsgcFMXKeyboardPopup in FireMonkey, TsgcWinFormsKeyboard, TsgcWpfKeyboard en TsgcAvaloniaKeyboard met hun popups in .NET). Het typt in het besturingselement met de focus of in Associate en neemt nooit de focus over. Pagina's voor letters, symbolen en cijfers, Shift, Caps Lock, AltGr en dode toetsen, tien ingebouwde indelingen (en-US, en-GB, es-ES, fr-FR, de-DE, it-IT, pt-BR, nl-NL, pl-PL en tr-TR), eigen indelingen met sgcKeyboardRegisterLayout, een indelingstoets die door Layouts schakelt, thema's, van rechts naar links en toegankelijkheid. OnKeyText wijzigt of annuleert de getypte tekst en OnEnterKey draait na Enter. | Help | |
| Layoutbesturingselement | TsgcVCLLayoutControl en TsgcFMXLayoutControl (in .NET TsgcWinFormsLayoutControl, TsgcWpfLayoutControl en TsgcAvaloniaLayoutControl) rangschikken elk besturingselement, zowel die van sgcEditors als standaardbesturingselementen, in groepen, groepen met tabbladen en kolommen, met bijschriften op één breedte uitgelijnd, splitters die de gebruiker kan slepen, items die de gebruiker kan verbergen en layouts van rechts naar links. Schermlezers zien de groepen en de tabbladen. In elke editie; Delphi Community heeft geen ontwerptijdpakket voor sgcEditors, dus daar wordt het layoutbesturingselement in code aangemaakt. | Help |
| Functie | Details | Community | Help |
|---|---|---|---|
| Gegevensgebonden editors | Datumkiezer, tijdkiezer, draaiveld, beoordeling, bereikschuifregelaar, knopveld, maskerveld, valutaveld, memo en lookupveld binden DataSource en DataField; de bereikschuifregelaar bindt ook EndDataField, en het lookupveld vult zijn lijst via ListSource, KeyField en ListField uit een tweede dataset. Nulvelden verschijnen leeg. Delphi en C++ Builder. | Geregistreerd | Help |
| WinForms-databinding | De WinForms-datum- en tijdkiezers, het draaiveld, de beoordeling, de bereikschuifregelaar en de knop-, masker-, valuta-, lookup- en memo-editors binden een veld via DataSource, DataMember en DataField: een BindingSource, een DataTable, een DataView of een List. | Geregistreerd | Help |
| Lookuplijsten uit elke verzameling | ItemsSource, DisplayMember en ValueMember vullen het lookupveld op WinForms, WPF en Avalonia; SelectedValue en SelectedItem geven de getypeerde objecten terug. | Help | |
| Validatie | De validator van sgcUICore controleert sgcEditors- en standaard besturingselementen aan de hand van regels voor verplicht, bereik, lengte, reguliere expressie, e-mail, vergelijking en aangepaste regels, met een kader, een pictogram, een samenvattingslijst en toegankelijke meldingen, op VCL, FireMonkey, WinForms, WPF en Avalonia. In .NET toont hij ook fouten van IDataErrorInfo en INotifyDataErrorInfo. | Help | |
| Smart Paste | De maandkalender, de datum-, tijd- en datumtijdkiezers, het draaiveld, de beoordeling, het tokenveld, de kleurkiezer, de knop-, masker-, valuta- en lookupvelden en de memo doen mee met Smart Paste. TsgcVCLSmartPaste en TsgcFMXSmartPaste (in .NET TsgcWinFormsSmartPaste, TsgcWpfSmartPaste en TsgcAvaloniaSmartPaste) zetten een geplakte tekst, zoals een e-mail of een adresblok, om in waarden voor de besturingselementen van een formulier, zowel sgcEditors als standaard edit-, combo-, selectievakje- en datumbesturingselementen, met Ongedaan maken en een Smart Paste-knop. Alleen de geplakte tekst en de veldbeschrijvingen worden naar de AI-provider verzonden, en zonder provider leest een lokale parser regels zoals Name: value. | Help | |
| Generator voor gegevensformulieren | TsgcVCLDataForm en TsgcFMXDataForm bouwen op het layoutbesturingselement een compleet bewerkformulier uit een TDataSet, met per veld één sgcEditors-besturingselement dat op zijn type wordt gekozen, of uit de published-eigenschappen van een klasse via RTTI met BindObject. In .NET nemen TsgcWinFormsDataForm, TsgcWpfDataForm en TsgcAvaloniaDataForm een DataTable, een DataView, een lijst of één enkel object. Fields bepaalt het bijschrift, het soort, de groep, het tabblad en de volgorde van elk veld, en een navigator voegt eerste, vorige, volgende, laatste, nieuw, bewerken, verwijderen, opslaan en annuleren toe. Delphi, C++ Builder en .NET. | Geregistreerd | Help |
| Validatie van het gegevensformulier | Elk veld wordt regels van de validator van sgcUICore: verplicht, bereik, lengte, reguliere expressie en e-mail, plus OnValidateField voor je eigen controles. Post valideert eerst het record, een samenvatting toont de fouten, en een ongeldig veld op een tabblad dat niet zichtbaar is selecteert dat tabblad. | Geregistreerd | Help |
| Smart Paste van het gegevensformulier | SmartPaste, SmartPasteAsync en SmartPasteFromClipboard, ook een knop van de navigator, vullen elk veld van het record uit een geplakte tekst via de AI-laag die de editors voor hun eigen Smart Paste gebruiken. De ingevulde velden tonen een AI-badge, en SmartPasteUndo zet de oude waarden terug. Zonder provider leest een lokale parser regels zoals Name: value. | Geregistreerd | Help |
| Layouts opgeslagen als JSON | SaveLayout en LoadLayout bewaren de volgorde, de ouder, de afmetingen en de zichtbaarheid van elk item, het actieve tabblad van elke groep met tabbladen en de items die de gebruiker heeft verborgen, als JSON, naar een string, een stream of een bestand. Een layout die een oudere build heeft opgeslagen, laadt in een nieuwere. | Help |
| Functie | Details | Community | Help |
|---|---|---|---|
| Echte tekstinvoer | Datum-, tijd-, getal- en hexvelden zijn native invoervelden, dus IME, klembord, ongedaan maken en schermlezers werken. | Help | |
| Lokalisatie | Elk besturingselement heeft zijn eigen landinstelling: dag- en maandnamen, notaties, eerste dag van de week, per besturingselement FormatSettings. | Help | |
| Toetsenbord | F4 of Alt+Pijl-omlaag voor dropdowns, pijlen en PageUp en PageDown in de kalender, muiswiel en automatisch herhalen in het draaiveld, een sneltoets voor elke editknop, focusring. | Help | |
| DPI per monitor | Indeling in logische pixels bij 96 DPI, geschaald per monitor, waarbij de uitklaplijst wordt getekend met de DPI van zijn monitor. | Help | |
| Rechts naar links (Arabisch en Hebreeuws) | Draai-, uitklap- en wisknoppen verhuizen naar de andere kant, de richting van schuifregelaar en beoordeling, de volgorde van weekdagen in de kalender, pijlen en tokenstroom zijn gespiegeld, en het binnenste invoerveld krijgt dezelfde richting. | Help | |
| Schermlezers en hoog contrast | Elke editor stelt zijn rol, naam en waarde beschikbaar aan UI Automation, samen met de onderdelen van de samengestelde editors (datumdelen, tokens, beoordelingssterren, kleur, editknoppen, de lookuplijst) en hun pop-ups zolang ze open zijn, en een ongeldig veld meldt zijn status en zijn foutmelding. De focusring is altijd zichtbaar en het hoge contrast van Windows wordt gevolgd. Standaard aan op VCL (Delphi 7 tot 13), FireMonkey op Windows, WinForms, WPF en Avalonia. | Help |
| Functie | Details | Community | Help |
|---|---|---|---|
| Thema's | Lichte en donkere thema's met één eigenschap, plus AccentColor, TextStyle en een foutkleur voor validatie. | Help | |
| Headless renderen | SaveToPNG en SaveToSVG op elk besturingselement en op de headless modellen, ook op Linux64. Het knop-, zoek-, masker-, valuta- en lookupveld en de memo behouden hun waardetekst in PNG, SVG en op afgedrukte of in het voorbeeld getoonde pagina's. | Help |
| Taak | Standaard Delphi-besturingselementen | sgcEditors |
|---|---|---|
| Een datum of tijd kiezen uit een dropdown | TDateTimePicker | TsgcVCLDatePicker, TsgcVCLTimePicker |
| Datum en tijd in één besturingselement | TDateTimePicker | TsgcVCLDateTimePicker |
| Een bereik van dagen selecteren met een maximale lengte | TMonthCalendar | esmRange, MaxRangeDays |
| Losse datums en weekdagen blokkeren | TMonthCalendar | DisabledDates, DisabledWeekDays, OnIsDateDisabled |
| Een locale per besturingselement | TDateTimePicker | FormatSettings |
| Maskerinvoer met de masker-syntaxis van Delphi of .NET | TMaskEdit | TsgcVCLMaskEdit, MaskSyntax |
| Een rij kiezen uit een lijst met meerdere kolommen | TDBLookupComboBox | TsgcVCLLookupEdit, TsgcVCLDBLookupEdit |
| Een edit met knoppen | TButtonedEdit | TsgcVCLButtonEdit |
| Een getal typen op een aanraakpaneel | TTouchKeyboard | TsgcVCLNumPad, TsgcVCLNumPadPopup |
| Tekst typen op een aanraakscherm | TTouchKeyboard | TsgcVCLKeyboard, TsgcVCLKeyboardPopup |
| Een aan-uitschakelaar voor instellingen | TToggleSwitch | TsgcVCLToggleSwitch |
| Een IPv4- of een IPv6-adres bewerken | TMaskEdit | TsgcVCLIPAddressEdit |
| Een tijdsduur zoals een time-out invoeren | TSpinEdit | TsgcVCLTimeSpanEdit |
| Een lettertypefamilie kiezen met een voorbeeld | TComboBox met Screen.Fonts, TFontDialog | TsgcVCLFontPicker |
| Een lijst met opties met selectievakjes | TCheckListBox | TsgcVCLCheckListBox |
| Items tussen twee lijsten verplaatsen | Twee TListBox-besturingselementen en knoppen | TsgcVCLDualListBox |
Alleen mogelijkheden, zoals beschreven in de help. Geen prestatieclaims.
De .NET-editors zijn een C#-port met dezelfde namen en gebeurtenissen, voor WinForms, WPF en Avalonia. In WPF zijn de waarde-eigenschappen afhankelijkheidseigenschappen die in twee richtingen binden. Het lookupveld neemt ItemsSource, DisplayMember en ValueMember op elke host, en in de editie Registered binden de WinForms-editors een veld via DataSource, DataMember en DataField.
| Pakket | Editie | Inhoud |
|---|---|---|
esegece.sgcEditors.Community | Community (gratis) | Kernbibliotheek |
esegece.sgcEditors.WinForms.Community | Community (gratis) | Windows Forms-besturingselementen |
esegece.sgcEditors.Wpf.Community | Community (gratis) | WPF-besturingselementen |
esegece.sgcEditors.Avalonia.Community | Community (gratis) | Avalonia-besturingselementen |
esegece.sgcEditors.Rendering.Community | Community (gratis) | Headless renderen |
esegece.sgcEditors | Geregistreerd | Kernbibliotheek |
esegece.sgcEditors.WinForms | Geregistreerd | Windows Forms-besturingselementen |
esegece.sgcEditors.Wpf | Geregistreerd | WPF-besturingselementen |
esegece.sgcEditors.Avalonia | Geregistreerd | Avalonia-besturingselementen |
esegece.sgcEditors.Rendering | Geregistreerd | Headless renderen |
Elke functie van sgcEditors is beschreven in de sgcUI-help, met één build voor elke ontwikkelomgeving.
Begin met de introductie van sgcEditors en volg daarna de snelstart en de functieonderwerpen.
Delphi →De volledige sgcUI-help als pdf-bestand, om offline te lezen of af te drukken.
Delphi (PDF) →