Tout ce que fait sgcEditors, groupé par tâche, avec un lien vers la rubrique d'aide de chaque fonctionnalité. Chaque contrôle existe pour VCL, FireMonkey, WinForms, WPF et Avalonia avec les mêmes propriétés et événements.
Enregistrée signale les fonctionnalités présentes dans les éditions enregistrée et d'essai, mais pas dans l'édition Community gratuite. ~ signale une fonctionnalité que Community propose en partie, avec la différence indiquée en dessous.
Chaque ligne renvoie à sa rubrique d'aide. La colonne Community montre ce que comprend l'édition .NET Community gratuite ; tout est dans Enregistrée et dans l'essai.
FONCTIONNALITÉS
Contrôles
Fonctionnalité
Détails
Community
Aide
Calendrier mensuel
Date unique ou plage, MinDate et MaxDate, dates et jours de la semaine désactivés, numéros de semaine ISO 8601, vues par mois, année et décennie.
Un champ natif avec des boutons parcourir, liste déroulante, recherche, effacer, plus, moins, texte ou dessinés par le propriétaire de chaque côté, chacun avec un raccourci. Les lecteurs d'écran listent et actionnent chaque bouton.
OnSearch après une pause dans la frappe ou aussitôt sur Entrée, boutons de recherche et d'effacement, et un historique déroulant des recherches précédentes.
Des masques de saisie dans la syntaxe EditMask de Delphi ou la syntaxe MaskedTextBox de .NET, choisie par MaskSyntax, donc un même masque fonctionne de la même façon en Delphi et en .NET. Une valeur incomplète est signalée au validateur.
Une valeur Currency exacte (decimal en .NET) avec le format monétaire des paramètres régionaux, le symbole ou le code ISO, des limites et un regroupement pendant la frappe.
Une liste déroulante multicolonne avec une ligne d'en-tête facultative, un filtrage pendant la frappe, une colonne clé et une colonne d'affichage. Lignes depuis Items, OnGetItems ou, en .NET, ItemsSource.
TsgcVCLToggleSwitch et TsgcFMXToggleSwitch (TsgcWinFormsToggleSwitch, TsgcWpfToggleSwitch et TsgcAvaloniaToggleSwitch en .NET) sont des interrupteurs marche et arrêt pour les réglages : une piste arrondie avec un curseur rond qui glisse vers le nouvel état en 150 ms environ, un libellé à droite ou à gauche (CaptionPosition), le texte On et Off dans la piste (ShowText), ReadOnly, et des couleurs de piste et de curseur qui viennent du thème par défaut. OnChanging annule un changement de l'utilisateur, OnChange se déclenche après chaque changement et Toggle change l'état comme le ferait l'utilisateur. Clic, glisser du curseur, Espace, Gauche et Droite, de droite à gauche et une case à cocher avec le pattern Toggle pour les lecteurs d'écran. Checked se lie dans les deux sens en WPF et Avalonia.
TsgcVCLIPAddressEdit et TsgcFMXIPAddressEdit (TsgcWinFormsIPAddressEdit, TsgcWpfIPAddressEdit et TsgcAvaloniaIPAddressEdit en .NET) acceptent une adresse IPv4 ou IPv6 (Mode). IPv4 affiche quatre champs d'octet qui avancent pendant la saisie, ramènent à la limite une valeur supérieure à 255 et remplissent les champs vides avec 0 quand le focus quitte le contrôle ; IPv6 est un champ de texte validé et écrit sous la forme canonique de la RFC 5952 quand le focus quitte le contrôle. Address, Octets, IsValid, Required avec le cadre d'erreur du thème, ReadOnly, Clear et OnChange. Collage d'une adresse complète, de droite à gauche et un champ avec le pattern Value pour les lecteurs d'écran. Address est lié dans les deux sens en WPF et Avalonia.
TsgcVCLTimeSpanEdit et TsgcFMXTimeSpanEdit (TsgcWinFormsTimeSpanEdit, TsgcWpfTimeSpanEdit et TsgcAvaloniaTimeSpanEdit en .NET) modifient une durée en segments des jours aux millisecondes (Segments), comme une horloge ou avec des unités (DisplayFormat). Value en millisecondes (un TimeSpan en .NET), MinValue, MaxValue, AllowNegative, Increment, ShowButtons pour les boutons de pas et ReadOnly. La saisie, Haut et Bas, Page précédente et Page suivante, la molette et les boutons de pas font avancer le segment ayant le focus avec report sur le suivant. Un spinner avec le pattern RangeValue pour les lecteurs d'écran. Value est lié dans les deux sens en WPF et Avalonia.
TsgcVCLFontPicker et TsgcFMXFontPicker (TsgcWinFormsFontPicker, TsgcWpfFontPicker et TsgcAvaloniaFontPicker en .NET) choisissent une famille de police dans une liste déroulante qui dessine chaque nom dans sa propre police (ShowPreview, PreviewText), filtrée pendant la saisie. FontName, Fonts remplie par la plateforme jusqu'à ce que l'application la remplisse, RefreshFonts, les familles choisies récemment en premier (RecentCount, RecentFonts) et un filtre à chasse fixe (FontFilter). Les polices de l'aperçu Delphi sont dessinées sous Windows. FontName est lié dans les deux sens en WPF et Avalonia.
TsgcVCLCheckListBox et TsgcFMXCheckListBox (TsgcWinFormsCheckListBox, TsgcWpfCheckListBox et TsgcAvaloniaCheckListBox en .NET) listent Items avec une case par ligne : Checked, State avec un état grisé (AllowGrayed) et ItemEnabled par élément. Une ligne Tout sélectionner à trois états (ShowCheckAll), une zone de filtre qui ne change jamais un état (ShowFilter), CheckAll, UncheckAll, CheckedCount et OnClickCheck avant OnChange. Seules les lignes visibles sont dessinées, si bien que 10000 éléments restent rapides. Espace, Ctrl+A, saisir une lettre pour sauter et des éléments de liste avec le pattern Toggle pour les lecteurs d'écran.
TsgcVCLDualListBox et TsgcFMXDualListBox (TsgcWinFormsDualListBox, TsgcWpfDualListBox et TsgcAvaloniaDualListBox en .NET) déplacent des éléments entre AvailableItems et SelectedItems avec les boutons situés entre les listes, un double-clic ou un glisser-déposer, et réordonnent SelectedItems avec Monter et Descendre (ShowReorderButtons). SortAvailable, ShowFilter, ShowCaptions, ReadOnly, les méthodes MoveToSelected, MoveAllToSelected, MoveToAvailable, MoveAllToAvailable, MoveUp et MoveDown, OnMoving pour garder un élément et un OnChange par opération. Sélection multiple, déplacements au clavier et de droite à gauche. SelectedItems est lié dans les deux sens en WPF et Avalonia.
TsgcVCLNumPad est un pavé numérique à l'écran ancré sur la fiche, et TsgcVCLNumPadPopup ouvre le même pavé en liste déroulante sous sa cible (TsgcFMXNumPad et TsgcFMXNumPadPopup sous FireMonkey, et un NumPad en .NET). Il saisit dans le champ numérique, le champ monétaire, les jauges bouton rotatif et curseur de sgcGauges et un champ standard, défini avec Associate ou pris sur le contrôle qui a le focus. Le pavé lit la plage et les décimales de la cible et écrit la valeur comme une modification de l'utilisateur, avec des touches assez grandes pour un doigt ou un gant.
TsgcVCLKeyboard est un clavier complet à l'écran ancré sur la fiche, et TsgcVCLKeyboardPopup l'ouvre en liste déroulante sous le champ qui prend le focus, avec AutoPopup, AutoPopupAll, PopupPosition et CloseOnEnter (TsgcFMXKeyboard et TsgcFMXKeyboardPopup sous FireMonkey, TsgcWinFormsKeyboard, TsgcWpfKeyboard et TsgcAvaloniaKeyboard avec leurs popups en .NET). Il écrit dans le contrôle qui a le focus ou dans Associate et ne prend jamais le focus. Pages de lettres, de symboles et de chiffres, Maj, Verr. Maj, AltGr et touches mortes, dix dispositions intégrées (en-US, en-GB, es-ES, fr-FR, de-DE, it-IT, pt-BR, nl-NL, pl-PL et tr-TR), dispositions personnalisées avec sgcKeyboardRegisterLayout, une touche de disposition qui parcourt Layouts, thèmes, droite à gauche et accessibilité. OnKeyText modifie ou annule le texte saisi et OnEnterKey s'exécute après Entrée.
TsgcVCLLayoutControl et TsgcFMXLayoutControl (en .NET TsgcWinFormsLayoutControl, TsgcWpfLayoutControl et TsgcAvaloniaLayoutControl) organisent n'importe quel contrôle, ceux de sgcEditors comme les contrôles standard, en groupes, groupes à onglets et colonnes, avec les libellés alignés sur une même largeur, des séparateurs que l'utilisateur peut faire glisser, des éléments que l'utilisateur peut masquer et des mises en page de droite à gauche. Les lecteurs d'écran voient les groupes et les onglets. Dans toutes les éditions ; Delphi Community n'a pas de package de conception pour sgcEditors, le contrôle de mise en page y est donc créé en code.
Le sélecteur de date, le sélecteur d'heure, le champ numérique, la notation, le curseur à plage, le champ à boutons, le champ à masque, le champ monétaire, le mémo et le champ de liste de choix se lient à DataSource et DataField ; le curseur à plage se lie aussi à EndDataField, et le champ de liste de choix remplit sa liste depuis un second jeu de données via ListSource, KeyField et ListField. Les champs nuls s'affichent vides. Delphi et C++ Builder.
Les sélecteurs de date et d'heure, le champ numérique, la notation, le curseur à plage de WinForms ainsi que les champs à boutons, à masque, monétaire, de liste de choix et le mémo lient un champ via DataSource, DataMember et DataField : un BindingSource, une DataTable, une DataView ou une List.
Listes de choix depuis n'importe quelle collection
ItemsSource, DisplayMember et ValueMember remplissent le champ de liste de choix sur WinForms, WPF et Avalonia ; SelectedValue et SelectedItem renvoient les objets typés.
Le validateur de sgcUICore contrôle les contrôles sgcEditors et standard selon des règles obligatoire, plage, longueur, expression régulière, e-mail, comparaison et personnalisée, avec un cadre, une icône, une liste récapitulative et des messages accessibles, sur VCL, FireMonkey, WinForms, WPF et Avalonia. En .NET, il affiche aussi les erreurs IDataErrorInfo et INotifyDataErrorInfo.
Le calendrier mensuel, les sélecteurs de date, d'heure et de date et heure, le champ numérique, la notation, le champ de jetons, le sélecteur de couleur, les champs à boutons, à masque, monétaire et de liste de choix ainsi que le mémo participent à Smart Paste. TsgcVCLSmartPaste et TsgcFMXSmartPaste (en .NET TsgcWinFormsSmartPaste, TsgcWpfSmartPaste et TsgcAvaloniaSmartPaste) transforment un texte collé, comme un e-mail ou un bloc d'adresse, en valeurs pour les contrôles d'une fiche, aussi bien sgcEditors que les champs, listes déroulantes, cases à cocher et contrôles de date standard, avec Annuler et un bouton Smart Paste. Seuls le texte collé et les descriptions des champs sont envoyés au fournisseur d'IA, et sans fournisseur un analyseur local lit des lignes comme Nom : valeur.
TsgcVCLDataForm et TsgcFMXDataForm construisent un formulaire d'édition complet sur le contrôle de mise en page à partir d'un TDataSet, avec un contrôle sgcEditors par champ choisi selon son type, ou à partir des propriétés published d'une classe par RTTI avec BindObject. En .NET, TsgcWinFormsDataForm, TsgcWpfDataForm et TsgcAvaloniaDataForm acceptent une DataTable, une DataView, une liste ou un seul objet. Fields définit le libellé, le genre, le groupe, l'onglet et l'ordre de chaque champ, et un navigateur ajoute premier, précédent, suivant, dernier, nouveau, modifier, supprimer, valider et annuler. Delphi, C++ Builder et .NET.
Chaque champ devient des règles du validateur de sgcUICore : obligatoire, plage, longueur, expression régulière et e-mail, plus OnValidateField pour tes propres contrôles. Post valide d'abord l'enregistrement, un récapitulatif liste les erreurs, et un champ non valide sur un onglet qui n'est pas affiché sélectionne cet onglet.
SmartPaste, SmartPasteAsync et SmartPasteFromClipboard, ainsi qu'un bouton du navigateur, remplissent tous les champs de l'enregistrement à partir d'un texte collé, via la couche d'IA que les éditeurs utilisent pour leur propre Smart Paste. Les champs remplis affichent un badge IA, et SmartPasteUndo rétablit les anciennes valeurs. Sans fournisseur, un analyseur local lit des lignes comme Nom : valeur.
SaveLayout et LoadLayout conservent l'ordre, le parent, les tailles et la visibilité de chaque élément, l'onglet actif de chaque groupe à onglets et les éléments masqués par l'utilisateur, en JSON, dans une chaîne, un flux ou un fichier. Une mise en page enregistrée par un build plus ancien se charge dans un build plus récent.
Les champs de date, d'heure, de nombre et hexadécimaux sont des champs natifs, de sorte que l'IME, le presse-papiers, l'annulation et les lecteurs d'écran fonctionnent.
F4 ou Alt+Bas pour les listes déroulantes, flèches et Page précédente et Page suivante dans le calendrier, molette de la souris et répétition automatique dans le champ numérique, un raccourci pour chaque bouton du champ, anneau de focus.
Les boutons d'incrément, de liste déroulante et d'effacement passent de l'autre côté ; la direction du curseur et de la note, l'ordre des jours de la semaine du calendrier, les flèches et le flux des jetons sont en miroir, et le champ de saisie interne reçoit la même direction.
Chaque éditeur expose son rôle, son nom et sa valeur à UI Automation, ainsi que les parties des éditeurs composites (parties de date, jetons, étoiles de notation, couleur, boutons du champ, liste du champ de liste de choix) et leurs fenêtres contextuelles tant qu'elles sont ouvertes, et un champ invalide signale son état et son message d'erreur. L'anneau de focus est toujours visible et le contraste élevé de Windows est respecté. Activé par défaut sur VCL (Delphi 7 à 13), FireMonkey sous Windows, WinForms, WPF et Avalonia.
SaveToPNG et SaveToSVG sur chaque contrôle et sur les modèles sans interface, également sous Linux64. Les champs à boutons, de recherche, à masque, monétaire et de liste de choix ainsi que le mémo conservent leur texte de valeur en PNG, en SVG et dans les pages imprimées ou en aperçu.
Choisir une date ou une heure dans une liste déroulante
TDateTimePicker
TsgcVCLDatePicker, TsgcVCLTimePicker
Date et heure dans un seul contrôle
TDateTimePicker
TsgcVCLDateTimePicker
Sélectionner une plage de jours avec une longueur maximale
TMonthCalendar
esmRange, MaxRangeDays
Bloquer des dates et des jours de la semaine
TMonthCalendar
DisabledDates, DisabledWeekDays, OnIsDateDisabled
Des paramètres régionaux par contrôle
TDateTimePicker
FormatSettings
Saisie à masque avec la syntaxe de masque Delphi ou .NET
TMaskEdit
TsgcVCLMaskEdit, MaskSyntax
Choisir une ligne dans une liste multicolonne
TDBLookupComboBox
TsgcVCLLookupEdit, TsgcVCLDBLookupEdit
Un champ avec des boutons
TButtonedEdit
TsgcVCLButtonEdit
Saisir un nombre sur un panneau tactile
TTouchKeyboard
TsgcVCLNumPad, TsgcVCLNumPadPopup
Saisir du texte sur un écran tactile
TTouchKeyboard
TsgcVCLKeyboard, TsgcVCLKeyboardPopup
Un interrupteur marche et arrêt pour les réglages
TToggleSwitch
TsgcVCLToggleSwitch
Modifier une adresse IPv4 ou IPv6
TMaskEdit
TsgcVCLIPAddressEdit
Saisir une durée comme un délai d'attente
TSpinEdit
TsgcVCLTimeSpanEdit
Choisir une famille de police avec aperçu
TComboBox avec Screen.Fonts, TFontDialog
TsgcVCLFontPicker
Une liste d'options avec des cases à cocher
TCheckListBox
TsgcVCLCheckListBox
Déplacer des éléments entre deux listes
Deux contrôles TListBox et des boutons
TsgcVCLDualListBox
Uniquement les capacités, telles que documentées dans l'aide. Aucune affirmation de performance.
.NET
sgcEditors pour .NET
Les éditeurs .NET sont un portage C# avec les mêmes noms et les mêmes événements, pour WinForms, WPF et Avalonia. En WPF, les propriétés de valeur sont des propriétés de dépendance qui se lient dans les deux sens. Le champ de liste de choix accepte ItemsSource, DisplayMember et ValueMember sur chaque hôte, et dans l'édition Enregistrée les éditeurs WinForms lient un champ via DataSource, DataMember et DataField.
Paquet
Édition
Contenu
esegece.sgcEditors.Community
Community (gratuite)
Bibliothèque principale
esegece.sgcEditors.WinForms.Community
Community (gratuite)
Contrôles Windows Forms
esegece.sgcEditors.Wpf.Community
Community (gratuite)
Contrôles WPF
esegece.sgcEditors.Avalonia.Community
Community (gratuite)
Contrôles Avalonia
esegece.sgcEditors.Rendering.Community
Community (gratuite)
Rendu sans interface
esegece.sgcEditors
Enregistrée
Bibliothèque principale
esegece.sgcEditors.WinForms
Enregistrée
Contrôles Windows Forms
esegece.sgcEditors.Wpf
Enregistrée
Contrôles WPF
esegece.sgcEditors.Avalonia
Enregistrée
Contrôles Avalonia
esegece.sgcEditors.Rendering
Enregistrée
Rendu sans interface
DOCUMENTATION
Documentation
Chaque fonctionnalité de sgcEditors est documentée dans l'aide de sgcUI, avec une version pour chaque environnement de développement.
Aide en ligne
Commence par l'introduction de sgcEditors, puis suis le démarrage rapide et les rubriques sur les fonctionnalités.