sgcEditors Feature-Matrix
Alles, was sgcEditors kann, nach Aufgabe gruppiert, mit einem Link zum Hilfethema jeder Funktion. Jedes Steuerelement gibt es für VCL, FireMonkey, WinForms, WPF und Avalonia mit denselben Eigenschaften und Ereignissen.
Alles, was sgcEditors kann, nach Aufgabe gruppiert, mit einem Link zum Hilfethema jeder Funktion. Jedes Steuerelement gibt es für VCL, FireMonkey, WinForms, WPF und Avalonia mit denselben Eigenschaften und Ereignissen.
17 Funktionen
9 Funktionen
5 Funktionen
2 Funktionen
6 NuGet-Pakete
Online-Hilfe und PDF-Handbücher
Registered kennzeichnet die Features, die in den Editionen Registered und Testversion enthalten sind, aber nicht in der kostenlosen Community Edition. ~ kennzeichnet ein Feature, das Community nur teilweise enthält, mit dem Unterschied darunter.
Jede Zeile verlinkt auf ihr Hilfethema. Die Spalte Community zeigt, was die kostenlose .NET Community Edition enthält, alles ist in Registered und in der Testversion enthalten.
| Funktion | Details | Community | Hilfe |
|---|---|---|---|
| Monatskalender | Einzelnes Datum oder Bereich, MinDate und MaxDate, deaktivierte Tage und Wochentage, Kalenderwochen nach ISO 8601, Monats-, Jahres- und Jahrzehntansicht. | Hilfe | |
| Datumsauswahl | Datumseingabe mit aufklappbarem Kalender und einem toleranten Parser, der Monatsnamen versteht. | Hilfe | |
| Zeitauswahl | Zeiteingabe in einem nativen Eingabefeld. | Hilfe | |
| Datum-Zeit-Auswahl | Datum und Uhrzeit in einem Steuerelement. | Hilfe | |
| Bereichsschieberegler | Einen Wert oder einen Bereich auf einem Schieberegler wählen. Der zweite Schiebereglerknopf ist in der registrierten Edition enthalten. | ~Ein Regler wird gezeichnet und bearbeitet, EndValue wird beibehalten, aber nicht angezeigt. | Hilfe |
| Farbauswahl | Eine Farbe wählen. Das HSV-Quadrat und die Alphaleiste sind in der registrierten Edition enthalten. | ~Nur Farbfelder und Hex, das HSV-Quadrat und die Alphaleiste werden nicht gezeichnet, und Alpha ist immer $FF. | Hilfe |
| Token-Eingabe | Chips für Tags und Empfänger. Die Autovervollständigungsliste ist in der registrierten Edition enthalten. | ~Chips, Validierung und Limits funktionieren, die Autovervollständigungsliste öffnet sich nie. | Hilfe |
| Bewertung | Eingabe einer Sternebewertung. | Hilfe | |
| Spin-Eingabe | Zahleneingabe mit Mausrad und automatischer Wiederholung. | Hilfe | |
| Button-Eingabe | Ein natives Edit mit Buttons zum Durchsuchen, Aufklappen, Suchen, Löschen, Plus, Minus, mit Text oder selbst gezeichnet auf beiden Seiten, jeder mit einer Tastenkombination. Screenreader nennen und drücken jeden Button. | Hilfe | |
| Such-Eingabe | OnSearch nach einer Tipppause oder sofort mit Enter, Such- und Löschen-Buttons und ein aufklappbarer Verlauf früherer Suchen. | Hilfe | |
| Masken-Eingabe | Eingabemasken in der EditMask-Syntax von Delphi oder der MaskedTextBox-Syntax von .NET, gewählt über MaskSyntax, sodass eine Maske in Delphi und .NET gleich funktioniert. Ein unvollständiger Wert wird an den Validator gemeldet. | Hilfe | |
| Währungs-Eingabe | Ein exakter Currency-Wert (decimal in .NET) mit dem Währungsformat des Gebietsschemas, Symbol oder ISO-Code, Grenzen und Gruppierung während der Eingabe. | Hilfe | |
| Lookup-Eingabe | Eine mehrspaltige Auswahlliste mit optionaler Kopfzeile, die beim Tippen filtert, mit einer Schlüsselspalte und einer Anzeigespalte. Zeilen aus Items, OnGetItems oder in .NET aus ItemsSource. | Hilfe | |
| Memo | Ein mehrzeiliger Editor mit Theme, einem Platzhalter, einem Zeichenzähler mit optionalem Limit und einer Höhe, die den Zeilen folgt. | Hilfe | |
| Kippschalter | TsgcVCLToggleSwitch und TsgcFMXToggleSwitch (TsgcWinFormsToggleSwitch, TsgcWpfToggleSwitch und TsgcAvaloniaToggleSwitch in .NET) sind Ein/Aus-Schalter für Einstellungen: eine abgerundete Spur mit einem runden Schieber, der in etwa 150 ms in den neuen Zustand gleitet, eine Beschriftung rechts oder links (CaptionPosition), der Text Ein und Aus in der Spur (ShowText), ReadOnly sowie Spur- und Schieberfarben, die standardmäßig vom Theme kommen. OnChanging bricht eine Änderung durch den Benutzer ab, OnChange wird nach jeder Änderung ausgelöst, und Toggle ändert den Zustand wie der Benutzer. Klick, Ziehen des Schiebers, Leertaste, Links und Rechts, Rechts-nach-links und eine Checkbox mit dem Toggle-Pattern für Screenreader. Checked bindet in WPF und Avalonia in beide Richtungen. | Hilfe | |
| IP-Adress-Eingabe | TsgcVCLIPAddressEdit und TsgcFMXIPAddressEdit (TsgcWinFormsIPAddressEdit, TsgcWpfIPAddressEdit und TsgcAvaloniaIPAddressEdit in .NET) nehmen eine IPv4- oder eine IPv6-Adresse an (Mode). IPv4 zeigt vier Oktettfelder, die beim Tippen weiterspringen, einen Wert über 255 begrenzen und die leeren Felder mit 0 füllen, wenn der Fokus das Steuerelement verlässt; IPv6 ist ein Textfeld, das validiert und beim Verlassen des Fokus in der kanonischen Form nach RFC 5952 geschrieben wird. Address, Octets, IsValid, Required mit dem Fehlerrahmen des Themes, ReadOnly, Clear und OnChange. Einfügen einer vollständigen Adresse, rechts nach links und ein Edit mit dem Value-Pattern für Screenreader. Address ist in WPF und Avalonia in beide Richtungen gebunden. | Hilfe | |
| Zeitspannen-Eingabe | TsgcVCLTimeSpanEdit und TsgcFMXTimeSpanEdit (TsgcWinFormsTimeSpanEdit, TsgcWpfTimeSpanEdit und TsgcAvaloniaTimeSpanEdit in .NET) bearbeiten eine Dauer in Segmenten von Tagen bis Millisekunden (Segments), als Uhr oder mit Einheiten (DisplayFormat). Value in Millisekunden (ein TimeSpan in .NET), MinValue, MaxValue, AllowNegative, Increment, ShowButtons für die Spin-Buttons und ReadOnly. Tippen, Hoch und Runter, Bild auf und Bild ab, das Mausrad und die Spin-Buttons ändern das fokussierte Segment mit Übertrag in das nächste. Ein Spinner mit dem RangeValue-Pattern für Screenreader. Value ist in WPF und Avalonia in beide Richtungen gebunden. | Hilfe | |
| Schriftartauswahl | TsgcVCLFontPicker und TsgcFMXFontPicker (TsgcWinFormsFontPicker, TsgcWpfFontPicker und TsgcAvaloniaFontPicker in .NET) wählen eine Schriftfamilie aus einer Dropdown-Liste, die jeden Namen in seiner eigenen Schrift zeichnet (ShowPreview, PreviewText) und beim Tippen gefiltert wird. FontName, Fonts, von der Plattform gefüllt, bis die Anwendung die Liste füllt, RefreshFonts, die zuletzt gewählten Familien zuerst (RecentCount, RecentFonts) und ein Filter für feste Zeichenbreite (FontFilter). Die Vorschau-Schriften von Delphi werden unter Windows gezeichnet. FontName ist in WPF und Avalonia in beide Richtungen gebunden. | Hilfe | |
| Checkbox-Liste | TsgcVCLCheckListBox und TsgcFMXCheckListBox (TsgcWinFormsCheckListBox, TsgcWpfCheckListBox und TsgcAvaloniaCheckListBox in .NET) listen Items mit einer Checkbox pro Zeile auf: Checked, State mit einem grauen Zustand (AllowGrayed) und ItemEnabled pro Eintrag. Eine Zeile Alle auswählen mit drei Zuständen (ShowCheckAll), ein Filterfeld, das nie einen Zustand ändert (ShowFilter), CheckAll, UncheckAll, CheckedCount und OnClickCheck vor OnChange. Es werden nur die sichtbaren Zeilen gezeichnet, sodass 10000 Einträge schnell bleiben. Leertaste, Strg+A, einen Buchstaben tippen zum Springen und Listeneinträge mit dem Toggle-Pattern für Screenreader. | Hilfe | |
| Dual-Listbox | TsgcVCLDualListBox und TsgcFMXDualListBox (TsgcWinFormsDualListBox, TsgcWpfDualListBox und TsgcAvaloniaDualListBox in .NET) verschieben Einträge zwischen AvailableItems und SelectedItems mit den Schaltflächen zwischen den Listen, per Doppelklick oder per Drag and Drop und ordnen SelectedItems mit Auf und Ab um (ShowReorderButtons). SortAvailable, ShowFilter, ShowCaptions, ReadOnly, die Methoden MoveToSelected, MoveAllToSelected, MoveToAvailable, MoveAllToAvailable, MoveUp und MoveDown, OnMoving, um einen Eintrag zu behalten, und ein OnChange pro Vorgang. Mehrfachauswahl, Verschieben per Tastatur und rechts nach links. SelectedItems ist in WPF und Avalonia in beide Richtungen gebunden. | Hilfe | |
| NumPad für Touch-Panels | TsgcVCLNumPad ist ein Bildschirm-Ziffernblock, der auf dem Formular angedockt ist, und TsgcVCLNumPadPopup öffnet dasselbe Pad als Dropdown unter seinem Ziel (TsgcFMXNumPad und TsgcFMXNumPadPopup in FireMonkey und ein NumPad in .NET). Es gibt eine Zahl in das Spin-Edit, das Currency-Edit, die Knob- und Slider-Gauges von sgcGauges und ein Standard-Edit ein, gesetzt mit Associate oder vom fokussierten Steuerelement übernommen. Das Pad liest den Bereich und die Dezimalstellen des Ziels und schreibt den Wert als Benutzeränderung, mit Tasten, die für einen Finger oder einen Handschuh groß genug sind. | Hilfe | |
| Bildschirmtastatur | TsgcVCLKeyboard ist eine vollständige Bildschirmtastatur, die auf dem Formular angedockt ist, und TsgcVCLKeyboardPopup öffnet sie als Dropdown unter dem Edit, das den Fokus bekommt, mit AutoPopup, AutoPopupAll, PopupPosition und CloseOnEnter (TsgcFMXKeyboard und TsgcFMXKeyboardPopup in FireMonkey, TsgcWinFormsKeyboard, TsgcWpfKeyboard und TsgcAvaloniaKeyboard mit ihren Popups in .NET). Sie schreibt in das fokussierte Steuerelement oder in Associate und nimmt nie den Fokus. Seiten für Buchstaben, Symbole und Zahlen, Umschalt-, Feststell- und AltGr-Taste und Tottasten, zehn eingebaute Belegungen (en-US, en-GB, es-ES, fr-FR, de-DE, it-IT, pt-BR, nl-NL, pl-PL und tr-TR), eigene Belegungen mit sgcKeyboardRegisterLayout, eine Belegungstaste, die durch Layouts schaltet, Themes, Rechts-nach-links und Barrierefreiheit. OnKeyText ändert oder bricht den getippten Text ab, und OnEnterKey läuft nach der Eingabetaste. | Hilfe | |
| Layout-Steuerelement | TsgcVCLLayoutControl und TsgcFMXLayoutControl (unter .NET TsgcWinFormsLayoutControl, TsgcWpfLayoutControl und TsgcAvaloniaLayoutControl) ordnen beliebige Steuerelemente an, sgcEditors und Standard-Steuerelemente gleichermaßen, in Gruppen, Gruppen mit Registerkarten und Spalten, mit auf eine Breite ausgerichteten Beschriftungen, Teilern, die der Benutzer ziehen kann, Elementen, die der Benutzer ausblenden kann, und Rechts-nach-links-Layouts. Screenreader erkennen die Gruppen und die Registerkarten. In jeder Edition; Delphi Community hat kein Design-Time-Paket für sgcEditors, daher wird das Layout-Steuerelement dort im Code erzeugt. | Hilfe |
| Funktion | Details | Community | Hilfe |
|---|---|---|---|
| Datensensitive Editoren | Datumsauswahl, Zeitauswahl, Spin-Eingabe, Bewertung, Bereichsschieberegler, Button-Eingabe, Masken-Eingabe, Währungs-Eingabe, Memo und Lookup-Eingabe binden DataSource und DataField; der Bereichsschieberegler bindet auch EndDataField, und die Lookup-Eingabe füllt ihre Liste über ListSource, KeyField und ListField aus einem zweiten Dataset. Null-Felder erscheinen leer. Delphi und C++ Builder. | Registriert | Hilfe |
| WinForms-Datenbindung | Die WinForms-Auswahlfelder für Datum und Zeit, die Spin-Eingabe, die Bewertung, der Bereichsschieberegler und die Button-, Masken-, Währungs-, Lookup- und Memo-Editoren binden ein Feld über DataSource, DataMember und DataField: ein BindingSource, eine DataTable, eine DataView oder eine List. | Registriert | Hilfe |
| Lookup-Listen aus jeder Auflistung | ItemsSource, DisplayMember und ValueMember füllen die Lookup-Eingabe unter WinForms, WPF und Avalonia; SelectedValue und SelectedItem liefern die typisierten Objekte zurück. | Hilfe | |
| Validierung | Der Validator von sgcUICore prüft sgcEditors- und Standard-Steuerelemente gegen Regeln für Pflichtfeld, Bereich, Länge, regulären Ausdruck, E-Mail, Vergleich und benutzerdefinierte Regeln, mit Rahmen, Symbol, Zusammenfassungsliste und barrierefreien Meldungen, unter VCL, FireMonkey, WinForms, WPF und Avalonia. In .NET zeigt er auch Fehler von IDataErrorInfo und INotifyDataErrorInfo an. | Hilfe | |
| Smart Paste | Der Monatskalender, die Datums-, Zeit- und Datum-Zeit-Auswahl, die Spin-Eingabe, die Bewertung, die Token-Eingabe, die Farbauswahl, die Button-, Masken-, Währungs- und Lookup-Eingabe und das Memo nehmen an Smart Paste teil. TsgcVCLSmartPaste und TsgcFMXSmartPaste (unter .NET TsgcWinFormsSmartPaste, TsgcWpfSmartPaste und TsgcAvaloniaSmartPaste) verwandeln einen eingefügten Text, etwa eine E-Mail oder einen Adressblock, in Werte für die Steuerelemente eines Formulars, sgcEditors und Standard-Steuerelemente für Eingabe, Kombinationsfeld, Kontrollkästchen und Datum gleichermaßen, mit Rückgängig und einer Smart-Paste-Schaltfläche. An den KI-Anbieter werden nur der eingefügte Text und die Feldbeschreibungen gesendet, und ohne Anbieter liest ein lokaler Parser Zeilen wie Name: value. | Hilfe | |
| Datenformular-Generator | TsgcVCLDataForm und TsgcFMXDataForm erstellen auf dem Layout-Steuerelement ein vollständiges Bearbeitungsformular aus einem TDataSet, mit einem sgcEditors-Steuerelement pro Feld, gewählt nach dem Feldtyp, oder aus den published-Eigenschaften einer Klasse per RTTI mit BindObject. Unter .NET nehmen TsgcWinFormsDataForm, TsgcWpfDataForm und TsgcAvaloniaDataForm eine DataTable, eine DataView, eine Liste oder ein einzelnes Objekt entgegen. Fields legt Beschriftung, Art, Gruppe, Registerkarte und Reihenfolge jedes Feldes fest, und ein Navigator bietet erster, vorheriger, nächster, letzter, neu, bearbeiten, löschen, speichern und abbrechen. Delphi, C++ Builder und .NET. | Registriert | Hilfe |
| Validierung des Datenformulars | Jedes Feld wird zu Regeln des Validators von sgcUICore: Pflichtfeld, Bereich, Länge, regulärer Ausdruck und E-Mail, dazu OnValidateField für eigene Prüfungen. Post validiert zuerst den Datensatz, eine Zusammenfassung listet die Fehler auf, und ein ungültiges Feld auf einer nicht sichtbaren Registerkarte wählt diese Registerkarte aus. | Registriert | Hilfe |
| Smart Paste im Datenformular | SmartPaste, SmartPasteAsync und SmartPasteFromClipboard, auch eine Schaltfläche des Navigators, füllen alle Felder des Datensatzes aus einem eingefügten Text über die KI-Schicht, die die Editoren für ihr eigenes Smart Paste verwenden. Die ausgefüllten Felder zeigen ein KI-Symbol, und SmartPasteUndo stellt die alten Werte wieder her. Ohne Provider liest ein lokaler Parser Zeilen wie Name: value. | Registriert | Hilfe |
| Als JSON gespeicherte Layouts | SaveLayout und LoadLayout sichern Reihenfolge, Elternelement, Größen und Sichtbarkeit jedes Elements, die aktive Registerkarte jeder Registerkartengruppe und die vom Benutzer ausgeblendeten Elemente als JSON, in einen String, einen Stream oder eine Datei. Ein Layout, das ein älterer Build gespeichert hat, lässt sich in einem neueren laden. | Hilfe |
| Funktion | Details | Community | Hilfe |
|---|---|---|---|
| Echte Texteingabe | Felder für Datum, Zeit, Zahlen und Hexwerte sind native Eingabefelder, daher funktionieren IME, Zwischenablage, Rückgängig und Screenreader. | Hilfe | |
| Lokalisierung | Jedes Steuerelement trägt sein eigenes Gebietsschema: Tages- und Monatsnamen, Formate, erster Wochentag, FormatSettings pro Steuerelement. | Hilfe | |
| Tastatur | F4 oder Alt+Pfeil unten für Dropdowns, Pfeiltasten sowie Bild auf und Bild ab im Kalender, Mausrad und automatische Wiederholung in der Spin-Eingabe, eine Tastenkombination für jeden Edit-Button, Fokusrahmen. | Hilfe | |
| DPI pro Monitor | Layout in logischen Pixeln bei 96 DPI, pro Monitor skaliert, wobei das Dropdown mit der DPI seines Monitors gezeichnet wird. | Hilfe | |
| Rechts nach links (Arabisch und Hebräisch) | Spin-, Dropdown- und Löschen-Schaltflächen wechseln die Seite; Richtung von Schieberegler und Bewertung, Reihenfolge der Wochentage im Kalender, Pfeile und Token-Fluss sind gespiegelt, und das innere Eingabefeld erhält dieselbe Richtung. | Hilfe | |
| Screenreader und hoher Kontrast | Jeder Editor stellt UI Automation seine Rolle, seinen Namen und seinen Wert bereit, zusammen mit den Teilen der zusammengesetzten Editoren (Datumsteile, Tokens, Bewertungssterne, Farbe, Edit-Buttons, die Lookup-Liste) und ihren Popups, solange sie geöffnet sind, und ein ungültiges Feld meldet seinen Zustand und seine Fehlermeldung. Der Fokusrahmen ist immer sichtbar, und der hohe Kontrast von Windows wird befolgt. Standardmäßig aktiv unter VCL (Delphi 7 bis 13), FireMonkey unter Windows, WinForms, WPF und Avalonia. | Hilfe |
| Funktion | Details | Community | Hilfe |
|---|---|---|---|
| Themes | Helle und dunkle Themes mit einer Eigenschaft, dazu AccentColor, TextStyle und eine Fehlerfarbe für die Validierung. | Hilfe | |
| Headless-Rendering | SaveToPNG und SaveToSVG an jedem Steuerelement und an den Headless-Modellen, auch unter Linux64. Die Button-, Such-, Masken-, Währungs- und Lookup-Eingabe und das Memo behalten ihren Werttext in PNG, SVG und in gedruckten oder in der Vorschau gezeigten Seiten. | Hilfe |
| Aufgabe | Standard-Steuerelemente von Delphi | sgcEditors |
|---|---|---|
| Ein Datum oder eine Zeit aus einem Dropdown wählen | TDateTimePicker | TsgcVCLDatePicker, TsgcVCLTimePicker |
| Datum und Zeit in einem Steuerelement | TDateTimePicker | TsgcVCLDateTimePicker |
| Einen Tagesbereich mit maximaler Länge wählen | TMonthCalendar | esmRange, MaxRangeDays |
| Einzelne Daten und Wochentage sperren | TMonthCalendar | DisabledDates, DisabledWeekDays, OnIsDateDisabled |
| Ein Locale pro Steuerelement | TDateTimePicker | FormatSettings |
| Maskierte Eingabe mit der Maskensyntax von Delphi oder .NET | TMaskEdit | TsgcVCLMaskEdit, MaskSyntax |
| Eine Zeile aus einer mehrspaltigen Liste wählen | TDBLookupComboBox | TsgcVCLLookupEdit, TsgcVCLDBLookupEdit |
| Ein Edit mit Buttons | TButtonedEdit | TsgcVCLButtonEdit |
| Eine Zahl auf einem Touch-Panel eingeben | TTouchKeyboard | TsgcVCLNumPad, TsgcVCLNumPadPopup |
| Text auf einem Touch-Screen eingeben | TTouchKeyboard | TsgcVCLKeyboard, TsgcVCLKeyboardPopup |
| Ein Ein/Aus-Schalter für Einstellungen | TToggleSwitch | TsgcVCLToggleSwitch |
| Eine IPv4- oder IPv6-Adresse bearbeiten | TMaskEdit | TsgcVCLIPAddressEdit |
| Eine Dauer wie ein Timeout eingeben | TSpinEdit | TsgcVCLTimeSpanEdit |
| Eine Schriftfamilie mit Vorschau wählen | TComboBox mit Screen.Fonts, TFontDialog | TsgcVCLFontPicker |
| Eine Liste von Optionen mit Checkboxen | TCheckListBox | TsgcVCLCheckListBox |
| Einträge zwischen zwei Listen verschieben | Zwei TListBox-Steuerelemente und Schaltflächen | TsgcVCLDualListBox |
Nur Fähigkeiten, wie in der Hilfe dokumentiert. Keine Leistungsversprechen.
Die .NET-Editoren sind ein C#-Port mit denselben Namen und Ereignissen, für WinForms, WPF und Avalonia. In WPF sind die Werteigenschaften Abhängigkeitseigenschaften, die in beide Richtungen binden. Die Lookup-Eingabe nimmt ItemsSource, DisplayMember und ValueMember auf jedem Host, und in der Edition Registered binden die WinForms-Editoren ein Feld über DataSource, DataMember und DataField.
| Paket | Edition | Inhalt |
|---|---|---|
esegece.sgcEditors.Community | Community (kostenlos) | Kernbibliothek |
esegece.sgcEditors.WinForms.Community | Community (kostenlos) | Windows-Forms-Steuerelemente |
esegece.sgcEditors.Wpf.Community | Community (kostenlos) | WPF-Steuerelemente |
esegece.sgcEditors.Avalonia.Community | Community (kostenlos) | Avalonia-Steuerelemente |
esegece.sgcEditors.Rendering.Community | Community (kostenlos) | Headless-Rendering |
esegece.sgcEditors | Registered | Kernbibliothek |
esegece.sgcEditors.WinForms | Registered | Windows-Forms-Steuerelemente |
esegece.sgcEditors.Wpf | Registered | WPF-Steuerelemente |
esegece.sgcEditors.Avalonia | Registered | Avalonia-Steuerelemente |
esegece.sgcEditors.Rendering | Registered | Headless-Rendering |
Jede Funktion von sgcEditors ist in der sgcUI-Hilfe dokumentiert, mit je einer Ausgabe für jede Entwicklungsumgebung.
Beginne mit der Einführung zu sgcEditors, und folge dann der Schnellstartanleitung und den Funktionsthemen.
Delphi →Die komplette sgcUI-Hilfe als PDF-Datei, zum Offline-Lesen oder Ausdrucken.
Delphi (PDF) →