sgcEditors Matriz de funciones
Todo lo que hace sgcEditors, agrupado por tarea, con un enlace al tema de ayuda de cada función. Cada control existe para VCL, FireMonkey, WinForms, WPF y Avalonia con las mismas propiedades y eventos.
Todo lo que hace sgcEditors, agrupado por tarea, con un enlace al tema de ayuda de cada función. Cada control existe para VCL, FireMonkey, WinForms, WPF y Avalonia con las mismas propiedades y eventos.
17 funciones
9 funciones
2 funciones
6 paquetes NuGet
Ayuda en línea y manuales PDF
Registrada marca las funciones que están en las ediciones registrada y de prueba, y no en la edición Community gratuita. ~ marca una función que Community tiene en parte, con la diferencia debajo.
Cada fila enlaza con su tema de la ayuda. La columna Community muestra lo que incluye la edición Community gratuita de .NET; todo está en la edición Registrada y en la prueba.
| Función | Detalles | Community | Ayuda |
|---|---|---|---|
| Calendario mensual | Fecha única o rango, MinDate y MaxDate, fechas y días de la semana deshabilitados, números de semana ISO 8601 y vistas de mes, año y década. | Ayuda | |
| Selector de fecha | Entrada de fecha con calendario desplegable y un analizador flexible que entiende los nombres de los meses. | Ayuda | |
| Selector de hora | Entrada de hora en un editor nativo. | Ayuda | |
| Selector de fecha y hora | Fecha y hora en un solo control. | Ayuda | |
| Control deslizante de rango | Selecciona un valor o un rango en un control deslizante. El segundo tirador está en la edición registrada. | ~Se dibuja y edita un solo tirador; EndValue se conserva pero no se muestra. | Ayuda |
| Selector de color | Elige un color. El cuadrado HSV y la barra alfa están en la edición registrada. | ~Solo muestras y hexadecimal; el cuadrado HSV y la barra de alfa no se dibujan y el alfa es siempre $FF. | Ayuda |
| Editor de tokens | Fichas para etiquetas y destinatarios. La lista de autocompletado está en la edición registrada. | ~Los chips, la validación y los límites funcionan; la lista de autocompletado nunca se abre. | Ayuda |
| Valoración | Entrada de valoración con estrellas. | Ayuda | |
| Editor numérico | Entrada de números con rueda del ratón y repetición automática. | Ayuda | |
| Editor con botón | Un editor nativo con botones de examinar, desplegable, búsqueda, borrar, más, menos, de texto o dibujados por ti a cada lado, cada uno con un atajo. Los lectores de pantalla nombran y pulsan cada botón. | Ayuda | |
| Editor de búsqueda | OnSearch tras una pausa al escribir o de inmediato con Intro, botones de búsqueda y de borrar, y un historial desplegable de búsquedas anteriores. | Ayuda | |
| Editor con máscara | Máscaras de entrada con la sintaxis EditMask de Delphi o la sintaxis MaskedTextBox de .NET, elegida con MaskSyntax, así que una misma máscara funciona igual en Delphi y en .NET. Un valor incompleto se comunica al validador. | Ayuda | |
| Editor de moneda | Un valor Currency exacto (decimal en .NET) con el formato de moneda de la configuración regional, símbolo o código ISO, límites y agrupación mientras se escribe. | Ayuda | |
| Editor lookup | Un desplegable de varias columnas con una fila de cabecera opcional, filtrado mientras se escribe, una columna de clave y una columna de visualización. Filas desde Items, OnGetItems o, en .NET, ItemsSource. | Ayuda | |
| Memo | Un editor multilínea con tema, con texto de ayuda, un contador de caracteres con límite opcional y una altura que sigue las líneas. | Ayuda | |
| Interruptor | TsgcVCLToggleSwitch y TsgcFMXToggleSwitch (TsgcWinFormsToggleSwitch, TsgcWpfToggleSwitch y TsgcAvaloniaToggleSwitch en .NET) son interruptores de activado y desactivado para ajustes: una pista redondeada con un pulgar redondo que se desliza al nuevo estado en unos 150 ms, un texto a la derecha o a la izquierda (CaptionPosition), el texto On y Off dentro de la pista (ShowText), ReadOnly, y colores de pista y pulgar que por defecto vienen del tema. OnChanging cancela un cambio del usuario, OnChange se dispara después de cada cambio y Toggle cambia el estado como lo haría el usuario. Clic, arrastre del pulgar, Espacio, Izquierda y Derecha, de derecha a izquierda y una casilla de verificación con el patrón Toggle para lectores de pantalla. Checked se enlaza en ambos sentidos en WPF y Avalonia. | Ayuda | |
| Editor de dirección IP | TsgcVCLIPAddressEdit y TsgcFMXIPAddressEdit (TsgcWinFormsIPAddressEdit, TsgcWpfIPAddressEdit y TsgcAvaloniaIPAddressEdit en .NET) admiten una dirección IPv4 o IPv6 (Mode). IPv4 muestra cuatro campos de octeto que avanzan al escribir, limitan un valor superior a 255 y rellenan con 0 los campos vacíos cuando el foco sale; IPv6 es un campo de texto validado y escrito en la forma canónica del RFC 5952 cuando el foco sale. Address, Octets, IsValid, Required con el marco de error del tema, ReadOnly, Clear y OnChange. Pegado de una dirección completa, de derecha a izquierda y un editor con el patrón Value para lectores de pantalla. Address se enlaza en ambos sentidos en WPF y Avalonia. | Ayuda | |
| Editor de duración | TsgcVCLTimeSpanEdit y TsgcFMXTimeSpanEdit (TsgcWinFormsTimeSpanEdit, TsgcWpfTimeSpanEdit y TsgcAvaloniaTimeSpanEdit en .NET) editan una duración en segmentos de días a milisegundos (Segments), como reloj o con unidades (DisplayFormat). Value en milisegundos (un TimeSpan en .NET), MinValue, MaxValue, AllowNegative, Increment, ShowButtons para los botones de incremento y ReadOnly. Escribir, Arriba y Abajo, RePág y AvPág, la rueda y los botones de incremento cambian el segmento con foco con acarreo al siguiente. Un spinner con el patrón RangeValue para lectores de pantalla. Value se enlaza en ambos sentidos en WPF y Avalonia. | Ayuda | |
| Selector de fuente | TsgcVCLFontPicker y TsgcFMXFontPicker (TsgcWinFormsFontPicker, TsgcWpfFontPicker y TsgcAvaloniaFontPicker en .NET) eligen una familia de fuente en una lista desplegable que dibuja cada nombre con su propia tipografía (ShowPreview, PreviewText), filtrada mientras el usuario escribe. FontName, Fonts rellenada desde la plataforma hasta que la aplicación la rellena, RefreshFonts, las familias elegidas recientemente primero (RecentCount, RecentFonts) y un filtro de ancho fijo (FontFilter). Las tipografías de la vista previa de Delphi se dibujan en Windows. FontName se enlaza en ambos sentidos en WPF y Avalonia. | Ayuda | |
| Lista con casillas de verificación | TsgcVCLCheckListBox y TsgcFMXCheckListBox (TsgcWinFormsCheckListBox, TsgcWpfCheckListBox y TsgcAvaloniaCheckListBox en .NET) listan Items con una casilla por fila: Checked, State con un estado en gris (AllowGrayed) e ItemEnabled por elemento. Una fila Seleccionar todo de tres estados (ShowCheckAll), un cuadro de filtro que nunca cambia un estado (ShowFilter), CheckAll, UncheckAll, CheckedCount y OnClickCheck antes de OnChange. Solo se dibujan las filas visibles, así que 10000 elementos siguen siendo rápidos. Espacio, Ctrl+A, escribir una letra para saltar y elementos de lista con el patrón Toggle para lectores de pantalla. | Ayuda | |
| Lista doble | TsgcVCLDualListBox y TsgcFMXDualListBox (TsgcWinFormsDualListBox, TsgcWpfDualListBox y TsgcAvaloniaDualListBox en .NET) mueven elementos entre AvailableItems y SelectedItems con los botones entre las listas, con doble clic o arrastrando y soltando, y reordenan SelectedItems con Subir y Bajar (ShowReorderButtons). SortAvailable, ShowFilter, ShowCaptions, ReadOnly, los métodos MoveToSelected, MoveAllToSelected, MoveToAvailable, MoveAllToAvailable, MoveUp y MoveDown, OnMoving para conservar un elemento y un OnChange por operación. Selección múltiple, movimientos con el teclado y de derecha a izquierda. SelectedItems se enlaza en ambos sentidos en WPF y Avalonia. | Ayuda | |
| NumPad para paneles táctiles | TsgcVCLNumPad es un teclado numérico en pantalla acoplado al formulario, y TsgcVCLNumPadPopup abre el mismo teclado en una lista desplegable bajo su destino (TsgcFMXNumPad y TsgcFMXNumPadPopup en FireMonkey, y un NumPad en .NET). Escribe en el editor de giro, el editor de moneda, los indicadores de mando giratorio y de deslizador de sgcGauges y un campo de edición estándar, definido con Associate o tomado del control con el foco. El teclado lee el rango y los decimales del destino y escribe el valor como un cambio del usuario, con teclas lo bastante grandes para un dedo o un guante. | Ayuda | |
| Teclado en pantalla | TsgcVCLKeyboard es un teclado completo en pantalla acoplado al formulario, y TsgcVCLKeyboardPopup lo abre en una lista desplegable debajo del editor que recibe el foco, con AutoPopup, AutoPopupAll, PopupPosition y CloseOnEnter (TsgcFMXKeyboard y TsgcFMXKeyboardPopup en FireMonkey, y TsgcWinFormsKeyboard, TsgcWpfKeyboard y TsgcAvaloniaKeyboard con sus listas desplegables en .NET). Escribe en el control que tiene el foco o en Associate y nunca toma el foco. Páginas de letras, de símbolos y numérica, Mayús, Bloq Mayús, AltGr y teclas muertas, diez distribuciones integradas (en-US, en-GB, es-ES, fr-FR, de-DE, it-IT, pt-BR, nl-NL, pl-PL y tr-TR), distribuciones propias con sgcKeyboardRegisterLayout, una tecla de distribución que recorre Layouts, temas, derecha a izquierda y accesibilidad. OnKeyText cambia o cancela el texto escrito y OnEnterKey se ejecuta después de Intro. | Ayuda | |
| Control de diseño | TsgcVCLLayoutControl y TsgcFMXLayoutControl (en .NET TsgcWinFormsLayoutControl, TsgcWpfLayoutControl y TsgcAvaloniaLayoutControl) organizan cualquier control, tanto los de sgcEditors como los estándar, en grupos, grupos con pestañas y columnas, con los títulos alineados a un mismo ancho, divisores que el usuario puede arrastrar, elementos que el usuario puede ocultar y diseños de derecha a izquierda. Los lectores de pantalla ven los grupos y las pestañas. En todas las ediciones; Delphi Community no tiene paquete de tiempo de diseño para sgcEditors, así que allí el control de diseño se crea en código. | Ayuda |
| Función | Detalles | Community | Ayuda |
|---|---|---|---|
| Editores enlazados a datos | El selector de fecha, el selector de hora, el editor numérico, la valoración, el deslizador de rango, el editor con botón, el editor con máscara, el editor de moneda, el memo y el editor lookup enlazan DataSource y DataField; el deslizador de rango también enlaza EndDataField, y el editor lookup llena su lista desde un segundo conjunto de datos mediante ListSource, KeyField y ListField. Los campos nulos se muestran vacíos. Delphi y C++ Builder. | Registrada | Ayuda |
| Enlace de datos de WinForms | Los selectores de fecha y hora, el editor numérico, la valoración, el deslizador de rango y los editores con botón, con máscara, de moneda, lookup y memo de WinForms enlazan un campo mediante DataSource, DataMember y DataField: un BindingSource, un DataTable, un DataView o una List. | Registrada | Ayuda |
| Listas lookup desde cualquier colección | ItemsSource, DisplayMember y ValueMember llenan el editor lookup en WinForms, WPF y Avalonia; SelectedValue y SelectedItem devuelven los objetos tipados. | Ayuda | |
| Validación | El validador de sgcUICore comprueba los controles de sgcEditors y los estándar con reglas de obligatorio, rango, longitud, expresión regular, correo electrónico, comparación y personalizadas, con un marco, un icono, una lista resumen y mensajes accesibles, en VCL, FireMonkey, WinForms, WPF y Avalonia. En .NET también muestra los errores de IDataErrorInfo y INotifyDataErrorInfo. | Ayuda | |
| Smart Paste | El calendario mensual, los selectores de fecha, hora y fecha y hora, el editor numérico, la valoración, el editor de tokens, el selector de color, los editores con botón, con máscara, de moneda y lookup y el memo participan en Smart Paste. TsgcVCLSmartPaste y TsgcFMXSmartPaste (en .NET TsgcWinFormsSmartPaste, TsgcWpfSmartPaste y TsgcAvaloniaSmartPaste) convierten un texto pegado, como un correo electrónico o un bloque de dirección, en valores para los controles de un formulario, tanto los de sgcEditors como los controles estándar de edición, lista desplegable, casilla de verificación y fecha, con Deshacer y un botón Smart Paste. Al proveedor de IA solo se envían el texto pegado y las descripciones de los campos, y sin proveedor un analizador local lee líneas como Name: value. | Ayuda | |
| Generador de formularios de datos | TsgcVCLDataForm y TsgcFMXDataForm construyen un formulario de edición completo sobre el control de diseño a partir de un TDataSet, con un control de sgcEditors por campo elegido según su tipo, o a partir de las propiedades published de una clase mediante RTTI con BindObject. En .NET, TsgcWinFormsDataForm, TsgcWpfDataForm y TsgcAvaloniaDataForm aceptan un DataTable, un DataView, una lista o un solo objeto. Fields define el título, el tipo, el grupo, la pestaña y el orden de cada campo, y un navegador añade primero, anterior, siguiente, último, nuevo, editar, eliminar, guardar y cancelar. Delphi, C++ Builder y .NET. | Registrada | Ayuda |
| Validación del formulario de datos | Cada campo se convierte en reglas del validador de sgcUICore: obligatorio, rango, longitud, expresión regular y correo electrónico, además de OnValidateField para tus propias comprobaciones. Post valida primero el registro, un resumen lista los errores, y un campo no válido en una pestaña que no se ve selecciona esa pestaña. | Registrada | Ayuda |
| Smart Paste del formulario de datos | SmartPaste, SmartPasteAsync y SmartPasteFromClipboard, también un botón del navegador, rellenan todos los campos del registro a partir de un texto pegado mediante la capa de IA que los editores usan para su propio Smart Paste. Los campos rellenados muestran una insignia de IA, y SmartPasteUndo devuelve los valores anteriores. Sin proveedor, un analizador local lee líneas como Name: value. | Registrada | Ayuda |
| Diseños guardados como JSON | SaveLayout y LoadLayout guardan el orden, el padre, los tamaños y la visibilidad de cada elemento, la pestaña activa de cada grupo con pestañas y los elementos que el usuario ocultó, como JSON, en una cadena, un flujo o un archivo. Un diseño guardado por una compilación anterior se carga en una más nueva. | Ayuda |
| Función | Detalles | Community | Ayuda |
|---|---|---|---|
| Entrada de texto real | Los campos de fecha, hora, número y hexadecimal son editores nativos, así que funcionan el IME, el portapapeles, deshacer y los lectores de pantalla. | Ayuda | |
| Localización | Cada control lleva su propia configuración regional: nombres de días y meses, formatos, primer día de la semana, FormatSettings por control. | Ayuda | |
| Teclado | F4 o Alt+Abajo para los desplegables, flechas y RePág y AvPág en el calendario, rueda del ratón y repetición automática en el editor numérico, un atajo para cada botón del editor, anillo de foco. | Ayuda | |
| DPI por monitor | Diseño en píxeles lógicos a 96 DPI, escalado por monitor, con el desplegable dibujado al DPI de su monitor. | Ayuda | |
| De derecha a izquierda (árabe y hebreo) | Los botones de incremento, desplegable y borrado pasan al otro lado; la dirección del control deslizante y de la valoración, el orden de los días de la semana del calendario, las flechas y el flujo de tokens están reflejados, y el campo de edición interno recibe la misma dirección. | Ayuda | |
| Lectores de pantalla y alto contraste | Todos los editores exponen su rol, su nombre y su valor a UI Automation, junto con las partes de los editores compuestos (partes de la fecha, tokens, estrellas de valoración, color, botones del editor, la lista lookup) y sus ventanas emergentes mientras están abiertas, y un campo no válido comunica su estado y su mensaje de error. El anillo de foco siempre es visible y se sigue el alto contraste de Windows. Activado por defecto en VCL (Delphi 7 a 13), FireMonkey en Windows, WinForms, WPF y Avalonia. | Ayuda |
| Función | Detalles | Community | Ayuda |
|---|---|---|---|
| Temas | Temas claro y oscuro con una sola propiedad, además de AccentColor, TextStyle y un color de error para la validación. | Ayuda | |
| Renderizado sin ventana | SaveToPNG y SaveToSVG en cada control y en los modelos sin ventana, también en Linux64. Los editores con botón, de búsqueda, con máscara, de moneda y lookup y el memo conservan el texto de su valor en PNG, SVG y en las páginas impresas o en la vista previa. | Ayuda |
| Tarea | Controles estándar de Delphi | sgcEditors |
|---|---|---|
| Elige una fecha o una hora en un desplegable | TDateTimePicker | TsgcVCLDatePicker, TsgcVCLTimePicker |
| Fecha y hora en un solo control | TDateTimePicker | TsgcVCLDateTimePicker |
| Selecciona un rango de días con una duración máxima | TMonthCalendar | esmRange, MaxRangeDays |
| Bloquea fechas sueltas y días de la semana | TMonthCalendar | DisabledDates, DisabledWeekDays, OnIsDateDisabled |
| Un idioma regional por control | TDateTimePicker | FormatSettings |
| Entrada con máscara con la sintaxis de máscara de Delphi o de .NET | TMaskEdit | TsgcVCLMaskEdit, MaskSyntax |
| Elige una fila de una lista de varias columnas | TDBLookupComboBox | TsgcVCLLookupEdit, TsgcVCLDBLookupEdit |
| Un editor con botones | TButtonedEdit | TsgcVCLButtonEdit |
| Escribir un número en un panel táctil | TTouchKeyboard | TsgcVCLNumPad, TsgcVCLNumPadPopup |
| Escribir texto en una pantalla táctil | TTouchKeyboard | TsgcVCLKeyboard, TsgcVCLKeyboardPopup |
| Un interruptor de activado y desactivado para ajustes | TToggleSwitch | TsgcVCLToggleSwitch |
| Editar una dirección IPv4 o IPv6 | TMaskEdit | TsgcVCLIPAddressEdit |
| Introducir una duración como un tiempo de espera | TSpinEdit | TsgcVCLTimeSpanEdit |
| Elegir una familia de fuente con vista previa | TComboBox con Screen.Fonts, TFontDialog | TsgcVCLFontPicker |
| Una lista de opciones con casillas de verificación | TCheckListBox | TsgcVCLCheckListBox |
| Mover elementos entre dos listas | Dos controles TListBox y botones | TsgcVCLDualListBox |
Solo capacidades, según se documentan en la ayuda. Sin afirmaciones de rendimiento.
Los editores .NET son un port en C# con los mismos nombres y eventos, para WinForms, WPF y Avalonia. En WPF las propiedades de valor son propiedades de dependencia con enlace bidireccional. El editor lookup toma ItemsSource, DisplayMember y ValueMember en todos los hosts, y en la edición Registrada los editores WinForms enlazan un campo mediante DataSource, DataMember y DataField.
| Paquete | Edición | Contenido |
|---|---|---|
esegece.sgcEditors.Community | Community (gratuita) | Biblioteca principal |
esegece.sgcEditors.WinForms.Community | Community (gratuita) | Controles Windows Forms |
esegece.sgcEditors.Wpf.Community | Community (gratuita) | Controles WPF |
esegece.sgcEditors.Avalonia.Community | Community (gratuita) | Controles Avalonia |
esegece.sgcEditors.Rendering.Community | Community (gratuita) | Renderizado sin ventana |
esegece.sgcEditors | Registrada | Biblioteca principal |
esegece.sgcEditors.WinForms | Registrada | Controles Windows Forms |
esegece.sgcEditors.Wpf | Registrada | Controles WPF |
esegece.sgcEditors.Avalonia | Registrada | Controles Avalonia |
esegece.sgcEditors.Rendering | Registrada | Renderizado sin ventana |
Cada función de sgcEditors está documentada en la ayuda de sgcUI, con una compilación para cada entorno de desarrollo.
Empieza con la introducción de sgcEditors y sigue con la guía de inicio rápido y los temas de funciones.
Delphi →La ayuda completa de sgcUI en un archivo PDF, para leer sin conexión o imprimir.
Delphi (PDF) →