Tutto ciò che fa sgcEditors, raggruppato per attività, con un link all'argomento della guida di ogni funzionalità. Ogni controllo esiste per VCL, FireMonkey, WinForms, WPF e Avalonia con le stesse proprietà ed eventi.
17 funzionalità
9 funzionalità
5 funzionalità
2 funzionalità
6 pacchetti NuGet
Guida online e manuali PDF
Registered indica le funzionalità incluse nelle edizioni Registered e Trial e non nell'edizione Community gratuita. ~ indica una funzionalità che Community ha solo in parte, con la differenza indicata sotto.
Ogni riga rimanda al relativo argomento della guida. La colonna Community mostra cosa include l'edizione .NET Community gratuita; tutto è in Registered e Trial.
| Funzionalità | Dettagli | Community | Guida |
|---|---|---|---|
| Calendario mensile | Data singola o intervallo, MinDate e MaxDate, date e giorni della settimana disabilitati, numeri di settimana ISO 8601, viste per mese, anno e decennio. | Guida | |
| Selettore di data | Inserimento della data con un calendario a discesa e un parser tollerante che comprende i nomi dei mesi. | Guida | |
| Selettore di ora | Inserimento dell'ora in un edit nativo. | Guida | |
| Selettore di data e ora | Data e ora in un solo controllo. | Guida | |
| Slider a intervallo | Seleziona un valore o un intervallo su uno slider. Il secondo cursore è nell'edizione Registered. | ~Viene disegnato e modificato un solo cursore; EndValue viene mantenuto ma non mostrato. | Guida |
| Selettore di colore | Scegli un colore. Il quadrato HSV e la barra alfa sono nell'edizione Registered. | ~Solo campioni ed esadecimale; il quadrato HSV e la barra alfa non vengono disegnati e l'alfa è sempre $FF. | Guida |
| Token edit | Chip per tag e destinatari. L'elenco di completamento automatico è nell'edizione Registered. | ~I chip, la validazione e i limiti funzionano; l'elenco di completamento automatico non si apre mai. | Guida |
| Valutazione | Input di valutazione a stelle. | Guida | |
| Spin edit | Inserimento numerico con rotellina del mouse e ripetizione automatica. | Guida | |
| Button edit | Un edit nativo con pulsanti di sfoglia, menu a discesa, ricerca, cancella, più, meno, di testo o disegnati da te su entrambi i lati, ciascuno con una scorciatoia. I lettori di schermo elencano e premono ogni pulsante. | Guida | |
| Search edit | OnSearch dopo una pausa nella digitazione o subito con Invio, pulsanti di ricerca e cancella e una cronologia a discesa delle ricerche precedenti. | Guida | |
| Edit con maschera | Maschere di input con la sintassi EditMask di Delphi o la sintassi MaskedTextBox di .NET, scelta con MaskSyntax, quindi la stessa maschera funziona allo stesso modo in Delphi e .NET. Un valore incompleto viene segnalato al validatore. | Guida | |
| Edit per valuta | Un valore Currency esatto (decimal in .NET) con il formato valuta delle impostazioni locali, simbolo o codice ISO, limiti e raggruppamento durante la digitazione. | Guida | |
| Lookup edit | Un elenco a discesa a più colonne con una riga di intestazione facoltativa, filtrato durante la digitazione, con una colonna chiave e una colonna di visualizzazione. Righe da Items, OnGetItems o, in .NET, ItemsSource. | Guida | |
| Memo | Un editor multiriga con tema, con un segnaposto, un contatore di caratteri con limite facoltativo e un'altezza che segue le righe. | Guida | |
| Interruttore | TsgcVCLToggleSwitch e TsgcFMXToggleSwitch (TsgcWinFormsToggleSwitch, TsgcWpfToggleSwitch e TsgcAvaloniaToggleSwitch in .NET) sono interruttori on e off per le impostazioni: una traccia arrotondata con un cursore rotondo che scorre verso il nuovo stato in circa 150 ms, una didascalia a destra o a sinistra (CaptionPosition), il testo On e Off dentro la traccia (ShowText), ReadOnly, e colori di traccia e cursore che per impostazione predefinita seguono il tema. OnChanging annulla una modifica dell'utente, OnChange scatta dopo ogni modifica e Toggle cambia lo stato come farebbe l'utente. Clic, trascinamento del cursore, Spazio, Sinistra e Destra, da destra a sinistra e una casella di controllo con il pattern Toggle per gli screen reader. Checked ha il binding bidirezionale in WPF e Avalonia. | Guida | |
| Edit per indirizzi IP | TsgcVCLIPAddressEdit e TsgcFMXIPAddressEdit (TsgcWinFormsIPAddressEdit, TsgcWpfIPAddressEdit e TsgcAvaloniaIPAddressEdit in .NET) accettano un indirizzo IPv4 o IPv6 (Mode). IPv4 mostra quattro campi ottetto che avanzano mentre si digita, limitano un valore superiore a 255 e riempiono con 0 i campi vuoti quando il focus esce; IPv6 è un campo di testo validato e scritto nella forma canonica della RFC 5952 quando il focus esce. Address, Octets, IsValid, Required con il riquadro di errore del tema, ReadOnly, Clear e OnChange. Incolla di un indirizzo completo, da destra a sinistra e un edit con il pattern Value per gli screen reader. Address è collegato in entrambe le direzioni in WPF e Avalonia. | Guida | |
| Edit per durate | TsgcVCLTimeSpanEdit e TsgcFMXTimeSpanEdit (TsgcWinFormsTimeSpanEdit, TsgcWpfTimeSpanEdit e TsgcAvaloniaTimeSpanEdit in .NET) modificano una durata in segmenti dai giorni ai millisecondi (Segments), come orologio o con le unità (DisplayFormat). Value in millisecondi (un TimeSpan in .NET), MinValue, MaxValue, AllowNegative, Increment, ShowButtons per i pulsanti di incremento e ReadOnly. Digitare, Su e Giù, PagSu e PagGiù, la rotellina e i pulsanti di incremento cambiano il segmento con il focus con riporto sul successivo. Uno spinner con il pattern RangeValue per gli screen reader. Value è collegato in entrambe le direzioni in WPF e Avalonia. | Guida | |
| Selettore di font | TsgcVCLFontPicker e TsgcFMXFontPicker (TsgcWinFormsFontPicker, TsgcWpfFontPicker e TsgcAvaloniaFontPicker in .NET) scelgono una famiglia di caratteri da una lista a discesa che disegna ogni nome con il proprio carattere (ShowPreview, PreviewText), filtrata mentre si digita. FontName, Fonts riempita dalla piattaforma finché l'applicazione non la riempie, RefreshFonts, le famiglie scelte di recente per prime (RecentCount, RecentFonts) e un filtro a passo fisso (FontFilter). I caratteri dell'anteprima di Delphi sono disegnati su Windows. FontName è collegato in entrambe le direzioni in WPF e Avalonia. | Guida | |
| Lista con caselle di controllo | TsgcVCLCheckListBox e TsgcFMXCheckListBox (TsgcWinFormsCheckListBox, TsgcWpfCheckListBox e TsgcAvaloniaCheckListBox in .NET) elencano Items con una casella per riga: Checked, State con uno stato grigio (AllowGrayed) e ItemEnabled per elemento. Una riga Seleziona tutto a tre stati (ShowCheckAll), una casella di filtro che non cambia mai uno stato (ShowFilter), CheckAll, UncheckAll, CheckedCount e OnClickCheck prima di OnChange. Vengono disegnate solo le righe visibili, così 10000 elementi restano veloci. Spazio, Ctrl+A, digitare una lettera per saltare ed elementi di lista con il pattern Toggle per gli screen reader. | Guida | |
| Lista doppia | TsgcVCLDualListBox e TsgcFMXDualListBox (TsgcWinFormsDualListBox, TsgcWpfDualListBox e TsgcAvaloniaDualListBox in .NET) spostano elementi tra AvailableItems e SelectedItems con i pulsanti tra le liste, con un doppio clic o con il trascinamento, e riordinano SelectedItems con Su e Giù (ShowReorderButtons). SortAvailable, ShowFilter, ShowCaptions, ReadOnly, i metodi MoveToSelected, MoveAllToSelected, MoveToAvailable, MoveAllToAvailable, MoveUp e MoveDown, OnMoving per mantenere un elemento e un OnChange per operazione. Selezione multipla, spostamenti da tastiera e da destra a sinistra. SelectedItems è collegato in entrambe le direzioni in WPF e Avalonia. | Guida | |
| NumPad per pannelli touch | TsgcVCLNumPad è un tastierino numerico a schermo ancorato sul form, e TsgcVCLNumPadPopup apre lo stesso pad in un menu a discesa sotto il suo bersaglio (TsgcFMXNumPad e TsgcFMXNumPadPopup su FireMonkey, e un NumPad in .NET). Digita nello spin edit, nel currency edit, nei gauge manopola e slider di sgcGauges e in un edit standard, impostato con Associate o preso dal controllo con il focus. Il pad legge l'intervallo e i decimali del bersaglio e scrive il valore come modifica dell'utente, con tasti abbastanza grandi per un dito o un guanto. | Guida | |
| Tastiera a schermo | TsgcVCLKeyboard è una tastiera completa a schermo ancorata sul form, e TsgcVCLKeyboardPopup la apre in un menu a discesa sotto l'edit che riceve il focus, con AutoPopup, AutoPopupAll, PopupPosition e CloseOnEnter (TsgcFMXKeyboard e TsgcFMXKeyboardPopup su FireMonkey, e TsgcWinFormsKeyboard, TsgcWpfKeyboard e TsgcAvaloniaKeyboard con i loro menu a discesa in .NET). Scrive nel controllo che ha il focus o in Associate e non prende mai il focus. Pagine di lettere, di simboli e numerica, Maiusc, Bloc Maiusc, AltGr e tasti morti, dieci layout integrati (en-US, en-GB, es-ES, fr-FR, de-DE, it-IT, pt-BR, nl-NL, pl-PL e tr-TR), layout personalizzati con sgcKeyboardRegisterLayout, un tasto layout che scorre Layouts, temi, da destra a sinistra e accessibilità. OnKeyText modifica o annulla il testo digitato e OnEnterKey viene eseguito dopo Invio. | Guida | |
| Controllo di layout | TsgcVCLLayoutControl e TsgcFMXLayoutControl (in .NET TsgcWinFormsLayoutControl, TsgcWpfLayoutControl e TsgcAvaloniaLayoutControl) dispongono qualsiasi controllo, sia quelli di sgcEditors sia quelli standard, in gruppi, gruppi a schede e colonne, con le etichette allineate a un'unica larghezza, divisori che l'utente può trascinare, elementi che l'utente può nascondere e layout da destra a sinistra. Gli screen reader vedono i gruppi e le schede. In ogni edizione; Delphi Community non ha un pacchetto in fase di progettazione per sgcEditors, quindi lì il controllo di layout si crea nel codice. | Guida |
| Funzionalità | Dettagli | Community | Guida |
|---|---|---|---|
| Editor data-aware | Il selettore di data, il selettore di ora, lo spin edit, la valutazione, lo slider a intervallo, il button edit, l'edit con maschera, l'edit per valuta, il memo e il lookup edit collegano DataSource e DataField; lo slider a intervallo collega anche EndDataField, e il lookup edit riempie il suo elenco da un secondo dataset tramite ListSource, KeyField e ListField. I campi null appaiono vuoti. Delphi e C++ Builder. | Registrata | Guida |
| Data binding di WinForms | I selettori di data e ora, lo spin edit, la valutazione, lo slider a intervallo e gli editor button edit, con maschera, per valuta, lookup e memo di WinForms collegano un campo tramite DataSource, DataMember e DataField: un BindingSource, una DataTable, una DataView o una List. | Registrata | Guida |
| Elenchi lookup da qualsiasi raccolta | ItemsSource, DisplayMember e ValueMember riempiono il lookup edit su WinForms, WPF e Avalonia; SelectedValue e SelectedItem restituiscono gli oggetti tipizzati. | Guida | |
| Validazione | Il validatore di sgcUICore controlla i controlli di sgcEditors e quelli standard rispetto a regole di obbligatorio, intervallo, lunghezza, espressione regolare, e-mail, confronto e personalizzate, con un riquadro, un'icona, un elenco riepilogativo e messaggi accessibili, su VCL, FireMonkey, WinForms, WPF e Avalonia. In .NET mostra anche gli errori di IDataErrorInfo e INotifyDataErrorInfo. | Guida | |
| Smart Paste | Il calendario mensile, i selettori di data, ora e data e ora, lo spin edit, la valutazione, il token edit, il selettore di colore, i button edit, gli edit con maschera, per valuta e lookup e il memo partecipano a Smart Paste. TsgcVCLSmartPaste e TsgcFMXSmartPaste (in .NET TsgcWinFormsSmartPaste, TsgcWpfSmartPaste e TsgcAvaloniaSmartPaste) trasformano un testo incollato, come un'e-mail o un blocco di indirizzo, in valori per i controlli di una maschera, sia quelli di sgcEditors sia i controlli standard edit, combo, check box e data, con Annulla e un pulsante Smart Paste. Al provider AI vengono inviati solo il testo incollato e le descrizioni dei campi, e senza provider un parser locale legge righe come Nome: valore. | Guida | |
| Generatore di maschere dati | TsgcVCLDataForm e TsgcFMXDataForm costruiscono una maschera di modifica completa sul controllo di layout a partire da un TDataSet, con un controllo sgcEditors per campo scelto in base al tipo, oppure dalle proprietà published di una classe tramite RTTI con BindObject. In .NET TsgcWinFormsDataForm, TsgcWpfDataForm e TsgcAvaloniaDataForm accettano una DataTable, una DataView, un elenco o un singolo oggetto. Fields imposta etichetta, tipo, gruppo, scheda e ordine di ogni campo, e un navigatore aggiunge primo, precedente, successivo, ultimo, nuovo, modifica, elimina, registra e annulla. Delphi, C++ Builder e .NET. | Registrata | Guida |
| Validazione della maschera dati | Ogni campo diventa regole del validatore di sgcUICore: obbligatorio, intervallo, lunghezza, espressione regolare ed e-mail, più OnValidateField per i tuoi controlli. Post convalida prima il record, un riepilogo elenca gli errori, e un campo non valido su una scheda non visibile seleziona quella scheda. | Registrata | Guida |
| Smart Paste della maschera dati | SmartPaste, SmartPasteAsync e SmartPasteFromClipboard, anche un pulsante del navigatore, compilano tutti i campi del record da un testo incollato tramite il livello AI che gli editor usano per il loro Smart Paste. I campi compilati mostrano un badge AI, e SmartPasteUndo ripristina i valori precedenti. Senza provider un parser locale legge righe come Nome: valore. | Registrata | Guida |
| Layout salvati come JSON | SaveLayout e LoadLayout conservano l'ordine, il genitore, le dimensioni e la visibilità di ogni elemento, la scheda attiva di ogni gruppo a schede e gli elementi nascosti dall'utente, come JSON, in una stringa, uno stream o un file. Un layout salvato da una build precedente si carica in una più recente. | Guida |
| Funzionalità | Dettagli | Community | Guida |
|---|---|---|---|
| Vero inserimento di testo | I campi data, ora, numero ed esadecimale sono edit nativi, quindi IME, appunti, annulla e screen reader funzionano. | Guida | |
| Localizzazione | Ogni controllo ha la propria impostazione locale: nomi dei giorni e dei mesi, formati, primo giorno della settimana, FormatSettings per controllo. | Guida | |
| Tastiera | F4 o Alt+Freccia giù per i menu a discesa, frecce e PagSu e PagGiù nel calendario, rotellina del mouse e ripetizione automatica nello spin edit, una scorciatoia per ogni pulsante dell'edit, anello di focus. | Guida | |
| DPI per monitor | Layout in pixel logici a 96 DPI, scalato per monitor, con la tendina disegnata al DPI del suo monitor. | Guida | |
| Da destra a sinistra (arabo ed ebraico) | I pulsanti di incremento, a discesa e di cancellazione passano sull'altro lato; direzione di cursore e valutazione, ordine dei giorni della settimana del calendario, frecce e flusso dei token sono speculari, e il campo di modifica interno riceve la stessa direzione. | Guida | |
| Screen reader e alto contrasto | Ogni editor espone il suo ruolo, il suo nome e il suo valore a UI Automation, insieme alle parti degli editor compositi (parti della data, token, stelle di valutazione, colore, pulsanti dell'edit, l'elenco lookup) e ai loro popup finché sono aperti, e un campo non valido segnala il suo stato e il suo messaggio di errore. L'anello di focus è sempre visibile e viene seguito l'alto contrasto di Windows. Attivo per impostazione predefinita su VCL (Delphi da 7 a 13), FireMonkey su Windows, WinForms, WPF e Avalonia. | Guida |
| Funzionalità | Dettagli | Community | Guida |
|---|---|---|---|
| Temi | Temi chiaro e scuro con una sola proprietà, più AccentColor, TextStyle e un colore di errore per la validazione. | Guida | |
| Rendering headless | SaveToPNG e SaveToSVG su ogni controllo e sui modelli headless, anche su Linux64. I button edit, i search edit, gli edit con maschera, per valuta e lookup e il memo conservano il testo del valore in PNG, SVG e nelle pagine stampate o in anteprima. | Guida |
| Attività | Controlli Delphi standard | sgcEditors |
|---|---|---|
| Scegli una data o un'ora da un menu a discesa | TDateTimePicker | TsgcVCLDatePicker, TsgcVCLTimePicker |
| Data e ora in un solo controllo | TDateTimePicker | TsgcVCLDateTimePicker |
| Seleziona un intervallo di giorni con una lunghezza massima | TMonthCalendar | esmRange, MaxRangeDays |
| Blocca singole date e giorni della settimana | TMonthCalendar | DisabledDates, DisabledWeekDays, OnIsDateDisabled |
| Una lingua locale per controllo | TDateTimePicker | FormatSettings |
| Input con maschera con la sintassi di Delphi o di .NET | TMaskEdit | TsgcVCLMaskEdit, MaskSyntax |
| Scegliere una riga da un elenco a più colonne | TDBLookupComboBox | TsgcVCLLookupEdit, TsgcVCLDBLookupEdit |
| Un edit con pulsanti | TButtonedEdit | TsgcVCLButtonEdit |
| Digitare un numero su un pannello touch | TTouchKeyboard | TsgcVCLNumPad, TsgcVCLNumPadPopup |
| Digitare testo su un touch screen | TTouchKeyboard | TsgcVCLKeyboard, TsgcVCLKeyboardPopup |
| Un interruttore on e off per le impostazioni | TToggleSwitch | TsgcVCLToggleSwitch |
| Modificare un indirizzo IPv4 o IPv6 | TMaskEdit | TsgcVCLIPAddressEdit |
| Inserire una durata come un timeout | TSpinEdit | TsgcVCLTimeSpanEdit |
| Scegliere una famiglia di caratteri con anteprima | TComboBox con Screen.Fonts, TFontDialog | TsgcVCLFontPicker |
| Una lista di opzioni con caselle di controllo | TCheckListBox | TsgcVCLCheckListBox |
| Spostare elementi tra due liste | Due controlli TListBox e pulsanti | TsgcVCLDualListBox |
Solo capacità, come documentato nella guida. Nessuna affermazione sulle prestazioni.
Gli editor .NET sono un port in C# con gli stessi nomi ed eventi, per WinForms, WPF e Avalonia. In WPF le proprietà di valore sono dependency property che si collegano in modo bidirezionale. Il lookup edit accetta ItemsSource, DisplayMember e ValueMember su ogni host, e nell'edizione Registered gli editor WinForms collegano un campo tramite DataSource, DataMember e DataField.
| Pacchetto | Edizione | Contenuto |
|---|---|---|
esegece.sgcEditors.Community | Community (gratuita) | Libreria di base |
esegece.sgcEditors.WinForms.Community | Community (gratuita) | Controlli Windows Forms |
esegece.sgcEditors.Wpf.Community | Community (gratuita) | Controlli WPF |
esegece.sgcEditors.Avalonia.Community | Community (gratuita) | Controlli Avalonia |
esegece.sgcEditors.Rendering.Community | Community (gratuita) | Rendering headless |
esegece.sgcEditors | Registered | Libreria di base |
esegece.sgcEditors.WinForms | Registered | Controlli Windows Forms |
esegece.sgcEditors.Wpf | Registered | Controlli WPF |
esegece.sgcEditors.Avalonia | Registered | Controlli Avalonia |
esegece.sgcEditors.Rendering | Registered | Rendering headless |
Ogni funzionalità di sgcEditors è documentata nella guida di sgcUI, con una versione per ogni ambiente di sviluppo.
Inizia dall'introduzione a sgcEditors, poi segui la guida rapida e gli argomenti sulle funzionalità.
Delphi →La guida completa di sgcUI in formato PDF, da leggere offline o stampare.
Delphi (PDF) →