sgcGrid Matriz de recursos
Tudo o que o sgcGrid faz, agrupado por tarefa, com um link para o tópico de ajuda de cada recurso. O mesmo modelo alimenta as grades VCL, FireMonkey, WinForms, WPF e Avalonia.
Tudo o que o sgcGrid faz, agrupado por tarefa, com um link para o tópico de ajuda de cada recurso. O mesmo modelo alimenta as grades VCL, FireMonkey, WinForms, WPF e Avalonia.
3 recursos
15 recursos
4 recursos
12 recursos
5 recursos
2 recursos
8 pacotes NuGet
Ajuda online e manuais em PDF
Registrada marca os recursos que estão nas edições Registrada e de Avaliação e não na edição Community gratuita. ~ marca um recurso que a Community tem em parte, com a diferença descrita abaixo.
Cada linha leva ao seu tópico da ajuda. A coluna Community mostra o que a edição .NET Community gratuita inclui; tudo está na Registrada e na Avaliação.
Os filtros de coluna, a linha de filtro, o painel de localização, o seletor de colunas, a reordenação de colunas, o ajuste automático, os layouts, a seleção múltipla, as bandas, os tipos de célula, a edição de DataSet, o colar, o desfazer e os editores de célula do sgcEditors estão nas grades VCL e FireMonkey para Delphi e C++ Builder e nas grades WinForms, WPF e Avalonia para .NET, com a mesma divisão entre Community e Registrada, descrita em Edições. No .NET, a edição de DataSet grava de volta em um DataTable, AddLookup adiciona as colunas de lookup e SyncCursor existe apenas no Delphi.
| Recurso | Detalhes | Community | Ajuda |
|---|---|---|---|
| Atualizações ao vivo de qualquer thread | Data.AppendRow e Data.UpdateRow são thread safe. Atualize um campo ou vários por chave, e BeginUpdate e EndUpdate agrupam uma rajada em uma única repintura, controlada por MaxFPS. | Ajuda | |
| Destaque ao mudar | As células alteradas piscam em verde quando o valor sobe e em vermelho quando desce, e depois esmaecem. O modo Tail mantém à vista as linhas mais recentes de um log ou de um feed. | Ajuda | |
| Modo virtual | Serve conjuntos de dados muito grandes sob demanda. | Ajuda |
| Recurso | Detalhes | Community | Ajuda |
|---|---|---|---|
| Ordenação | Ordene por várias colunas. | Ajuda | |
| Filtros | Filtre as linhas exibidas pela grade. | Ajuda | |
| Seleção e teclado | Selecione linhas ou células com o mouse e o teclado. | Ajuda | |
| Redimensionamento de colunas | Os usuários redimensionam as colunas com o mouse. | Ajuda | |
| Colunas congeladas | Mantenha as primeiras colunas à vista enquanto as demais rolam. | Ajuda | |
| Formatação condicional | Regras de formatação colorem uma célula ou a linha inteira quando um valor atende a uma condição, com cores translúcidas que tingem a célula sobre o fundo. | Ajuda | |
| Da direita para a esquerda (árabe e hebraico) | As colunas fluem a partir da direita, com as colunas congeladas na borda direita; a barra de rolagem, o recuo de árvore e grupo, os chevrons, os ícones de cabeçalho, o rodapé e o editor no local ficam espelhados. Números e datas continuam como trechos da esquerda para a direita. SaveToXLSX (Registrada) grava uma planilha da direita para a esquerda, também por meio de TsgcGridXLSXWriter.RightToLeft. | Ajuda | |
| Filtro de coluna | Um funil em cada cabeçalho (ShowFilterButtons) abre um popup com os valores distintos da coluna e suas contagens, uma caixa de busca e até duas condições tipadas unidas por And ou Or. | Ajuda | |
| Linha de filtro | ShowFilterRow adiciona abaixo do cabeçalho uma linha que filtra cada coluna enquanto o usuário digita, com um operador por coluna em FilterRowOperator. | Ajuda | |
| Painel de localização | Ctrl+F ou ShowFindPanel destaca o texto em todas as células, F3 e Shift+F3 se movem entre as ocorrências, e FindOnlyMatches oculta as demais linhas. | Ajuda | |
| Seletor de colunas e menu do cabeçalho | Um clique com o botão direito em um cabeçalho ordena, agrupa, ajusta as larguras, filtra e abre o seletor de colunas, um popup com uma caixa de seleção por coluna. ShowColumnChooser o abre a partir do código. | Ajuda | |
| Reordenação de colunas | Os usuários arrastam um cabeçalho para mover a coluna, dentro do seu lado das colunas congeladas e das suas bandas; OnColumnMoved informa o movimento. | Ajuda | |
| Ajuste automático | Um clique duplo na borda do cabeçalho, ou BestFitColumn e BestFitColumns, ajusta a largura ao título e a até 1.000 linhas de amostra. | Ajuda | |
| Persistência do layout | SaveLayoutToString, SaveLayoutToStream e SaveLayoutToFile guardam a ordem das colunas, as larguras, a visibilidade, a ordenação, o agrupamento, os filtros de coluna e as bandas como JSON versionado, e os métodos Load os restauram. | Ajuda | |
| Seleção múltipla | gsmMultiRow seleciona qualquer conjunto de linhas e gsmCellRange um intervalo de células, com Ctrl, Shift e Ctrl+A. A seleção é guardada pela chave da linha, e Ctrl+C a copia como texto separado por tabulações. | Ajuda |
| Recurso | Detalhes | Community | Ajuda |
|---|---|---|---|
| Agrupamento | Agrupe linhas por uma coluna, com um painel de grupos. | Ajuda | |
| Resumos | Resumos por grupo e no rodapé. | Ajuda | |
| Linhas em árvore | Exiba dados hierárquicos como linhas em árvore que se expandem e se recolhem. | Registrada | Ajuda |
| Mestre-detalhe | Abra linhas de detalhe sob uma linha pai, por exemplo os pedidos de um cliente. | Registrada | Ajuda |
| Recurso | Detalhes | Community | Ajuda |
|---|---|---|---|
| Edição direta | Edite células diretamente, com eventos de validação. | Registrada | Ajuda |
| Vínculo com DataSet | TsgcGridSource_DataSet preenche uma grade a partir de qualquer TDataSet, cria as colunas com AutoColumns e, com LiveUpdates, acompanha cada Append, Edit e Delete. No .NET a mesma fonte lê um DataTable. | Ajuda | |
| ItemsSource e vínculo MVVM (.NET) | TsgcWpfGrid e TsgcAvaloniaGrid mostram os itens de ItemsSource, qualquer IEnumerable, com AutoGenerateColumns, KeyMember e um SelectedItem bidirecional. No WPF, a ordenação, o filtro e o agrupamento de um ICollectionView se aplicam, e IsSynchronizedWithCurrentItem acompanha o seu item atual. O TsgcWinFormsGrid vincula DataSource e DataMember como o DataGridView. Com ItemsWriteBack, as edições, inserções e exclusões voltam para os itens. | ~A Community mostra e acompanha os itens vinculados. ItemsWriteBack é Registrada. | Ajuda |
| Colunas em XAML e no designer (.NET) | Elementos TsgcWpfGridColumn e TsgcAvaloniaGridColumn dentro da grade declaram as colunas, com FieldName (caminhos com ponto, como Customer.Country), Caption, DataType e DisplayFormat. No WinForms, o designer do Visual Studio, no .NET Framework e no .NET 8 ou posterior, edita Columns com uma smart tag e um editor de coleção, e uma grade vazia mostra linhas de exemplo no designer e nos previewers do WPF e do Avalonia. | Ajuda | |
| JSON e CSV | Carregue e salve as linhas em JSON e CSV. | Ajuda | |
| Exportação para Excel | Salve uma grade como pasta de trabalho do Excel (XLSX). | Registrada | Ajuda |
| Modo Excel | Com ExcelMode o grid funciona como uma planilha leve: seleção de intervalo com Ctrl+C, uma alça de preenchimento que continua séries e desloca as referências das fórmulas, e fórmulas com referências A1 e SUM, AVERAGE, MIN, MAX, COUNT, IF, ROUND e ABS. LoadFromXLSX abre uma planilha de uma pasta de trabalho do Excel sem biblioteca externa. | Registrada | Ajuda |
| Edição de DataSet | Com WriteBack, um TsgcGridSource_DataSet envia as edições da grade para seus registros, SyncCursor mantém juntos o registro atual e a linha com foco, e AllowInsert e AllowDelete adicionam e excluem registros. Os campos de lookup são editados como listas de opções. | Registrada | Ajuda |
| Colar da área de transferência | Ctrl+V cola em um intervalo de células o texto separado por tabulações do Excel. Cada valor é convertido e validado antes de qualquer gravação, e a colagem é um único passo de desfazer. | Registrada | Ajuda |
| Desfazer e refazer | Ctrl+Z e Ctrl+Y desfazem e refazem edições de célula e colagens pela chave da linha, até UndoLimit passos. | Registrada | Ajuda |
| Editores de célula | 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 OnCreateEditor coloca em uma célula qualquer controle seu. | Registrada | Ajuda |
| Impressão e pré-visualização de impressão | Print e ShowPrintPreview imprimem cada linha como a grade a mostra, filtrada, ordenada e agrupada, com as bandas e os cabeçalhos de coluna em todas as páginas e apenas linhas inteiras em cada página. PrintSettings define uma única vez o papel, a orientação, as margens, a escala, o cabeçalho e o rodapé para a impressora, a pré-visualização e o PDF. Em todas as edições, em VCL, FireMonkey, WinForms, WPF e Avalonia (o FireMonkey imprime no Windows e no macOS). | Ajuda | |
| Exportação para PDF acessível, PDF/UA e PDF/A (com sgcPDF) | ExportToPDF grava páginas vetoriais com fontes incorporadas e texto pesquisável, e cada página é uma tabela real com células de cabeçalho para os leitores de tela. O arquivo é um documento PDF/UA com tags por padrão, e PDFALevel adiciona PDF/A-2a ou PDF/A-3a. Exige a ponte sgcUIPDF e um sgcPDF licenciado (esegece.sgcUICore.sgcPDF no .NET). | Registrada | Ajuda |
| Recurso | Detalhes | Community | Ajuda |
|---|---|---|---|
| Temas | Temas claro e escuro compartilhados com todos os produtos sgcUI. | Ajuda | |
| Renderização headless | SaveToPNG e SaveToSVG gravam a visão atual, e TsgcGridRenderer desenha um TsgcGridData independente em PNG ou SVG, inclusive no Linux64. | Ajuda | |
| Gráficos a partir da grade | Um gráfico do sgcCharts plota diretamente as linhas de uma grade. | Ajuda | |
| Bandas | Títulos sobre grupos de colunas em vários níveis: Bands os contém e Column.Band coloca uma coluna sob um deles. | Ajuda | |
| Tipos de célula | CellKind desenha uma célula como imagem de uma lista de imagens, barra de progresso ou sparkline de linha, área ou barras, enquanto a célula mantém seu valor simples. | Ajuda | |
| Acessibilidade | Exposta ao UI Automation como uma tabela com cabeçalhos de coluna, linhas e células, a célula com foco, a seleção, a ordenação, o filtro, o agrupamento e as linhas em árvore, a API que leitores de tela como o Narrator e o NVDA usam. Filtro, agrupamento e movimentação de colunas têm alternativas pelo teclado (o redimensionamento da largura das colunas exige o mouse), o anel de foco está sempre visível e o alto contraste do Windows é seguido. Ativado por padrão no VCL (Delphi 7 ao 13), no FireMonkey no Windows, no WinForms, WPF e Avalonia. | Ajuda |
| Recurso | Detalhes | Community | Ajuda |
|---|---|---|---|
| Pergunte à sua grade | TsgcGridAI transforma uma pergunta em linguagem natural em filtros, ordenações e destaques de linha. Sem provedor, um parser local baseado em regras responde, sem rede e sem chave de API. Com um provedor, qualquer LLM responde, e o parser baseado em regras assume quando a chamada falha ou a resposta não é validada. | Ajuda | |
| Barra de consulta de IA (VCL e FireMonkey) | TsgcVCLAIQueryBar e TsgcFMXAIQueryBar, FireMonkey no Windows, macOS, iOS e Android: digite uma pergunta, pressione Enter, leia o que foi aplicado, use Cancelar numa pergunta em andamento e Desfazer a última resposta, com perguntas recentes e sugestões. Funciona com o teclado, leitores de tela, alto contraste e layouts da direita para a esquerda. | Ajuda | |
| Barra de consulta de IA (WinForms, WPF e Avalonia) | TsgcWinFormsAIQueryBar, TsgcWpfAIQueryBar e TsgcAvaloniaAIQueryBar fazem o mesmo no .NET, com o tema claro ou escuro do host. | Ajuda | |
| Qualquer LLM | O TsgcUIAIEventProvider entrega cada solicitação ao seu próprio código no evento OnRequest, então qualquer serviço de IA, modelo ou servidor local pode responder. No .NET, RequestAsync recebe um manipulador assíncrono. | Ajuda | |
| Provedor de IA do sgcWebSockets | O TsgcUIAIChatProvider da ponte sgcUICoreWS usa o componente TsgcAIChat do sgcWebSockets em todas as plataformas. No .NET, o pacote esegece.sgcUICore.sgcWebSockets. Exige um sgcWebSockets registrado. | Registrada | Ajuda |
| Privacidade | Apenas a pergunta e o catálogo de campos são enviados: nomes, legendas, tipos e até 3 valores de exemplo por coluna por padrão (MaxSampleValues, SendSampleValues), nunca as linhas. O OnBeforeAsk pode editar ou cancelar cada solicitação. | Ajuda |
| Recurso | Detalhes | Community | Ajuda |
|---|---|---|---|
| Feeds em tempo real | A ponte sgcGridWS adiciona fontes de feed WebSocket, MQTT e SSE que gravam as mensagens recebidas na grade. Exige o sgcWebSockets. | Registrada | Ajuda |
| Pergunte à sua grade com um assistente | O TsgcGridAIQuery, o componente de ponte anterior, responde por meio de um TsgcHTMLAIAssistant. Os novos projetos podem usar o TsgcGridAI com o TsgcUIAIChatProvider. | Registrada | Ajuda |
| Capacidade | sgcGrid | Controles Delphi padrão |
|---|---|---|
| Atualizar linhas por chave a partir de uma thread de trabalho, sem Synchronize | — | |
| Células alteradas piscam e se apagam | — | |
| Regras de formato em células ou em linhas inteiras | — | |
| Agrupamento com painel de grupos, resumos de grupo e de rodapé | — | |
| Linhas em árvore e faixas mestre-detalhe | — | |
| Exportação para planilha Excel com estrutura de tópicos e fórmulas | — | |
| Renderização headless em PNG e SVG, também no Linux64 | — | |
| Popup de filtro de coluna no estilo Excel, linha de filtro e painel de localização | — | |
| Seletor de colunas, menu do cabeçalho e layouts salvos como JSON | — | |
| Cabeçalhos de banda sobre grupos de colunas | — | |
| Células de barra de progresso, sparkline e imagem sem código de desenho próprio | — | |
| Colar um intervalo de células do Excel, com desfazer e refazer | — |
Apenas capacidades, conforme documentado na ajuda. Sem alegações de desempenho.
A grade .NET é uma versão em C# com os mesmos nomes de classe, para WinForms, WPF e Avalonia. Comece com o pacote Community gratuito e passe para os pacotes Registrados para ter todos os recursos.
| Pacote | Edição | Conteúdo |
|---|---|---|
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 | Renderização headless |
esegece.sgcGrid.sgcWebSockets | Somente Registrada | Ponte com o sgcWebSockets |
esegece.sgcUICore.sgcWebSockets | Somente Registrada | Provedor de IA do sgcWebSockets (TsgcUIAIChatProvider) |
esegece.sgcGrid.sgcHTML | Somente Registrada | Ponte com o sgcHTML |
Todos os recursos do sgcGrid estão documentados na ajuda do sgcUI, com uma versão para cada ambiente de desenvolvimento.
Comece pela introdução do sgcGrid e siga com o início rápido e os tópicos de recursos.
Delphi →A ajuda completa do sgcUI em PDF, para ler offline ou imprimir.
Delphi (PDF) →