Um grid criado para dados que nunca param. Escreva linhas por chave a partir de qualquer thread, veja as células alteradas piscarem em verde ou vermelho e depois agrupe, filtre, edite e exporte as mesmas linhas. Um quadro 1080p de um grid com 100.000 linhas leva 3,0 ms no Win32.
MaxFPS.Vinte e três recursos em seis grupos, cada um ligado ao seu tópico da ajuda.
Feeds que nunca param: preços, telemetria, filas e logs.
Dados em tempo real
Um feed de mercado, um barramento de sensores ou uma fila de tarefas pode escrever direto no grid. Cada linha tem uma chave, e uma thread de trabalho atualiza a linha de uma chave pelo nome do campo, sem chamar Synchronize e sem código de bloqueio seu. O grid apenas se marca como sujo na thread que escreve e repinta na thread principal no máximo MaxFPS vezes por segundo.
UpdateRow define os campos nomeados de uma chave e insere a linha quando a chave é nova; UpdateCell altera um campoAppendRow e DeleteRow adicionam e removem linhas por chave, a partir de qualquer threadBeginUpdate e EndUpdate transformam um lote em uma única notificação
Dados em tempo real
Traders e operadores precisam ver o que mudou sem ler todos os números. Com FlashChanges ativado, que é o padrão, uma célula alterada é tingida de verde quando o valor subiu e de vermelho quando caiu, e depois some gradualmente ao longo de FlashDuration milissegundos, 800 por padrão. Para logs e feeds que crescem, o modo tail mantém a linha mais nova à vista e para de acompanhar assim que o usuário rola para cima para ler.
FlashUpColor, FlashDownColor e FlashChangedColor; uma cor 0 usa o padrão do temaFlashMode tinge o fundo (fmBackground) ou o texto (fmText)TailMode acompanha a linha mais nova, MaxRows descarta as linhas mais antigas de um log sem fim
Dados em tempo real
Uma fatura vencida, um saldo negativo ou uma tarefa com falha deve se destacar antes que alguém pergunte. As regras de formato comparam uma coluna com um valor usando o tipo de dados dessa coluna: números numericamente, datas como datas, texto sem diferenciar maiúsculas de minúsculas. Uma regra que se aplica define a cor de fundo, a cor do texto ou o negrito na célula ou na linha inteira, e continua funcionando enquanto as atualizações em tempo real mudam os valores por baixo.
TsgcGridFormatRules avalia as regras na ordem da coleção, e uma correspondência posterior sobrepõe uma anteriorgfoLess, gfoBetween, gfoContains e gfoIsEmptyApplyToRow estiliza todas as células da linha, StopOnMatch encerra a avaliação para uma célulaOnGetCellStyle tem a última palavraOnGetCellFont define o estilo e o tamanho da fonte de qualquer célulaAddIconSet coloca setas, círculos, bandeiras ou marcas de seleção em uma coluna a partir de dois limites, e uma regra pode mostrar um ícone ou uma imagem suaOrdene, filtre, agrupe e aninhe grandes conjuntos de linhas.
Dados em tempo real
Uma tela de operador precisa de um só lugar que liste todos os alarmes, mostre quais ainda aguardam reconhecimento e deixe o operador agir sobre eles. O modelo de alarmes guarda os alarmes com os estados ISA-18.2 e as prioridades de 1 a 4, e o vínculo de alarmes os escreve em uma grade, uma linha por tag, com a cor da prioridade e linhas piscantes para os alarmes ainda não reconhecidos. A aplicação dispara e limpa os alarmes a partir dos seus próprios limites, e o operador os reconhece, suspende e retoma pelo menu de contexto.
TsgcGridAlarmModel: RaiseAlarm, ClearAlarm, Acknowledge, AcknowledgeAll, Shelve, UnshelveFilterPriorities, FilterStates e FilterText, e exportação como JSON ou CSVTsgcGridAlarmLink e TsgcVCLGridAlarmMenu, também para FireMonkey e, no .NET, para WinForms, WPF e AvaloniaO modelo, o vínculo e os menus estão em todas as edições, inclusive a Community. O log de reconhecimento com Log e OnLog é da edição Registrada. A lista de alarmes faz parte do Pacote HMI do sgcUI.
Dê forma aos dados
Vendas por região, pedidos por mês, tickets por status: os usuários querem totais, não linhas brutas. GroupBy agrupa o grid por uma ou mais colunas, e cada linha de grupo mostra o seu membro, a contagem de linhas e os resumos das suas linhas. Os usuários reagrupam por conta própria arrastando um cabeçalho para o painel de grupos. O agrupamento é somente estado da visualização, então um gráfico vinculado ao grid continua vendo as linhas planas e ordenadas.
GroupBy e ClearGrouping por código, ou GroupIndex por colunaShowGroupPanel adiciona chips de arrastar e soltar; um clique em um chip inverte a ordem dos gruposSummaryType gsuSum, gsuCount, gsuAverage, gsuMin ou gsuMax, formatado com SummaryFormatGroupSummaries em cada linha de grupo e ShowFooter para os totais geraisDisplayFormat de yyyy-mm agrupa as datas por mês
Dê forma aos dados
Encontrar um cliente entre milhares deve levar poucas teclas. FilterText mantém as linhas cujo texto formatado contém as palavras digitadas em qualquer coluna visível, e um handler OnFilterRow acrescenta as suas próprias regras por cima. Um clique em um cabeçalho ordena, Ctrl e clique adiciona uma coluna a uma ordenação por várias colunas, e a ordenação é estável. Uma coluna que muda o tempo todo, mas não está ordenada nem filtrada, não custa nenhuma reordenação.
SortOrder e SortIndex por coluna, OnSortChange após cada mudançaFilterText não diferencia maiúsculas de minúsculas e lê o texto como o usuário o vêOnFilterRow para lógica personalizada, InvalidateView quando essa lógica mudaSelectionMode seleciona linhas ou células, e Ctrl+C as copia como texto separado por tabulações
Dê forma aos dados Somente Registrada
Um organograma ou uma lista de materiais fica melhor como árvore, e os pedidos de um cliente ficam melhor logo abaixo do cliente. As linhas em árvore organizam as linhas em profundidade a partir de uma coluna de chave e de uma coluna pai. As faixas de detalhe abrem um pequeno grid de linhas relacionadas sob qualquer linha mestre, com cabeçalho, rolagem e ordenação próprios, preenchido por um TsgcGridDataStore, outro grid ou um evento.
Tree.KeyField e Tree.ParentField ativam a árvore; ExpandNode e CollapseNode funcionam por códigoDetail.MasterKeyField e Detail.DetailKeyField ligam uma faixa à sua origem, OnGetDetailData a preenche sob demandaNão está na versão .NET Community, que mantém o agrupamento.
Ler o tópico da ajuda
Dê forma aos dados Somente Registrada
Uma lista de contatos, um catálogo de produtos ou uma fila de chamados costuma ficar melhor como cartões do que como tabela. Com ViewStyle definido como gvsCard, o grid desenha cada linha como um cartão: uma barra de título opcional, uma imagem opcional e uma linha por coluna visível com o seu título e o seu valor. Os cartões mostram as mesmas linhas da tabela, então ordenação, filtros, painel de localização, seleção, edição e modo servidor funcionam nas duas visões, e uma propriedade alterna entre elas em tempo de execução.
CardOptions define o CaptionField, o ImageField acima ou ao lado dos campos, o CardWidth e o número de cartões por faixaA visão de cartões não agrupa e não desenha cabeçalho de coluna, linha de filtro nem rodapé. Nas grades VCL, FireMonkey, WinForms, WPF e Avalonia, não na versão .NET Community.
Ler o tópico da ajuda
Dê forma aos dados
Grids largos perdem o contexto quando o símbolo ou o nome do cliente sai da tela ao rolar. FrozenColumns mantém as primeiras colunas visíveis no lugar enquanto as outras rolam na horizontal, e o cabeçalho, o rodapé e os resumos de grupo seguem a mesma divisão. Os usuários redimensionam colunas arrastando a borda do cabeçalho, e o renderizador headless usa a mesma configuração, então as imagens exportadas coincidem com a tela. As setas de grupo à esquerda também nunca rolam.
FrozenColumns conta colunas visíveis, e uma linha de um pixel marca a borda congeladaFrozenWidth do renderizador retorna a largura que não rolaMinWidth limita um redimensionamento, OnColumnResized informa a nova largura
Dê forma aos dados
Os usuários esperam o funil que conhecem do Excel. ShowFilterButtons coloca um no cabeçalho de cada coluna: ele abre um popup com os valores distintos da coluna e a contagem de linhas, uma caixa de busca e até duas condições tipadas unidas por And ou Or. ShowFilterRow adiciona abaixo do cabeçalho uma linha que filtra uma coluna enquanto o usuário digita, e Ctrl+F abre o painel de localização, que destaca o texto em todas as células e salta de uma ocorrência para outra.
Column.Filter no código, então os três sempre concordamFilterRowOperator por coluna: igual a, maior que, contém, começa com, está em branco e maisFindText, FindNext e FindPrevious funcionam a partir do código, e FindOnlyMatches oculta as linhas sem ocorrênciaFilterText e OnFilterRow, e OnFilterChange informa cada mudançaFirstDayOfWeekNas grades VCL, FireMonkey, WinForms, WPF e Avalonia, inclusive a versão .NET Community gratuita.
Ler o tópico da ajudaDê forma aos dados
Um clique com o botão direito no cabeçalho de uma coluna abre um menu que ordena, agrupa, ajusta as larguras, filtra e abre o seletor de colunas, um popup com uma caixa de seleção por coluna. Os usuários arrastam um cabeçalho para mover a coluna, e um clique duplo na borda do cabeçalho ajusta a largura ao título e às células. SaveLayoutToString e LoadLayoutFromString guardam tudo como um texto JSON curto, de modo que a grade abre do jeito que o usuário a deixou.
HeaderMenu, ColumnMoving e BestFitOnDblClick vêm ativados por padrão, e um PopupMenu atribuído continua tendo prioridadeShowColumnChooser abre o seletor a partir de um botão ou de um item de menu seuOnColumnMoved informa o movimentoBestFitColumn e BestFitColumns medem o cabeçalho e até 1.000 linhas de amostra, então um milhão de linhas custa quase o mesmo que milSaveLayoutToFile e LoadLayoutFromFile usam um arquivoAutoSaveLayout salva o layout quando a grade é fechada e o restaura na próxima execução, e Redefinir layout no menu do cabeçalho traz de volta as colunas de tempo de designAutoFitColumns faz as colunas preencherem a largura da grade, e MaxWidth limita uma coluna quando ela é redimensionada ou ajustadaNas grades VCL, FireMonkey, WinForms, WPF e Avalonia, inclusive a versão .NET Community gratuita.
Ler o tópico da ajuda
Dê forma aos dados
Uma tela de trading fica mais legível quando Last, Change e Trend estão sob um mesmo título Price. Bands adiciona títulos sobre grupos de colunas, em quantos níveis você precisar, e cada coluna informa sua banda em Band. CellKind desenha uma célula como imagem, barra de progresso ou sparkline, enquanto a célula mantém seu valor simples, então a ordenação, o agrupamento e a exportação continuam vendo o número.
Bands.Add recebe um título e uma banda pai, e as linhas de banda se empilham acima do cabeçalho da colunagcdProgress usa ProgressMin e ProgressMax; gcdSparkline desenha um gráfico de linha, área ou barras a partir de uma lista de númerosgcdTags mostra vários chips coloridos em uma célula a partir de um texto como "Urgent, Pending review", com TagColors e OnGetTagStyle para cores própriasgcdImage desenha uma imagem de CellImages, que a grade preenche a partir de qualquer lista de imagens atribuída a ImagesTrueValue e FalseValue transformam uma coluna que armazena valores como "S" e "N" em caixas de seleção, e gcdLink mostra um link que aciona OnLinkClickHeaderLines, RowLines e WordWrap mostram títulos e textos de célula em várias linhas, e HeaderImageIndex e HeaderButton colocam uma imagem e um botão no cabeçalho de uma colunaShowTruncatedHints mostra o texto completo de uma célula ou título cortado como dica, e OnGetCellHint define a sua própria dica por célulaSelectionMode gsmMultiRow seleciona qualquer conjunto de linhas com Ctrl e Shift, gsmCellRange um intervalo de células, e Ctrl+A seleciona tudoRowHeader adiciona uma faixa com o indicador de registro, os números de linha e uma caixa de seleção por linha, e SelectionColor e SelectionTextColor definem as cores da seleçãoRowDragMode arrasta as linhas selecionadas para outro controle e, na VCL, para outros aplicativos como o ExcelNas grades VCL, FireMonkey, WinForms, WPF e Avalonia, inclusive a versão .NET Community gratuita.
Ler o tópico da ajudaAltere os dados, sincronize com o seu banco de dados e entregue-os adiante.
Edite e exporte Somente Registrada
Os usuários de back office esperam corrigir uma quantidade ou um status direto no grid. Defina ReadOnly como False e F2, Enter, um caractere digitado ou um duplo clique abre um editor sobre a célula, ou um combo box quando a coluna tem um PickList. O texto digitado é convertido para o tipo de dados da coluna, OnValidate pode alterar ou rejeitar o valor, e o resultado é gravado com UpdateCell, então a ordenação e o flash continuam valendo.
Editable por coluna, e OnBeforeEdit pode recusar uma ediçãoStartEdit, CommitEdit e CancelEdit fazem o mesmo por códigoOnEditError mantém o editor aberto diante de uma entrada inválida, OnEdited informa o valor antigo e o novoNão está na versão .NET Community.
Ler o tópico da ajuda
Edite e exporte
O código de banco de dados existente continua funcionando: um TsgcGridSource_DataSet preenche o grid a partir de uma consulta FireDAC, um TClientDataSet ou qualquer outro TDataSet. Defina o seu Grid e o seu DataSet, deixe-o Active, e as linhas aparecem. Com um KeyField, o grid é sincronizado em vez de recarregado, então as linhas alteradas são atualizadas no local e piscam. Com LiveUpdates ativado, cada Append, Edit e Delete confirmado chega ao grid sem código extra.
AutoColumns cria as colunas a partir dos campos do datasetKeyField, as chaves novas são adicionadas e as ausentes são excluídasDisableControls e o seu registro atual é restauradoGridLoadFromJSONFile, GridSaveToCSVFile e o restante de sgcGrid_IOgcdImage, e ImagePreview mostra uma cópia maior quando o mouse repousa sobre a célulaApplyFilter faz o DataSet manter apenas as linhas que a grade mostra, e OnApplySort repassa a ordenação da grade como nomes de campos para a sua consultaEdite e exporte Somente Registrada
A contabilidade quer os números no Excel, não uma captura de tela. SaveToXLSX grava o grid como uma planilha Office Open XML em um arquivo ou em um stream, sem biblioteca externa. A planilha mantém o que o usuário vê: as colunas visíveis na ordem de exibição com suas larguras e formatos numéricos, o cabeçalho congelado, os grupos e os níveis da árvore como uma estrutura de tópicos recolhível, e os totais dos grupos como fórmulas SUBTOTAL.
SaveToXLSX recebe um nome de arquivo ou um stream e um nome de planilha opcionalDisplayFormat vira o formato numérico da célulaNão está na versão .NET Community, que mantém a exportação para JSON e CSV.
Ler o tópico da ajudaEdite e exporte Somente Registrada
O comercial envia uma planilha e quer uma simulação rápida, não mais uma ida e volta pelo Excel. Com ExcelMode definido como True, o grid se comporta como uma planilha leve: os usuários selecionam um intervalo, arrastam a alça de preenchimento para continuar uma série, digitam fórmulas que começam com =, formatam células e trabalham em várias planilhas. LoadFromXLSX abre a própria planilha, a partir de um arquivo ou de um stream, sem biblioteca externa e sem o Excel instalado.
OnBeforeFill pode vetá-loFormatSelection ou Ctrl+B, Ctrl+I, Ctrl+U e Ctrl+5; cada mudança de formato é um passo de desfazerShowSheetTabs uma faixa de abas as adiciona, renomeia, exclui e reordena, as fórmulas leem outras planilhas com referências como Orders!E1:E20 ou 'Q4 Notes'!B1, e renomear uma planilha reescreve essas referênciasSaveToXLSX grava todas as planilhas com seu nome, seus formatos de célula e suas fórmulas como fórmulas do Excel com os valores calculados em cache; as linhas saem na ordem do armazenamento, para que as referências permaneçam exatasLoadFromXLSX lê todas as planilhas da pasta de trabalho no modo Excel, ou uma planilha por nome ou índice, monta as colunas a partir da linha de cabeçalho com tipos inferidos e lê strings, números, booleanos e datas, incluindo o sistema de datas de 1904Formula de coluna como =C1*D1 é escrita para a linha 1 e calcula todas as linhas de uma coluna somente leitura, em dados na memória, no modo virtual e sobre uma origem DataSet; no modo virtual, os textos de fórmula retornados por OnGetValue também são avaliadosNão é uma planilha completa: sem gráficos, sem células mescladas e sem fórmulas de célula sobre uma origem DataSet, onde as fórmulas de coluna as substituem. No VCL, FireMonkey, WinForms, WPF e Avalonia, não na versão .NET Community.
Ler o tópico da ajuda Ler o tópico da formatação de células Ler o tópico das planilhas Ler o tópico das fórmulas de coluna
Edite e exporte Somente Registrada
Com WriteBack ativado, um TsgcGridSource_DataSet grava cada edição da grade no registro da sua linha. Ele localiza o registro por KeyField e envia o valor. Quando o envio falha, por exemplo em uma verificação de BeforePost, o registro é cancelado e a célula mantém o valor anterior. SyncCursor mantém juntos o registro atual e a linha com foco, de modo que um TDBNavigator e controles TDBEdit sobre o mesmo dataset acompanham a grade, e a grade os acompanha.
AllowInsert: Ins acrescenta e envia um registro, e OnNewRecord do dataset preenche os valores padrãoAllowDelete: Ctrl+Del exclui as linhas selecionadas e seus registros depois que OnBeforeDelete concordaOnEditError mostra a mensagem do dataset; os valores colados e o desfazer usam o mesmo caminho de gravaçãoNas grades VCL, FireMonkey, WinForms, WPF e Avalonia; não está na versão .NET Community. No .NET a fonte grava de volta em um DataTable, AddLookup adiciona as colunas de lookup e SyncCursor existe apenas no Delphi.
Edite e exporte Somente Registrada
Cada coluna escolhe o controle que a edita. EditorKind escolhe um seletor de data, de hora ou de data e hora, um spin edit, um seletor de cor ou um editor de tokens do sgcEditors, e o padrão é escolhido pelo tipo de dado da coluna. Ctrl+V cola um bloco copiado do Excel: cada valor é convertido e validado antes de qualquer gravação, e toda a colagem é um único passo de desfazer. Ctrl+Z e Ctrl+Y desfazem e refazem edições e colagens.
OnCreateEditor coloca em uma célula qualquer controle seu, por exemplo um TTrackBargedMemo edita textos longos em várias linhas, e gedLookup escolhe um valor de uma lista com várias colunas, preenchida a partir de LookupItems ou de um campo de lookupTrueValue ou FalseValuePasteText e PasteFromClipboard funcionam a partir do código, e OnBeforePaste pode alterar ou recusar o textoOnValidate rejeita, interrompe a colagem antes de qualquer gravaçãoUndoLimit guarda os últimos 100 passos; Undo, Redo e CanUndo funcionam a partir do códigoNas grades VCL, FireMonkey, WinForms, WPF e Avalonia; não está na versão .NET Community.
Ler o tópico da ajudaMilhões de linhas, feeds em tempo real e linguagem natural.
Escale e conecte
Arquivos de log, históricos de sensores e resultados de consultas que já vivem em outro lugar não precisam ser copiados para a memória. No modo virtual, o grid não armazena linhas: VirtualRowCount diz quantas existem, e OnGetValue retorna um valor quando a sua linha rola para a vista. Somente as linhas visíveis são pintadas, então um grid de um milhão de linhas custa o mesmo que um de cinquenta. Altere a contagem conforme a fonte cresce.
Virtual e VirtualRowCount nos dados do grid, OnGetValue fornece as célulasOnGetValueMaxRows com TailMode é a alternativa com chaves
Escale e conecte Somente Registrada
Um histórico de pedidos ou uma tabela de auditoria é grande demais para ser carregada, e mesmo assim os usuários querem ordená-la, filtrá-la e agrupá-la. No modo servidor, um componente provedor lê uma página de linhas por vez, e a fonte de dados avalia a ordenação, os filtros de coluna, a linha de filtro, o texto de localização, os resumos do rodapé, o agrupamento e a contagem de linhas. Uma tabela de milhões de linhas abre tão rápido quanto uma de cinquenta, e somente as páginas exibidas são lidas.
TsgcGridServerProvider_DataSet transforma cada pedido em uma instrução SQL para SQLite, SQL Server, PostgreSQL, MySQL, Oracle, Firebird, InterBase ou um dialeto genérico, executada por qualquer componente de consulta: FireDAC, dbExpress, ADO, IBX, UniDAC, Zeos e outrosTsgcGridServerProvider_Queryable lê qualquer IQueryable, um conjunto do Entity Framework Core por exemplo, e TsgcGridServerProvider_AdoNet executa o mesmo SQL em qualquer conexão ADO.NETTsgcGridServerProvider_Callback atende qualquer outra fonte, um serviço REST por exemplo, por eventos respondidos na hora ou depois, a partir de qualquer threadPageSize por meio de um cache; a pintura nunca espera, e as linhas ainda não carregadas mostram barras provisórias até a página chegarLinhas em árvore e faixas de detalhe não estão disponíveis no modo servidor, e o popup de filtro não mostra contagens de linhas. Nas grades VCL, FireMonkey, WinForms, WPF e Avalonia, não na versão .NET Community.
Ler o tópico da ajudaEscale e conecte
Nem todo usuário quer montar filtros. O TsgcGridAI transforma uma pergunta como price greater than 100 sort by volume descending highlight change less than 0 em filtros, ordenações e destaques de linha no grid, e a barra de consulta de IA dá aos usuários um lugar para digitá-la. Sem um provedor atribuído, um parser baseado em regras responde localmente, sem rede e sem chave de API. Atribua um provedor e qualquer LLM responde no lugar: o TsgcUIAIEventProvider entrega cada solicitação ao seu próprio código, e o TsgcUIAIChatProvider usa o componente TsgcAIChat do sgcWebSockets. Apenas o catálogo de campos é enviado, os nomes, legendas, tipos e alguns valores de exemplo das colunas, nunca as linhas.
TsgcVCLAIQueryBar, TsgcFMXAIQueryBar, TsgcWinFormsAIQueryBar, TsgcWpfAIQueryBar e TsgcAvaloniaAIQueryBar, com perguntas recentes, sugestões, Cancelar e DesfazerOnFilterRow, os destaques viram regras de formato ApplyToRowUndo volta um passoLastExplanation informa o que foi aplicado e, quando o provedor falha, o parser baseado em regras respondeTsgcGridAIQuery com o TsgcHTMLAIAssistant e traz TsgcGridFeedSource_WebSocket, TsgcGridFeedSource_MQTT e TsgcGridFeedSource_SSE, que gravam mensagens JSON no grid por chaveTodas as edições, inclusive a Community, em VCL, FireMonkey, WinForms, WPF e Avalonia. O provedor do sgcWebSockets e a ponte sgcGridWS exigem o sgcWebSockets e uma edição Registrada.
Ler o tópico da ajudaA pré-visualização mostra exatamente o que a impressora e o PDF recebem.
Imprima, pré-visualize e exporte para PDF
Uma página impressa mostra o conteúdo da grade, não a tela. Cada linha é impressa como a grade a mostra, com o filtro, a ordenação, o agrupamento e as ocorrências da busca aplicados, e não apenas as linhas visíveis na rolagem. As linhas de banda e os cabeçalhos de coluna se repetem no topo de todas as páginas, o rodapé com os resumos fecha cada página, e uma página contém apenas linhas inteiras, de modo que uma linha nunca é cortada.
Print mostra a caixa de diálogo de impressão ou imprime direto na impressora padrão, e ShowPrintPreview abre uma pré-visualização com navegação por páginas, zoom, configuração de página, impressão e exportação para PDFPrintSettings guarda o papel, a orientação, as margens, a escala e o texto do cabeçalho e do rodapé, e a impressora, a pré-visualização e o PDF usam todos o mesmo conjuntoExportToPDF grava páginas vetoriais com texto real e pesquisável, PDF/UA com tags por padrão, e cada página é uma tabela real com células de cabeçalho, de modo que um leitor de tela anuncia a tabela com seus cabeçalhosPDFALevel de TsgcUIPDFOptions adiciona PDF/A-2a ou PDF/A-3a para arquivamento, sozinho ou junto com o PDF/UAA impressão e a pré-visualização estão em todas as edições, inclusive na edição Community gratuita, em VCL, FireMonkey, WinForms, WPF e Avalonia. No FireMonkey, a impressão funciona no Windows e no macOS, e a pré-visualização e a exportação para PDF em todas as plataformas. A exportação para PDF exige a ponte sgcUIPDF e um sgcPDF licenciado (o pacote NuGet esegece.sgcUICore.sgcPDF no .NET), por isso não está na edição Community.
UI Automation para leitores de tela, o teclado e o alto contraste, sem nenhuma configuração.
Acessibilidade
O sgcGrid expõe seu conteúdo ao Microsoft UI Automation como uma tabela com cabeçalhos de coluna, linhas e células, a API que leitores de tela como o Narrator e o NVDA usam. Apenas as linhas visíveis são construídas, e as contagens de linhas e colunas são sempre as totais, portanto uma grade com um milhão de linhas não custa nada a mais.
A acessibilidade vem ativada por padrão em todas as edições, inclusive a edição Community gratuita, no VCL em todas as versões do Delphi e do C++Builder do Delphi 7 ao Delphi 13, no FireMonkey no Windows e no WinForms, WPF e Avalonia. No Delphi e no C++Builder, AccessibleName e AccessibleDescription definem o nome e a descrição expostos ao UI Automation, e no .NET o nome acessível e o texto de ajuda padrão de cada framework fazem o mesmo. Veja os relatórios de conformidade de acessibilidade. No Avalonia, que não tem os padrões de tabela, cada célula leva sua coluna e sua posição no nome e no texto de ajuda. As larguras das colunas são redimensionadas somente com o mouse.
sgcGrid dentro das demos da suíte sgcUI: aplicações completas que rodam offline com dados simulados integrados.
Posições agrupadas por mesa e estratégia, células de P&L coloridas, execuções a um clique de distância.
Altamira Markets →
Clientes agrupados por região com totais e um cartão de contato vinculado.
Altamira ERP →
Um registro de riscos agrupado por programa com linhas de mitigação.
Altamira PMO →
Uma grade de veículos com ETA, folga e status por caminhão, ao lado do mapa nacional.
Altamira Fleet →Últimas médias medidas do gate de desempenho de QA do sgcGrid: um quadro de 1920 x 1080 com 12 colunas, 100.000 linhas e 45 linhas visíveis, renderizado 60 vezes no canvas raster. O gate falha acima de 16 ms por quadro no Win64 e de 25 ms no Win32.
| Medição | Resultado | Condições |
|---|---|---|
| Quadro simples | 3,0 ms | Win32 |
| Quadro simples | 4,6 ms | Win64 |
| Quadro simples | 3,7 ms | Linux64 |
| Flash e 3 regras de formato | 3,2 ms | Win32 |
| Flash e 3 regras de formato | 6,8 ms | Win64 |
| Demo LiveTicker, gravações da thread de trabalho | Cerca de 1.000 atualizações por segundo | Grid ordenado e com flash a 60 fps |
Um quadro de cotações precisa continuar legível enquanto centenas de preços mudam a cada segundo. As threads de feed escrevem com UpdateRow e nunca esperam pela interface, o flash na mudança mostra a direção de cada movimento, e o modo tail mantém o log de negócios na execução mais recente. A ponte sgcGridWS pode ler as cotações por WebSocket, MQTT ou SSE.
As telas de entrada de pedidos, listas de estoque e faturamento vivem em um banco de dados. Vincule o TDataSet existente, deixe os usuários agruparem por cliente ou mês com totais em cada linha de grupo, corrigirem valores no local com validação e exportarem uma planilha que a contabilidade abre com os grupos e as fórmulas SUBTOTAL intactos.
As telas de operações mostram fluxos de eventos que nunca terminam. MaxRows limita o log, as regras de formato pintam os erros de vermelho, e o modo virtual navega por um arquivo de milhões de linhas sob demanda. Em um servidor Linux64, o renderizador grava o mesmo grid em um arquivo PNG ou SVG para um e-mail de alerta.
A mesma API em Delphi, C++ Builder e C#: adicione colunas, anexe linhas por chave e atualize-as depois a partir de qualquer thread.
Um grid VCL em código: colunas tipadas, linhas anexadas por chave e uma atualização por nome de campo a partir de qualquer thread.
uses
Forms, Classes, Controls,
sgcGrid_Columns, sgcGrid_Data, sgcGrid_VCL;
procedure CreateGrid(aForm: TForm);
var
oGrid: TsgcVCLGrid;
begin
oGrid := TsgcVCLGrid.Create(aForm);
oGrid.Parent := aForm;
oGrid.Align := alClient;
// the columns: FieldName, Caption and DataType
oGrid.Columns.Add('Symbol', 'Symbol');
oGrid.Columns.Add('Price', 'Price', gdtFloat).DisplayFormat := '0.00';
oGrid.Columns.Add('Volume', 'Volume', gdtInteger);
// one row per key, the values in column order
oGrid.Data.AppendRow('MSFT', ['MSFT', 412.5, 1200]);
oGrid.Data.AppendRow('AAPL', ['AAPL', 228.1, 3400]);
// later, from any thread: update the row of a key by field name
oGrid.Data.UpdateRow('MSFT', ['Price', 'Volume'], [413.1, 1350]);
end;O mesmo grid no C++ Builder com os headers gerados do sgcGrid.
#include "sgcGrid_Columns.hpp"
#include "sgcGrid_Data.hpp"
#include "sgcGrid_VCL.hpp"
void __fastcall CreateGrid(TForm *Form)
{
TsgcVCLGrid *Grid = new TsgcVCLGrid(Form);
Grid->Parent = Form;
Grid->Align = alClient;
// the columns: FieldName, Caption and DataType
Grid->Columns->Add("Symbol", "Symbol", gdtText);
Grid->Columns->Add("Price", "Price", gdtFloat)->DisplayFormat = "0.00";
Grid->Columns->Add("Volume", "Volume", gdtInteger);
// one row per key, the values in column order
Grid->Data->AppendRow("MSFT", OPENARRAY(Variant,
(Variant("MSFT"), Variant(412.5), Variant(1200))));
Grid->Data->AppendRow("AAPL", OPENARRAY(Variant,
(Variant("AAPL"), Variant(228.1), Variant(3400))));
// later, from any thread: update the row of a key by field name
Grid->Data->UpdateRow("MSFT",
OPENARRAY(String, (String("Price"), String("Volume"))),
OPENARRAY(Variant, (Variant(413.1), Variant(1350))));
}Um grid WinForms com células que piscam, uma regra de mudança negativa e o tema escuro.
using System.Windows.Forms;
using esegece.sgcGrid;
using esegece.sgcUICore;
internal class MainForm : Form
{
private readonly TsgcWinFormsGrid Grid = new TsgcWinFormsGrid();
public MainForm()
{
Grid.Dock = DockStyle.Fill;
// the columns: field name, caption and data type
Grid.Columns.Add("symbol", "Symbol");
Grid.Columns.Add("price", "Price", TsgcGridDataType.gdtFloat).DisplayFormat = "#,##0.00";
Grid.Columns.Add("change", "Change", TsgcGridDataType.gdtFloat).DisplayFormat = "+0.00;-0.00;0.00";
Grid.Columns.Add("volume", "Volume", TsgcGridDataType.gdtInteger).DisplayFormat = "#,##0";
// changed cells flash and fade, negative rows are tinted red
Grid.FlashChanges = true;
Grid.FormatRules.Add("change", TsgcGridFormatOperator.gfoLess, "0", 0x30E53935).ApplyToRow = true;
Grid.Theme = TsgcUITheme.utDark;
// one row per key, the values follow the column order
Grid.Data.AppendRow("MSFT", "MSFT", 412.5, 0.0, 1200);
Grid.Data.AppendRow("AAPL", "AAPL", 228.1, 0.0, 3400);
Controls.Add(Grid);
}
// call it from any thread: TsgcGridData is thread safe
public void OnQuote(string aSymbol, double aPrice, double aChange, int aVolume)
{
Grid.Data.UpdateRow(aSymbol, new[] { "price", "change", "volume" },
new object[] { aPrice, aChange, aVolume });
}
}dotnet add package esegece.sgcGrid.WinForms19 demos para Delphi, cinco deles em FireMonkey, 13 para C++ Builder e 24 para .NET em WinForms, WPF e Avalonia.
Cerca de 1.000 atualizações de preço por segundo a partir de uma thread de trabalho com UpdateRow, uma visualização ordenada, células que piscam e uma regra de formato para variações negativas. VCL, FireMonkey, C++ Builder, WinForms, WPF e Avalonia.
Um TsgcGridSource_DataSet vinculado a um TClientDataSet de 200 registros com KeyField, AutoColumns e LiveUpdates, além de exportação e importação de JSON e CSV.
Modo Excel com três planilhas em uma faixa de abas: Orders, cuja coluna Total tem a fórmula de coluna =C1*D1, Summary, com =SUM(Orders!E1:E20) e outras fórmulas entre as planilhas, e Notes. Uma barra de ferramentas formata a seleção, executa os comandos de planilha e salva e abre arquivos XLSX com as fórmulas, os formatos e os nomes das planilhas. VCL, FireMonkey (SpreadsheetFMX), C++ Builder, WinForms, WPF e Avalonia.
200.000 pedidos gerados em um banco de dados FireDAC SQLite na memória, paginados por TsgcGridServerProvider_DataSet. Alterne entre a tabela e os cartões, ordene, filtre, localize, some o rodapé, agrupe por país e cliente com as contagens e somas calculadas por SQL e grave as edições de volta no banco de dados. VCL e C++ Builder; ServerModeAndCardsFMX pagina 100.000 linhas geradas por meio de TsgcGridServerProvider_Callback, e as demos WinForms, WPF e Avalonia têm páginas com ADO.NET, IQueryable e callback.
100.000 pedidos agrupados por Region e Category com o painel de grupos, resumos de Count, Sum e Average, um rodapé e duas colunas congeladas. No .NET se chama Grouping.
100.000 linhas de vendas com os popups de funil, a linha de filtro e o painel de localização, além do seletor de colunas, do ajuste automático e de um layout salvo em arquivo e carregado de volta. VCL, FireMonkey, C++ Builder, WinForms, WPF e Avalonia.
2.000 instrumentos sob as bandas Instrument, Live data, Price e Position, com células de sparkline, progresso e imagem, seleção de várias linhas e um botão Copy. VCL, C++ Builder e WinForms.
Uma coluna com lista de opções, uma coluna booleana alternada com Espaço, OnValidate rejeitando quantidades negativas, OnEditError e um log de OnEdited, além de editores de data, hora, spin, cor e token do sgcEditors, um TTrackBar por meio de OnCreateEditor, colar, desfazer e refazer.
Produtos e categorias em dois TClientDataSets, com um TDBNavigator e dois TDBEdit sobre os mesmos registros: WriteBack, SyncCursor, uma coluna de lookup, inserção, exclusão e desfazer. VCL, C++ Builder e WinForms (um DataTable com AddLookup).
Uma árvore de organograma e clientes com uma faixa de detalhe de pedidos preenchida por um TsgcGridDataStore.
Um grid agrupado e um grid em árvore salvos com SaveToXLSX e abertos no aplicativo de planilhas, com estrutura de tópicos e resumos mantidos.
Um tile de grid e um tile de gráfico em um dashboard: um TsgcChartDataSource_Table plota as linhas do grid. Exige sgcCharts e sgcDashboard.
O TsgcGridAI e a barra de consulta de IA filtram, ordenam e destacam 200 ações a partir de perguntas em linguagem natural, sem rede e sem chave de API, junto com a ponte TsgcGridAIQuery. Exige o sgcWebSockets.
Um servidor WebSocket no mesmo processo transmite lotes JSON de 50 símbolos, e um TsgcGridFeedSource_WebSocket os grava no grid por chave. Delphi e .NET.
Executáveis prontos para rodar de todos os produtos sgcUI, sem nada para instalar.
Baixar sgcUI_bin.zip →Cinco demos QuickStart para Delphi (VCL) acompanham o produto em Demos\Grid\Delphi\00.QuickStart. O guia em PDF as explica passo a passo: uma primeira grade, colunas tipadas, edição direta na célula, uma conexão com dataset, e uma aplicação de pedidos com filtros, agrupamento e totais.
O sgcGrid é vendido isoladamente, faz parte de todas as edições do sgcUI a partir da Standard e está no pacote All-Access.
€199 / desenvolvedor, código-fonte completo, 1 ano de atualizações.
Comprar o sgcGrid → Ver preços →Standard mais sgcCharts, sgcDashboard e sgcGauges, a partir de €529.
Ver Professional →A edição .NET Community gratuita é o esegece.sgcGrid.Community no NuGet. Um projeto referencia os pacotes Community ou os Registrados, nunca os dois. A edição Delphi Community gratuita está na página de download.
| Recurso | Community (gratuita) | Registrada |
|---|---|---|
| Atualizações em tempo real a partir de qualquer thread, flash na mudança, modo tail | ✓ | ✓ |
| Regras de formato com estilos de fonte e conjuntos de ícones, temas | ✓ | ✓ |
| Ordenação, filtro e seleção | ✓ | ✓ |
| Agrupamento, painel de grupos e resumos | ✓ | ✓ |
| Colunas congeladas e redimensionamento de colunas | ✓ | ✓ |
| Modo virtual | ✓ | ✓ |
| Vinculação a DataTable, o filtro da grade aplicado ao DataTable, JSON e CSV | ✓ | ✓ |
| PNG e SVG headless | ✓ | ✓ |
| Filtros de coluna com períodos de data, linha de filtro e painel de localização | ✓ | ✓ |
| Seletor de colunas, reordenação de colunas, ajuste automático, layouts automáticos e colunas que preenchem a largura | ✓ | ✓ |
| Bandas, células de imagem, progresso, sparkline e tag, seleção múltipla | ✓ | ✓ |
| Células de caixa de seleção e de link, imagens de campos BLOB, cabeçalhos e linhas com várias linhas, dicas | ✓ | ✓ |
| Cabeçalho de linha com caixas de seleção, imagens e botões no cabeçalho, cores da seleção, arrastar e soltar linhas | ✓ | ✓ |
| Pergunte ao grid: TsgcGridAI, a barra de consulta de IA e qualquer provedor de LLM | ✓ | ✓ |
| Edição no local, alternância de caixas de seleção, editores memo e lookup | − | ✓ |
| Edição bidirecional de DataTable, colar, desfazer e refazer, editores de célula do sgcEditors | − | ✓ |
| Linhas em árvore e mestre-detalhe | − | ✓ |
| Exportação para Excel | − | ✓ |
| Modo Excel, formatação de células, planilhas e fórmulas de coluna | − | ✓ |
| Modo servidor: paginação, ordenação, filtros, resumos e agrupamento de banco de dados no servidor | − | ✓ |
| Visão de cartões | − | ✓ |
| Feeds em tempo real, TsgcGridAIQuery e o provedor de IA do sgcWebSockets (pontes sgcGridWS e sgcUICoreWS) | − | ✓ |
| Componente | Destino |
|---|---|
| TsgcVCLGrid | Delphi e C++ Builder, VCL (sgcGrid_VCL) |
| TsgcFMXGrid | Delphi FireMonkey from XE6, on Windows, macOS, iOS e Android (sgcGrid_FMX) |
| TsgcGridData, TsgcGridColumns, TsgcGridFormatRules, TsgcGridLineView, TsgcGridRenderer | Armazenamento de linhas, colunas, regras de formato e renderizador independentes de framework, também no Linux64 |
| TsgcGridSource_DataSet, TsgcGridDataStore | Vinculação a TDataSet e o armazenamento de linhas das faixas mestre-detalhe |
| TsgcGridAI | Mecanismo de consulta em linguagem natural independente de framework, em todas as edições e também no Linux64 (sgcGrid_AI) |
| TsgcVCLAIQueryBar, TsgcFMXAIQueryBar, TsgcUIAIEventProvider | Barra de consulta de IA e provedor de IA do sgcUICore, em todas as edições |
| TsgcUIAIChatProvider | Ponte sgcUICoreWS: o TsgcAIChat do sgcWebSockets como provedor de IA (edição Registrada) |
| TsgcGridFeedSource_WebSocket, TsgcGridFeedSource_MQTT, TsgcGridFeedSource_SSE, TsgcGridAIQuery | Ponte sgcGridWS com o sgcWebSockets (edição Registrada) |
| TsgcWinFormsGrid, TsgcWpfGrid, TsgcAvaloniaGrid | .NET, WinForms, WPF e Avalonia |
| TsgcGridAI, TsgcWinFormsAIQueryBar, TsgcWpfAIQueryBar, TsgcAvaloniaAIQueryBar | .NET, consultas em linguagem natural e a barra de consulta de IA para WinForms, WPF e Avalonia |
| Destino | Componente | Plataformas |
|---|---|---|
| Delphi 7 a 13, VCL | TsgcVCLGrid | Win32, e Win64 a partir do XE2 |
| Delphi XE6 a 13, FireMonkey | TsgcFMXGrid | Windows, macOS, iOS e Android |
| C++ Builder 2007 a 13 | TsgcVCLGrid, TsgcFMXGrid | Headers .hpp gerados e bibliotecas estáticas |
| Delphi 10.2 a 13, independente de framework | Modelo, formatação, renderizador, JSON e CSV | Linux64, por exemplo para renderizar imagens do grid em um servidor |
| .NET Framework 4.7.2, .NET 8, 9 e 10 | TsgcWinFormsGrid, grids WPF e Avalonia | WinForms, WPF, Avalonia, PNG e SVG headless |
Sim. AppendRow, UpdateRow, UpdateCell e DeleteRow dos dados do grid são thread safe, então uma thread de trabalho escreve linhas por chave diretamente. O grid repinta na thread principal no máximo MaxFPS vezes por segundo. Veja Atualizações em tempo real.
Somente as linhas visíveis são pintadas, então o custo de um quadro depende da janela, não da quantidade de linhas. O gate de QA mede um quadro 1080p de um grid de 100.000 linhas em 3,0 ms no Win32 e 4,6 ms no Win64. Para dados que vivem em outro lugar, o modo virtual não armazena linhas e pede valores conforme rolam para a vista. Veja Desempenho.
Sim, no modo servidor. Um provedor lê uma página de linhas por vez, e o banco de dados avalia a ordenação, os filtros de coluna, a linha de filtro, o texto de localização, os resumos do rodapé, o agrupamento e a contagem de linhas. No Delphi e no C++ Builder, TsgcGridServerProvider_DataSet monta o SQL para SQLite, SQL Server, PostgreSQL, MySQL, Oracle, Firebird, InterBase ou um dialeto genérico e o executa por qualquer componente de consulta. No .NET, os provedores leem um IQueryable, como um conjunto do Entity Framework Core, ou uma conexão ADO.NET, e um provedor de callback atende qualquer outra fonte. A visão de cartões pagina da mesma forma. O modo servidor está na edição Registrada. Veja Modo Servidor.
Sim. O TsgcGridSource_DataSet preenche um grid a partir de qualquer TDataSet, cria as colunas com AutoColumns e, com LiveUpdates, acompanha cada Append, Edit e Delete do dataset. Com um KeyField, as linhas alteradas são atualizadas no local em vez de recarregadas. No .NET, a mesma fonte lê um DataTable. Veja Vinculação a DataSet.
Sim. O TsgcVCLGrid é um controle VCL comum, então pode ficar em um formulário ao lado de um TStringGrid ou TDBGrid existente. Uma tela com TDBGrid mantém o seu dataset e adiciona um TsgcGridSource_DataSet; uma tela com TStringGrid escreve as suas linhas com AppendRow e UpdateRow por chave. Não há conversão automática de formulários inteiros, mas em tempo de design o comando Import columns from DB grid do menu de contexto da grade copia as colunas, o vínculo com o DataSet, a posição e os eventos de um TDBGrid existente.
Edição no local, alternância de caixas de seleção, os editores memo e lookup, edição bidirecional de DataTable, colar, desfazer e refazer, os editores de célula do sgcEditors, linhas em árvore, linhas mestre-detalhe, exportação para Excel, o modo Excel com formatação de células, planilhas e fórmulas de coluna, o modo servidor, a visão de cartões, a ponte sgcGridWS e o log de reconhecimento de alarmes. Ordenação, filtro, a linha de filtro e o painel de localização, agrupamento, resumos, colunas congeladas, o seletor de colunas, layouts e layouts automáticos, colunas que preenchem a largura, bandas, células de imagem, progresso, sparkline, tag, link e caixa de seleção, imagens de campos BLOB, cabeçalhos e linhas com várias linhas, dicas, a faixa de cabeçalho de linha, imagens e botões no cabeçalho, arrastar e soltar linhas, seleção múltipla, regras de formato com conjuntos de ícones, filtros por período de data, modo virtual, JSON e CSV, a saída headless, a lista de alarmes ISA-18.2 e o Pergunte ao grid com TsgcGridAI estão em todas as edições. Veja Edições.
Sim. Tamanhos como GroupIndent e GroupPanelHeight são pixels independentes de dispositivo, e o grid VCL os dimensiona de acordo com o DPI do seu monitor, por monitor a partir do Delphi 10.3. Theme alterna entre utLight e utDark, e AccentColor define a cor de destaque da seleção e do flash.
Introdução, Início rápido VCL, Início rápido FMX, Atualizações em tempo real, Desempenho, Edições, Plataformas.
Delphi, C++ Builder e .NET, cobrindo todos os produtos sgcUI.
Um TsgcChartDataSource_Table plota as linhas do grid e acompanha a sua ordenação e o seu filtro, então grid e gráfico nunca se descolam.
Quando linhas agrupadas não bastam, o sgcPivotGrid resume os registros como uma tabela dinâmica com campos em linhas e colunas.
Conhecer o sgcPivotGrid →
Um grid em um tile do dashboard segue o tema do dashboard; o demo GridAndChart o combina com um tile de gráfico.
Conhecer o sgcDashboard →Um kit de migração mapeia cada membro do TDBGrid e do DevExpress cxGrid que você usa para o seu equivalente no sgcGrid, com código de uma demo compilada, passos de migração numerados e as diferenças conhecidas.
Migrar do TDBGrid e do cxGrid →