sgcGrid, la cuadrícula de datos en vivo para Delphi, C++ Builder & .NET

Datos en vivo

Actualiza miles de filas por segundo desde cualquier hilo

Un flujo de mercado, un bus de sensores o una cola de trabajos pueden escribir directamente en la cuadrícula. Cada fila tiene una clave, y un hilo de trabajo actualiza la fila de una clave por nombre de campo, sin llamar a Synchronize y sin código de bloqueo propio. La cuadrícula solo se marca como pendiente en el hilo que escribe y se repinta en el hilo principal como máximo MaxFPS veces por segundo.

• UpdateRow asigna los campos indicados de una clave e inserta la fila cuando la clave es nueva; UpdateCell cambia un solo campo
• AppendRow y DeleteRow añaden y eliminan filas por clave, desde cualquier hilo
• BeginUpdate y EndUpdate convierten un lote en una única notificación
• La fila seleccionada se vuelve a encontrar por su clave tras cada reordenación, así que nunca se escapa

Datos en vivo

Colorea las filas que necesitan atención

Una factura vencida, un saldo negativo o un trabajo fallido deben destacar antes de que nadie pregunte. Las reglas de formato comparan una columna con un valor usando el tipo de datos de esa columna: números numéricamente, fechas como fechas, texto sin distinguir mayúsculas. Una regla que coincide asigna el color de fondo, el color del texto o la negrita a la celda o a toda la fila, y sigue funcionando mientras las actualizaciones en vivo cambian los valores.

• TsgcGridFormatRules evalúa sus reglas en el orden de la colección, y una coincidencia posterior anula a una anterior
• Operadores como gfoLess, gfoBetween, gfoContains y gfoIsEmpty
• ApplyToRow da estilo a todas las celdas de la fila, StopOnMatch termina la evaluación de una celda
• Los colores translúcidos tiñen la celda sobre su fondo, y OnGetCellStyle tiene la última palabra

Da forma a los datos

Ordena, filtra y busca en grandes volúmenes de datos

Encontrar un cliente entre miles debería costar unas pocas pulsaciones. FilterText conserva las filas cuyo texto formateado contiene las palabras escritas en cualquier columna visible, y un manejador OnFilterRow añade tus propias reglas encima. Un clic en un encabezado ordena, Ctrl y clic añade una columna a una ordenación multicolumna, y la ordenación es estable. Una columna que cambia sin estar ordenada ni filtrada no cuesta ninguna reordenación.

• SortOrder y SortIndex por columna, OnSortChange tras cada cambio
• FilterText no distingue mayúsculas y lee el texto tal como lo ve el usuario
• OnFilterRow para lógica personalizada, InvalidateView cuando esa lógica cambia
• SelectionMode selecciona filas o celdas, y Ctrl+C las copia como texto separado por tabuladores
• Los valores nulos, vacíos y no convertibles siempre se ordenan primero

Da forma a los datos

Mantén a la vista las columnas clave mientras el resto se desplaza

Las cuadrículas anchas pierden su contexto cuando el símbolo o el nombre del cliente se desplaza fuera de la vista. FrozenColumns mantiene fijas las primeras columnas visibles mientras las demás se desplazan horizontalmente, y el encabezado, el pie y los resúmenes de grupo siguen la misma división. Los usuarios redimensionan las columnas arrastrando el borde del encabezado, y el renderizador sin ventana usa el mismo ajuste, así que las imágenes exportadas coinciden con la pantalla. Los símbolos de grupo de la izquierda tampoco se desplazan nunca.

• FrozenColumns cuenta columnas visibles, y una línea de un píxel marca el borde fijo
• Los movimientos con el teclado traen a la vista una columna desplazada a la derecha del borde fijo
• FrozenWidth del renderizador devuelve el ancho que no se desplaza
• MinWidth limita el cambio de tamaño, OnColumnResized notifica el nuevo ancho
• Forma parte de todas las ediciones, incluida la versión Community gratuita de .NET
• De derecha a izquierda para árabe y hebreo: la primera columna está a la derecha, las columnas fijas se quedan en el borde derecho, y la exportación XLSX de una cuadrícula de derecha a izquierda escribe una hoja de derecha a izquierda

Da forma a los datos

Deja que los usuarios organicen las columnas y que se mantenga así

Un clic derecho en el encabezado de una columna abre un menú que ordena, agrupa, ajusta los anchos, filtra y abre el selector de columnas, una ventana emergente con una casilla por columna. Los usuarios arrastran un encabezado para mover su columna, y un doble clic en el borde del encabezado ajusta el ancho al título y a las celdas. SaveLayoutToString y LoadLayoutFromString guardan todo como un texto JSON breve, de modo que la cuadrícula se abre como el usuario la dejó.

• HeaderMenu, ColumnMoving y BestFitOnDblClick están activados por defecto, y un PopupMenu asignado sigue teniendo prioridad
• ShowColumnChooser abre el selector desde un botón o un elemento de menú propio
• Una columna movida permanece en su lado de las columnas inmovilizadas y dentro de su banda, y OnColumnMoved notifica el movimiento
• BestFitColumn y BestFitColumns miden el encabezado y hasta 1.000 filas de muestra, así que un millón de filas cuesta casi lo mismo que mil
• El diseño guarda el orden de las columnas, los anchos, la visibilidad, la ordenación, la agrupación, los filtros de columna, las bandas y las opciones del panel; SaveLayoutToFile y LoadLayoutFromFile usan un archivo

En las cuadrículas VCL, FireMonkey, WinForms, WPF y Avalonia, incluida la versión Community gratuita de .NET.

Edita y exporta

Enlaza cualquier TDataSet en unas pocas líneas

El código de base de datos existente sigue funcionando: un TsgcGridSource_DataSet rellena la cuadrícula desde una consulta FireDAC, un TClientDataSet o cualquier otro TDataSet. Asigna su Grid y su DataSet, ponlo Active y aparecen las filas. Con un KeyField la cuadrícula se sincroniza en lugar de recargarse, así que las filas cambiadas se actualizan en su sitio y parpadean. Con LiveUpdates activado, cada Append, Edit y Delete confirmado llega a la cuadrícula sin código adicional.

• AutoColumns crea las columnas a partir de los campos del dataset
• Con un KeyField, las claves nuevas se añaden y las que faltan se eliminan
• El dataset se recorre con DisableControls y se restaura su registro actual
• También JSON y CSV: GridLoadFromJSONFile, GridSaveToCSVFile y el resto de sgcGrid_IO
• En .NET la misma clase lee un DataTable

Edita y exporta Solo registrada

Edita el DataSet a través de la cuadrícula

Con WriteBack activado, un TsgcGridSource_DataSet escribe cada edición de la cuadrícula en el registro de su fila. Localiza el registro por KeyField y envía el valor. Cuando el envío falla, por ejemplo en una comprobación de BeforePost, el registro se cancela y la celda conserva su valor anterior. SyncCursor mantiene juntos el registro actual y la fila con el foco, de modo que un TDBNavigator y controles TDBEdit sobre el mismo dataset siguen a la cuadrícula, y la cuadrícula los sigue a ellos.

• AllowInsert: Ins añade y envía un registro, y OnNewRecord del dataset rellena los valores por defecto
• AllowDelete: Ctrl+Supr elimina las filas seleccionadas y sus registros una vez que OnBeforeDelete lo acepta
• Los campos de búsqueda se editan como una lista de selección de los resultados de la búsqueda, y se escribe la clave correspondiente
• OnEditError muestra el mensaje del dataset; los valores pegados y deshacer usan la misma ruta de escritura

En las cuadrículas VCL, FireMonkey, WinForms, WPF y Avalonia; no está en la versión Community de .NET. En .NET el origen escribe de vuelta en un DataTable, AddLookup añade las columnas de búsqueda y SyncCursor es solo de Delphi.

Escala y conecta

Recorre millones de filas sin cargarlas

Los archivos de registro, los históricos de sensores y los resultados de consultas que ya viven en otro sitio no necesitan copiarse en memoria. En modo virtual la cuadrícula no almacena filas: VirtualRowCount indica cuántas hay y OnGetValue devuelve un valor cuando su fila entra en la vista. Solo se pintan las filas visibles, así que una cuadrícula de un millón de filas cuesta lo mismo que una de cincuenta. Cambia el número a medida que crece el origen.

• Virtual y VirtualRowCount en los datos de la cuadrícula, OnGetValue suministra las celdas
• Los resúmenes del pie también leen sus valores mediante OnGetValue
• Las filas virtuales no tienen claves, así que conservan el orden del origen, sin ordenación, filtrado ni parpadeo
• Para flujos que crecen sin fin, MaxRows con TailMode es la alternativa con claves

Imprime, previsualiza y exporta a PDF

Imprime la cuadrícula, previsualízala y exporta un PDF accesible

Una página impresa muestra el contenido de la cuadrícula, no la pantalla. Cada fila se imprime tal como la muestra la cuadrícula, con el filtro, el orden, la agrupación y las coincidencias de búsqueda aplicados, y no solo las filas que se ven al desplazarse. Las filas de banda y los encabezados de columna se repiten en la parte superior de cada página, el pie con los resúmenes cierra cada página, y una página contiene solo filas enteras, de modo que nunca se corta una fila.

• Print muestra el cuadro de diálogo de impresión o imprime directamente en la impresora predeterminada, y ShowPrintPreview abre una vista previa con navegación por páginas, zoom, configuración de página, impresión y exportación a PDF
• PrintSettings contiene el papel, la orientación, los márgenes, la escala y el texto del encabezado y del pie de página, y la impresora, la vista previa y el PDF lo usan todos
• ExportToPDF escribe páginas vectoriales con texto real y con posibilidad de búsqueda, PDF/UA etiquetado por defecto, y cada página es una tabla real con celdas de encabezado, de modo que un lector de pantalla anuncia la tabla con sus encabezados
• PDFALevel de TsgcUIPDFOptions añade PDF/A-2a o PDF/A-3a para archivo, solo o junto con PDF/UA

La impresión y la vista previa están en todas las ediciones, también en la edición Community gratuita, en VCL, FireMonkey, WinForms, WPF y Avalonia. En FireMonkey, la impresión funciona en Windows y macOS, y la vista previa y la exportación a PDF en todas las plataformas. La exportación a PDF necesita el puente sgcUIPDF y un sgcPDF con licencia (el paquete NuGet esegece.sgcUICore.sgcPDF en .NET), por lo que no está en la edición Community.

Accesibilidad

Una cuadrícula expuesta como una tabla real

sgcGrid expone su contenido a Microsoft UI Automation como una tabla con encabezados de columna, filas y celdas, la API que usan los lectores de pantalla como Narrator y NVDA. Solo se construyen las filas visibles, y el número de filas y de columnas es siempre el total, de modo que una cuadrícula con un millón de filas no cuesta nada más.

• La celda con el foco, la selección, la ordenación, el filtrado, la agrupación y las filas en árbol se exponen mediante los patrones Grid, Table y Selection
• Las flechas, Inicio, Fin, Re Pág y Av Pág mueven la celda con el foco, Mayús amplía la selección, Ctrl+Espacio alterna la fila o la celda y F2 o Intro edita
• Alt+Abajo abre la ventana emergente de filtro, Alt+Mayús+Izquierda y Alt+Mayús+Derecha mueven la columna, Ctrl+Mayús+G agrupa por la columna con el foco y Ctrl+Mayús+U quita esa agrupación
• Un anillo de foco visible y, con un tema de alto contraste de Windows, la cuadrícula se pinta con los colores del sistema

La accesibilidad está activada por defecto en todas las ediciones, también en la edición Community gratuita, en VCL en todas las versiones de Delphi y C++Builder desde Delphi 7 hasta Delphi 13, en FireMonkey en Windows, y en WinForms, WPF y Avalonia. En Delphi y C++Builder, AccessibleName y AccessibleDescription establecen el nombre y la descripción expuestos a UI Automation, y en .NET lo hacen el nombre accesible y el texto de ayuda estándar de cada framework. Consulta los informes de conformidad de accesibilidad (en inglés). En Avalonia, que no tiene patrones de tabla, cada celda lleva su columna y su posición en el nombre y en el texto de ayuda. Los anchos de columna solo se cambian con el ratón.