sgcGrid Matriz de funciones
Todo lo que hace sgcGrid, agrupado por tarea, con un enlace al tema de ayuda de cada función. El mismo modelo mueve las cuadrículas VCL, FireMonkey, WinForms, WPF y Avalonia.
Todo lo que hace sgcGrid, agrupado por tarea, con un enlace al tema de ayuda de cada función. El mismo modelo mueve las cuadrículas VCL, FireMonkey, WinForms, WPF y Avalonia.
3 funciones
15 funciones
4 funciones
12 funciones
5 funciones
2 funciones
8 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.
Los filtros de columna, la fila de filtro, el panel de búsqueda, el selector de columnas, la reordenación de columnas, el ajuste automático, los diseños, la selección múltiple, las bandas, los tipos de celda, la edición de DataSet, el pegado, deshacer y los editores de celda de sgcEditors están en las cuadrículas VCL y FireMonkey para Delphi y C++ Builder y en las cuadrículas WinForms, WPF y Avalonia para .NET, con la misma división entre Community y Registrada, descrita en Ediciones. En .NET, la edición de DataSet escribe de vuelta en un DataTable, AddLookup añade las columnas de búsqueda y SyncCursor es solo de Delphi.
| Función | Detalles | Community | Ayuda |
|---|---|---|---|
| Actualizaciones en vivo desde cualquier hilo | Data.AppendRow y Data.UpdateRow son seguros entre hilos. Actualiza un campo o varios por clave, y BeginUpdate y EndUpdate agrupan una ráfaga en un solo repintado, con el ritmo marcado por MaxFPS. | Ayuda | |
| Parpadeo al cambiar | Las celdas modificadas parpadean en verde cuando el valor sube y en rojo cuando baja, y después se desvanecen. El modo Tail mantiene a la vista las filas más recientes de un registro o de un flujo de datos. | Ayuda | |
| Modo virtual | No almacena filas: VirtualRowCount fija el número y OnGetValue devuelve cada valor pintado, así que un millón de filas cuesta lo mismo que cincuenta. | Ayuda |
| Función | Detalles | Community | Ayuda |
|---|---|---|---|
| Ordenación | Ordena por varias columnas con SortOrder y SortIndex; Ctrl y clic añade una columna. La ordenación es estable. | Ayuda | |
| Filtrado | FilterText conserva las filas que contienen un texto en cualquier columna visible, y OnFilterRow añade reglas personalizadas. | Ayuda | |
| Selección y teclado | Selección de fila o de celda con SelectionMode, navegación con el teclado, y Ctrl+C copia como texto separado por tabuladores. La selección sigue a su clave. | Ayuda | |
| Redimensionado de columnas | Los usuarios arrastran el borde del encabezado para redimensionar una columna, nunca por debajo de su MinWidth; OnColumnResized lo notifica. | Ayuda | |
| Columnas inmovilizadas | FrozenColumns mantiene fijas las primeras columnas visibles mientras el resto se desplaza; el encabezado, el pie y los resúmenes de grupo las acompañan. | Ayuda | |
| Formato condicional | Las reglas de formato colorean una celda o la fila completa cuando un valor cumple una condición, con colores translúcidos que tiñen la celda sobre su fondo. | Ayuda | |
| De derecha a izquierda (árabe y hebreo) | Las columnas fluyen desde la derecha con las columnas fijas en el borde derecho; la barra de desplazamiento, el árbol y la sangría de grupo, los chevrones, los iconos de cabecera, el pie y el editor in situ están reflejados. Los números y las fechas siguen siendo fragmentos de izquierda a derecha. SaveToXLSX (Registered) escribe una hoja de derecha a izquierda, también mediante TsgcGridXLSXWriter.RightToLeft. | Ayuda | |
| Filtro de columna | Un embudo en cada encabezado (ShowFilterButtons) abre una ventana emergente con los valores distintos de la columna y sus recuentos, un cuadro de búsqueda y hasta dos condiciones tipadas unidas por And o Or. | Ayuda | |
| Fila de filtro | ShowFilterRow añade bajo el encabezado una fila que filtra cada columna mientras el usuario escribe, con un operador por columna en FilterRowOperator. | Ayuda | |
| Panel de búsqueda | Ctrl+F o ShowFindPanel resalta el texto en todas las celdas, F3 y Shift+F3 se mueven entre coincidencias, y FindOnlyMatches oculta las demás filas. | Ayuda | |
| Selector de columnas y menú del encabezado | Un clic derecho en un encabezado ordena, agrupa, ajusta los anchos, filtra y abre el selector de columnas, una ventana emergente con una casilla por columna. ShowColumnChooser lo abre desde código. | Ayuda | |
| Reordenación de columnas | Los usuarios arrastran un encabezado para mover su columna, dentro de su lado de las columnas inmovilizadas y de sus bandas; OnColumnMoved notifica el movimiento. | Ayuda | |
| Ajuste automático | Un doble clic en el borde del encabezado, o BestFitColumn y BestFitColumns, ajusta el ancho al título y a hasta 1.000 filas de muestra. | Ayuda | |
| Persistencia del diseño | SaveLayoutToString, SaveLayoutToStream y SaveLayoutToFile guardan el orden de las columnas, los anchos, la visibilidad, la ordenación, la agrupación, los filtros de columna y las bandas como JSON con versión, y los métodos Load los restauran. | Ayuda | |
| Selección múltiple | gsmMultiRow selecciona cualquier conjunto de filas y gsmCellRange un rango de celdas, con Ctrl, Shift y Ctrl+A. La selección se guarda por clave de fila, y Ctrl+C la copia como texto separado por tabuladores. | Ayuda |
| Función | Detalles | Community | Ayuda |
|---|---|---|---|
| Agrupación | Agrupa por una o más columnas con GroupBy o arrastrando encabezados al panel de grupos, con filas de grupo anidadas y plegables. | Ayuda | |
| Resúmenes | Suma, Cuenta, Media, Mín y Máx con SummaryType, en cada fila de grupo y en el pie, con el formato de SummaryFormat. | Ayuda | |
| Filas en árbol | Jerarquías a partir de una clave y una columna padre (Tree.KeyField, Tree.ParentField), con el estado expandido guardado por clave. | Registrada | Ayuda |
| Maestro-detalle | Una banda de detalle con las filas relacionadas bajo cada fila maestra expandida, rellenada desde un TsgcGridDataStore, una cuadrícula o OnGetDetailData. | Registrada | Ayuda |
| Función | Detalles | Community | Ayuda |
|---|---|---|---|
| Edición directa | Edita celdas con un editor de texto o un cuadro combinado con lista, con OnValidate, OnEditError y OnEdited. | Registrada | Ayuda |
| Enlace con DataSet | TsgcGridSource_DataSet llena una cuadrícula desde cualquier TDataSet, crea las columnas con AutoColumns y, con LiveUpdates, sigue cada Append, Edit y Delete. En .NET el mismo origen lee un DataTable. | Ayuda | |
| Enlace ItemsSource y MVVM (.NET) | TsgcWpfGrid y TsgcAvaloniaGrid muestran los elementos de ItemsSource, cualquier IEnumerable, con AutoGenerateColumns, KeyMember y un SelectedItem bidireccional. En WPF se aplican la ordenación, el filtro y la agrupación de un ICollectionView, y IsSynchronizedWithCurrentItem sigue su elemento actual. TsgcWinFormsGrid enlaza DataSource y DataMember como el DataGridView. Con ItemsWriteBack, las ediciones, inserciones y eliminaciones vuelven a los elementos. | ~Community muestra y sigue los elementos enlazados. ItemsWriteBack es de la edición Registrada. | Ayuda |
| Columnas en XAML y en el diseñador (.NET) | Los elementos TsgcWpfGridColumn y TsgcAvaloniaGridColumn dentro de la cuadrícula declaran las columnas, con FieldName (rutas con puntos como Customer.Country), Caption, DataType y DisplayFormat. En WinForms, el diseñador de Visual Studio, en .NET Framework y en .NET 8 o posterior, edita Columns con una etiqueta inteligente y un editor de colecciones, y una cuadrícula vacía muestra filas de ejemplo en el diseñador y en las vistas previas de WPF y Avalonia. | Ayuda | |
| JSON y CSV | sgcGrid_IO carga y guarda las filas como JSON o CSV (RFC 4180) desde cadenas, flujos y archivos, también en Linux64. | Ayuda | |
| Exportación a Excel | SaveToXLSX escribe un libro de Excel con anchos de columna, formatos numéricos, paneles inmovilizados, el esquema de grupos o de árbol y fórmulas SUBTOTAL. | Registrada | Ayuda |
| Modo Excel | Con ExcelMode la cuadrícula funciona como una hoja de cálculo ligera: selección de rango con Ctrl+C, un controlador de relleno que continúa series y desplaza las referencias de las fórmulas, y fórmulas con referencias A1 y SUM, AVERAGE, MIN, MAX, COUNT, IF, ROUND y ABS. LoadFromXLSX abre una hoja de un libro de Excel sin biblioteca externa. | Registrada | Ayuda |
| Edición de DataSet | Con WriteBack, un TsgcGridSource_DataSet envía las ediciones de la cuadrícula a sus registros, SyncCursor mantiene juntos el registro actual y la fila con el foco, y AllowInsert y AllowDelete añaden y eliminan registros. Los campos de búsqueda se editan como listas de selección. | Registrada | Ayuda |
| Pegado desde el portapapeles | Ctrl+V pega en un rango de celdas el texto separado por tabuladores de Excel. Cada valor se convierte y se valida antes de escribir nada, y el pegado es un único paso de deshacer. | Registrada | Ayuda |
| Deshacer y rehacer | Ctrl+Z y Ctrl+Y deshacen y rehacen ediciones de celda y pegados por clave de fila, hasta UndoLimit pasos. | Registrada | Ayuda |
| Editores de celda | EditorKind elige un selector de fecha, de hora o de fecha y hora, un editor numérico con flechas, un selector de color o un editor de tokens de sgcEditors, y OnCreateEditor pone en una celda cualquier control propio. | Registrada | Ayuda |
| Impresión y vista previa de impresión | Print y ShowPrintPreview imprimen cada fila tal como la muestra la cuadrícula, filtrada, ordenada y agrupada, con las bandas y los encabezados de columna en cada página y solo filas enteras en una página. PrintSettings define una sola vez el papel, la orientación, los márgenes, la escala, el encabezado y el pie de página para la impresora, la vista previa y el PDF. En todas las ediciones, en VCL, FireMonkey, WinForms, WPF y Avalonia (FireMonkey imprime en Windows y macOS). | Ayuda | |
| Exportación a PDF accesible, PDF/UA y PDF/A (con sgcPDF) | ExportToPDF escribe páginas vectoriales con fuentes incrustadas y texto con posibilidad de búsqueda, y cada página es una tabla real con celdas de encabezado para los lectores de pantalla. El archivo es un documento PDF/UA etiquetado por defecto, y PDFALevel añade PDF/A-2a o PDF/A-3a. Necesita el puente sgcUIPDF y un sgcPDF con licencia (esegece.sgcUICore.sgcPDF en .NET). | Registrada | Ayuda |
| Función | Detalles | Community | Ayuda |
|---|---|---|---|
| Temas | Temas claro y oscuro compartidos con todos los productos sgcUI: Theme, AccentColor, altura de fila y ajustes de densidad. | Ayuda | |
| Renderizado sin ventana | SaveToPNG y SaveToSVG escriben la vista actual, y TsgcGridRenderer dibuja un TsgcGridData independiente en PNG o SVG, también en Linux64. | Ayuda | |
| Gráficos desde la cuadrícula | TsgcChartDataSource_Table de sgcCharts representa las filas de la cuadrícula y sigue su ordenación y filtro, sin código intermedio. | Ayuda | |
| Bandas | Títulos sobre grupos de columnas en varios niveles: Bands los contiene y Column.Band sitúa una columna bajo uno de ellos. | Ayuda | |
| Tipos de celda | CellKind pinta una celda como imagen de una lista de imágenes, barra de progreso o minigráfico de líneas, de área o de barras, mientras la celda conserva su valor simple. | Ayuda | |
| Accesibilidad | Expuesta a UI Automation como una tabla con encabezados de columna, filas y celdas, la celda con el foco, la selección, la ordenación, el filtrado, la agrupación y las filas en árbol, la API que usan los lectores de pantalla como Narrator y NVDA. El filtrado, la agrupación y el movimiento de columnas tienen alternativas de teclado (el cambio de ancho de columna requiere el ratón), el anillo de foco siempre es visible y se respeta el alto contraste de Windows. Activada por defecto en VCL (Delphi 7 a 13), FireMonkey en Windows, WinForms, WPF y Avalonia. | Ayuda |
| Función | Detalles | Community | Ayuda |
|---|---|---|---|
| Pregunta a tu cuadrícula | TsgcGridAI convierte una pregunta en lenguaje natural en filtros, ordenaciones y resaltado de filas. Sin proveedor, un analizador local basado en reglas responde sin red y sin clave de API. Con un proveedor, responde cualquier LLM, y el analizador basado en reglas toma el relevo cuando la llamada falla o la respuesta no se valida. | Ayuda | |
| Barra de consultas de IA (VCL y FireMonkey) | TsgcVCLAIQueryBar y TsgcFMXAIQueryBar, FireMonkey en Windows, macOS, iOS y Android: escribe una pregunta, pulsa Intro, lee lo que se aplicó, cancela una pregunta en curso y deshaz la última respuesta, con preguntas recientes y sugerencias. Funciona con el teclado, los lectores de pantalla, el alto contraste y las disposiciones de derecha a izquierda. | Ayuda | |
| Barra de consultas de IA (WinForms, WPF y Avalonia) | TsgcWinFormsAIQueryBar, TsgcWpfAIQueryBar y TsgcAvaloniaAIQueryBar hacen lo mismo en .NET, con el tema claro u oscuro del host. | Ayuda | |
| Cualquier LLM | TsgcUIAIEventProvider entrega cada solicitud a tu propio código en su evento OnRequest, de modo que cualquier servicio de IA, modelo o servidor local puede responder. En .NET, RequestAsync admite un manejador asíncrono. | Ayuda | |
| Proveedor de IA de sgcWebSockets | TsgcUIAIChatProvider del puente sgcUICoreWS usa el componente TsgcAIChat de sgcWebSockets en todas las plataformas. En .NET, el paquete esegece.sgcUICore.sgcWebSockets. Requiere un sgcWebSockets registrado. | Registrada | Ayuda |
| Privacidad | Solo se envían la pregunta y el catálogo de campos: nombres, títulos, tipos y hasta 3 valores de ejemplo por columna por defecto (MaxSampleValues, SendSampleValues), nunca las filas. OnBeforeAsk puede editar o cancelar cada solicitud. | Ayuda |
| Función | Detalles | Community | Ayuda |
|---|---|---|---|
| Datos en vivo | El puente sgcGridWS añade orígenes de datos WebSocket, MQTT y SSE que escriben los mensajes entrantes en la cuadrícula. Necesita sgcWebSockets. | Registrada | Ayuda |
| Pregunta a tu cuadrícula con un asistente | TsgcGridAIQuery, el componente puente anterior, responde mediante un TsgcHTMLAIAssistant. Los proyectos nuevos pueden usar TsgcGridAI con TsgcUIAIChatProvider. | Registrada | Ayuda |
| Capacidad | sgcGrid | Controles estándar de Delphi |
|---|---|---|
| Actualizar filas por clave desde un hilo de trabajo, sin Synchronize | — | |
| Las celdas cambiadas parpadean y se desvanecen | — | |
| Reglas de formato en celdas o filas completas | — | |
| Agrupación con panel de grupos, resúmenes de grupo y de pie | — | |
| Filas en árbol y bandas maestro detalle | — | |
| Exportación a libro de Excel con esquema y fórmulas | — | |
| Renderizado PNG y SVG sin ventana, también en Linux64 | — | |
| Ventana emergente de filtro de columna al estilo Excel, fila de filtro y panel de búsqueda | — | |
| Selector de columnas, menú del encabezado y diseños guardados como JSON | — | |
| Encabezados de banda sobre grupos de columnas | — | |
| Celdas de barra de progreso, minigráfico e imagen sin código de dibujo propio | — | |
| Pegar un rango de celdas desde Excel, con deshacer y rehacer | — |
Solo capacidades, según se documentan en la ayuda. Sin afirmaciones de rendimiento.
La cuadrícula .NET es un port en C# con los mismos nombres de clase, para WinForms, WPF y Avalonia. Empieza con el paquete Community gratuito y pasa a los paquetes registrados para tener todas las funciones.
| Paquete | Edición | Contenido |
|---|---|---|
esegece.sgcGrid.Community | Community (gratuita) | Biblioteca principal |
esegece.sgcGrid | Registrada | Biblioteca principal |
esegece.sgcGrid.WinForms | Registrada | Controles Windows Forms |
esegece.sgcGrid.Wpf | Registrada | Controles WPF |
esegece.sgcGrid.Avalonia | Registrada | Controles Avalonia |
esegece.sgcGrid.Rendering | Registrada | Renderizado sin ventana |
esegece.sgcGrid.sgcWebSockets | Solo registrada | Puente con sgcWebSockets |
esegece.sgcGrid.sgcHTML | Solo registrada | Puente con sgcHTML |
esegece.sgcUICore.sgcWebSockets | Solo registrada | Proveedor de IA de sgcWebSockets (TsgcUIAIChatProvider) |
Cada función de sgcGrid está documentada en la ayuda de sgcUI, con una compilación para cada entorno de desarrollo.
Empieza con la introducción de sgcGrid 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) →